> For the complete documentation index, see [llms.txt](https://docs.leadconverter.su/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.leadconverter.su/api-metody/broadcasting/sendmessagebatch.md).

# 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). Мы быстро тебе поможем :)