# sendMessageBatch

Представим ситуацию, у вас есть скрипт, который раз в определенное время уведомляет пользователя о каком-либо событии. Например, вы отправляете пользователю статистические данные. 

Но таких пользователей у вас достаточно много, и данные для каждого пользователя индивидуальны. Чтобы уведомить всех пользователей одним запросом, вы можете использовать этот метод.

## Пакетная отправка сообщений подписчикам

<mark style="color:green;">`POST`</mark> `https://leadconverter.ru/api/v1/токен/broadcasting.sendMessageBatch`

Так же необходимо передать следующие параметры:

#### Query Parameters

| Name                                    | Type | Description                                   |
| --------------------------------------- | ---- | --------------------------------------------- |
| batch<mark style="color:red;">\*</mark> | s    | Массив с параметрами (не более 100 элементов) |

{% tabs %}
{% tab title="200 " %}

```
ok
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Максимальное количество элементов в batch массиве - 100
{% endhint %}

{% hint style="info" %}
В шаблоне отправляемого сообщения можно использовать все возможности системы: переменные, функции, и т д. Текст будет автоматически обработан при отправке каждому конкретному подписчику
{% endhint %}

Массив batch должен содержать объекты в формате:

<table><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td>subscriber_id</td><td><p><mark style="color:red;">Обязательный</mark></p><p></p><p>ID подписчика в системе, которому будет отправлено сообщение</p></td></tr><tr><td>text</td><td><p><mark style="color:yellow;">Обязательный, если не указан file_uuid</mark></p><p></p><p>Текст, который будет отправлен подписчику</p></td></tr><tr><td>file_uuid</td><td><p><mark style="color:yellow;">Обязательный, если не указан text</mark></p><p></p><p>UUID файла, который будет отправлен подписчику. </p><p>UUID Можно получить с помощью метода <a href="/pages/4r7LK05JZPKsiKAaTZGe">file.uploadFromUrl</a></p></td></tr></tbody></table>

{% hint style="info" %}
Вы можете использовать:

только text

только file\_uuid

и text и file\_uuid вместе
{% endhint %}

**Пример итогового объекта запроса:**

{% tabs %}
{% tab title="JSON" %}

```
{
    batch: [
        {
            subscriber_id: 1,
            file_uuid: "db0227be-c7c7-484e-8fa4-de9bcfd4723f",
        },
        {
            subscriber_id: 2,
            text: "Привет, это пример отправки текста и файла",
            file_uuid: "26a2a5d1-37fc-4050-b0dc-67d9817cf476",
        },
        {
            subscriber_id: 3,
            text: "Привет, это пример отправки только текста",
        },
    ]
}
```

{% endtab %}
{% endtabs %}

**Пример запроса с помощью адресной строки браузера:**

```
https://leadconverter.ru/api/v1/токен/broadcasting.sendMessageBatch?batch[0][subscriber_id]=7365&batch[0][file_uuid]=db0227be-c7c7-484e-8fa4-de9bcfd4723f&batch[1][subscriber_id]=7366&batch[1][text]=hello
```

### Не нашёл метода который тебе нужен?

А именно этот метод был добавлен по просьбе одного из наших клиентов :)

Хочешь так же? Напиши в поддержку, мы подумаем, как решить твою задачу. В случае, если не найдем решения - создадим его ;)

### Остались вопросы?

И как всегда, если у тебя остались вопросы - [не стесняйся задать их в поддержку](/kak-zadat-vopros-v-podderzhku.md). Мы быстро тебе поможем :)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.leadconverter.su/api-metody/broadcasting/sendmessagebatch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.