# Рассылки

Обновление интерфейса **Панели управления** в **Webim** [10.4](https://webim.ru/webim-10-4/) также затронуло и раздел **Рассылки**. Новый интерфейс позволяет настроить рассылку по любому каналу общения, включая [WhatsApp (360Dialog)](https://webim.ru/kb/channels/social-network-messengers/whatsapp/whatsapp-360dialog.html)[^whatsapp_footnote]. Данная статья содержит описание обновлённого интерфейса **Рассылок**, а также порядок работы с ним.

!!! Note "N.B."
    Данная функциональность является [тарифной опцией](https://webim.ru/price/). Чтобы её подключить, обратитесь, пожалуйста в [техническую поддержку](mailto:support@webim.ru) **Webim**.

Чтобы перейти к интерфейсу рассылок, выберите соответствующий пункт в меню **Панели управления**.

![Переход к интерфейсу рассылок](https://webim.ru/kb/img/for-admins/broadcast/broadcast-in-menu.webp){ style="width: 248px; max-width: 100%" }

На главной странице интерфейса рассылок центральное место занимает список отправленных рассылок (подробнее о работе со списком отправленных рассылок смотрите [здесь](#sent-messages-list)).

![Интерфейс рассылок](https://webim.ru/kb/img/for-admins/broadcast/broadcast-common-view.webp){ style="width: 1288px; max-width: 100%" }

Чтобы создать рассылку, нажмите на кнопку **Создать новую рассылку**. Далее вам будет предложено выбрать рассылку [по чатам](#chats-broadcast), [WhatsApp-](#whatsapp-broadcast) или [LINE-рассылку](#line-broadcast).

![Выбор типа рассылки](https://webim.ru/kb/img/for-admins/broadcast/choosing-type-of-broadcast.webp){ style="width: 548px; max-width: 100%" }

!!! Note "N.B."

      * В WhatsApp через интерфейс рассылок отправляются только шаблоны. Свободный текст недоступен.

      * Для WhatsApp GupShup поддержаны шаблоны с медиа и кнопками.

      * Рассылку можно отправить только посетителям, все диалоги с которыми уже закрыты.

## Рассылка по чатам { #chats-broadcast }

Следующие шаги описывают порядок работы с рассылкой по чатам (к рассылке по чатам относятся чаты по всем каналам общения, кроме **WhatsApp**. Порядок работы с WhatsApp-чатами описывается в следующем разделе).

![Рассылка по чатам](https://webim.ru/kb/img/for-admins/broadcast/common-broadcast-menu.webp){ style="width: 868px; max-width: 100%" }

  1. В поле **Номера диалогов** через запятую укажите все номера диалогов, участвующих в рассылке (можно указать как несколько номеров диалогов, так и один). Номера диалогов можно посмотреть в **Истории диалогов** и **РМО**, выбрав диалог, который был завершен или закрыт, и посмотрев соответствующий пункт.

  1. В поле **Текст рассылки** наберите текст сообщения, которое получат посетители, чьи номера диалогов указаны в поле **Номера диалогов**.

  1. Далее нажмите **Отправить**. Рассылка с указанным текстом будет отправлена на все диалоги, номера которых были указаны.

!!! Warning "Внимание!"
    Отправка рассылки не будет выполнена, если диалог с посетителем не будет закрыт окончательно. Подробнее об окончательном закрытии диалогов можно прочитать в [этой статье](https://webim.ru/kb/for-admins/closing-dialogs.html)

    ![Пример рассылки по чатам](https://webim.ru/kb/img/for-admins/broadcast/common-broadcast-example.webp){ style="width: 868px; max-width: 100%" }

Как только рассылка будет отправлена, вы автоматически вернётесь к списку отправленных рассылок, где сразу же появится новая строка с информацией о рассылке.

---

## Рассылка через LINE { #line-broadcast }

### Одиночное сообщение

Чтобы отправить одиночное сообщение в **LINE**, выберите пункт **Сообщение**. Откроется окно для отправки одиночного сообщения.

![Одиночное сообщение](https://webim.ru/kb/img/for-admins/broadcast/line-broadcast.webp){ style="width: 1007px; max-width: 100%" }

  1. **Канал**: выберите нужный вам канал из списка настроенных (если имеется только один настроенный канал, то он подставляется по умолчанию).

  1. В поле **Текст рассылки** наберите текст сообщения, которое получит пользователь канала.

  1. В поле **Идентификатор пользователя** укажите данные.

  1. Далее нажмите **Отправить**.

### Рассылка

Чтобы отправить рассылку для нескольких получателей, выберите пункт **Рассылка**. Откроется окно для отправки рассылки.

  ![Рассылка для нескольких пользователей](https://webim.ru/kb/img/for-admins/broadcast/line-broadcast-2.webp){ style="width: 1007px; max-width: 100%" }

  1. **Канал**: выберите нужный вам канал из списка настроенных (если имеется только один настроенный канал, то он подставляется по умолчанию).

  1. В поле **Текст рассылки** наберите текст сообщения, которое получит пользователь канала.

  1. Поставьте галочку, если хотите, чтобы сообщения ушли всем пользователям, которые являются друзьями вашего аккаунта Line.

  1. Загрузите файл в формате CSV, где будут указаны **Идентификаторы пользователей**, которые должны увидеть вашу рассылку.

  1. Далее нажмите **Отправить**.

Как только рассылка будет отправлена, вы автоматически вернётесь к списку отправленных рассылок, где сразу же появится новая строка с информацией о рассылке.

---

## Рассылка через WhatsApp { #whatsapp-broadcast }

В меню создания WhatsApp-рассылок можно выбрать между отправкой одиночного сообщения и отправкой рассылки для нескольких получателей.

Рассылка через **WhatsApp** исключает возможность ввода произвольных сообщений, а осуществляется по шаблону. Шаблоны доступны для использования в рассылке после предварительного утверждения провайдером (добавление новых шаблонов осуществляется в личном кабинете провайдера).

Рассылки осуществляются только в неактивные на данный момент диалоги (т.е. если посетитель в текущий момент уже общается с оператором, то рассылка ему отправлена не будет).

!!! Note "N.B."
    Если пользователь ответит на сообщение из рассылки **WhatsApp** или сторонней рассылки **Seventech**, его ответ будет отображаться в диалоге **Webim**.

### Подготовка в кабинете провайдера

Чтобы шаблон появился в выпадающем списке **Шаблон сообщения** в интерфейсе рассылок **Webim**, он должен быть:

  * создан в кабинете провайдера ([**360Dialog**](https://hub.360dialog.com) или [**GupShup**](https://www.gupshup.ai/));

  * отправлен на модерацию **WhatsApp** и иметь статус одобрения (например, `APPROVED`).

#### 360Dialog

Шаблоны создаются и управляются в кабинете **360Dialog**. Если шаблоны не загружены/не одобрены, в Webim при создании рассылки может отображаться ошибка **Нет подходящих шаблонов или сообщений** (см. сноску [^1]).

Чтобы отправлять рассылки через **360Dialog**, необходимо:

  1. Подключить **WhatsApp Business** (WABA/номер) в кабинете **360Dialog**.

  1. Настроить интеграцию Webim с **360Dialog** (см. статью [WhatsApp через 360Dialog](https://webim.ru/kb/channels/social-network-messengers/whatsapp/whatsapp-360dialog.html)).

  1. Для создания шаблонов вам необходимо на странице профиля нажать на кнопку **Управление бизнес-аккаунтом WhatsApp**.

  1. Далее на новой странице необходимо перейти на вкладку **Templates** и нажать на кнопку **Add template**.

  1. В новом окне необходимо заполнить запрашиваемые данные и нажать кнопку **Preview and submit**.

  1. После одобрения выбрать провайдера `whatsapp_360dialog` и нужный **Канал** в форме рассылки Webim — одобренные шаблоны станут доступны для выбора.

#### GupShup

Чтобы отправлять рассылки через **GupShup**, необходимо:

  1. Создать приложение (app) в кабинете **GupShup** и подключить к нему **WhatsApp Business** (WABA/номер).

  1. Настроить интеграцию Webim с GupShup (см. статью [WhatsApp через Gupshup](https://webim.ru/kb/channels/social-network-messengers/whatsapp/whatsapp-gupshup.html)).

  1. Создать шаблоны сообщений в кабинете **GupShup** и отправить их на модерацию **WhatsApp**.

  1. Дождаться одобрения шаблонов провайдером/WhatsApp.

  1. После одобрения выбрать провайдера `whatsapp_gupshup` и нужный **Канал** в форме рассылки Webim — одобренные шаблоны станут доступны для выбора.

!!! Note "N.B."
    Отображаемые в Webim шаблоны зависят от выбранных **Провайдера** и **Канала**. Если в кабинете провайдера шаблон создан/одобрен для другого номера/приложения, в Webim он не появится при выборе текущего канала.

### Сценарий рассылки WhatsApp

  1. Администратор создаёт и согласовывает шаблон у провайдера (**360Dialog** или **GupShup**), после чего шаблон становится доступен в Webim.

  1. Администратор отправляет одиночное сообщение или рассылку из Webim через раздел **Рассылки**.

  1. Сообщение отправляется получателям в **WhatsApp** как исходящее шаблонное сообщение.

  1. В **РМО** у операторов не появляется новый активный диалог автоматически только из-за факта рассылки. Исходящее сообщение фиксируется как отправленная рассылка и отображается в **Списке отправленных рассылок**.

  1. Если получатель отвечает на сообщение в **WhatsApp**, в Webim создаётся/открывается диалог с посетителем, и ответ посетителя становится доступен операторам в **РМО**. Далее диалог обрабатывается оператором в обычном порядке.

  1. После завершения обработки оператор закрывает диалог согласно правилам закрытия диалогов (см. [Закрытие диалогов](https://webim.ru/kb/for-admins/closing-dialogs.html)).

!!! Note "N.B."
    Правила **WhatsApp** ограничивают отправку исходящих сообщений по истечении 24 часов с последнего сообщения пользователя. Рассылки по шаблонам применяются в том числе для случаев, когда нельзя отправить обычное исходящее сообщение.

### Одиночное сообщение

Чтобы отправить одиночное сообщение в **WhatsApp**, выберите пункт **Сообщение**. Откроется окно для отправки одиночного сообщения.

![Одиночное сообщение WhatsApp](https://webim.ru/kb/img/for-admins/broadcast/whatsapp-single-message.webp){ style="width: 1007px; max-width: 100%" }

Далее заполните следующие поля:

  * **Провайдер**: выберите провайдера, посредством которого хотите произвести рассылку. На данный момент имеется два доступных провайдера: **360Dialog** и **Gupshup**. От выбора провайдера зависит список доступных шаблонов. Список доступных провайдеров зависит от подключенных каналов общения - если у Вас не подключен канал общения **WhatsApp** через **Gupshup**, то у Вас не будет варианта выбрать его в качестве провайдера, аналогично для **360Dialog**;

  * **Канал**: выберите нужный вам канал из списка настроенных (отображаются каналы, настроенные через выбранного провайдера);

  * **Язык шаблона**: выберите язык, на котором написано шаблонное сообщение. Для выбора доступны все поддерживаемые в **Webim** языки общения;

  * **Номер телефона**: укажите российский номер телефона в международном формате, но без + начале. Например: `7800XXXXXXX`;

  * **Шаблон сообщения**: выберите шаблон[^1] с текстом рассылки среди зарегистрированных у провайдера;

  * **Параметры**: после выбора шаблона появятся несколько полей, содержимое которых отображается в тексте сообщения, предпросмотр коего доступен в пункте **Текст сообщения**. Заполните их в соответствии с текстом шаблона;

  * **Вложение**: если выбранный шаблон у провайдера поддерживает медиа, появляется поле **Загрузить медиа-файл**. Допустимые типы/расширения файлов зависят от шаблона и ограничений провайдера. В интерфейсе загрузки отображаются разрешённые расширения.

    ![Пример одиночного сообщения WhatsApp](https://webim.ru/kb/img/for-admins/broadcast/single-message-example.webp){ style="width: 1007px; max-width: 100%" }

    ![Пример одиночного сообщения с вложением WhatsApp](https://webim.ru/kb/img/for-admins/broadcast/single-message-example-with-file.webp){ style="width: 1007px; max-width: 100%" }

  * После заполнения всех полей нажмите **Отправить**. Далее вы увидите уведомление о том, что **Сообщение принято в обработку**.

### Рассылка

Чтобы отправить рассылку для нескольких получателей, выберите пункт **Рассылка**. Откроется окно для отправки рассылки.

![Рассылка WhatsApp](https://webim.ru/kb/img/for-admins/broadcast/whatsapp-broadcast.webp){ style="width: 1007px; max-width: 100%" }

  * **Провайдер**: выберите провайдера, посредством которого хотите произвести рассылку. На данный момент имеется два доступных провайдера: **360Dialog** и **Gupshup**. От выбора провайдера зависит список доступных шаблонов. Список доступных провайдеров зависит от подключенных каналов общения - если у Вас не подключен канал общения **WhatsApp** через **Gupshup**, то у Вас не будет варианта выбрать его в качестве провайдера, аналогично для **360Dialog**;

  * **Канал**: выберите нужный вам канал из списка настроенных (если имеется только один настроенный канал, то он подставляется по умолчанию);

  * **Шаблон сообщения**: выберите шаблон[^1] с текстом рассылки среди зарегистрированных у провайдера. После выбора шаблона появится пункт **Текст сообщения**, содержащий текст отправляемого сообщения. Шаблон должен соответствовать следующим критериям:

    * Текст и параметры шаблона должны размещаться только в [теле](https://webim.ru/kb/dev/api/realtime-2.0.html#_5) запроса.

    * Допускается медиа (картинки, видео, аудиофайлы и прочее), если это предусмотрено шаблоном и поддерживается у провайдера.

    * Допускаются кнопки, если они поддерживаются у провайдера.

    * В шаблоне не должно быть параметров `footer` и `header`.

  * **Язык шаблона**: выбирается в форме рассылки.

  * **Загрузить CSV-файл**: загрузите CSV-файл, содержащий информацию о номерах получателей и значениях параметров для шаблона сообщения. Вы можете создать CSV-файл самостоятельно в соответствии с приведённой ниже спецификацией:

    * Допустимая кодировка: `UTF-8`;

    * Разделителями являются символы `,` и `;`;

    * Наличие каких-либо кавычек не допускается;

    * Наличие заголовочной строки не допускается;

    * Первое значение (ячейка таблицы) - номер телефона, все дальнейшие - значения, подставляемые в параметры ранее загруженных шаблонов, потому их количество и наполнение должно строго соответствовать шаблону;

    * Формат телефонного номера: в начале допускается опциональный `+`, далее следует любое количество цифр (проверка валидности номер происходит уже в **WhatsApp**), иные символы не допускаются. Примеры: `+79111234567`, `71234567890`;

    * Наличие пустых полей не допускается.

  * **Контент**: После прикрепления CSV-файла в нижней части интерфейса появится таблица с пользователями. Вы сможете загрузить файл для отправки всем получателям, а также вручную настроить индивидуальную отправку файлов в таблице с пользователями.

    * Допустимые типы/расширения файлов зависят от шаблона и ограничений провайдера. В интерфейсе загрузки отображаются разрешённые расширения.

Ниже приведён пример CSV-файла, соответствующего спецификации в формате plain text:

```
+71234567890,Платон,355877
+70987654321,Лев,355876
```

![Пример рассылки WhatsApp](https://webim.ru/kb/img/for-admins/broadcast/whatsapp-broadcast-example.webp){ style="width: 1007px; max-width: 100%" }

![Рассылка WhatsApp через провайдер GupShup с прикреплением файлов](https://webim.ru/kb/img/for-admins/broadcast/whatsapp-gupshup-broadcast-example-with-files.webp){ style="width: 1007px; max-width: 100%" }

После заполнения всех полей нажмите **Отправить**. Далее вы увидите уведомление о том, что **Сообщения приняты в обработку**.

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

---

## Список отправленных рассылок { #sent-messages-list }

В списке отправленных рассылок отображаются все рассылки, которые были отправлены из Webim через каналы общения (запись о каждом отправленной рассылке начинается с новой строки). В каждой строке отражается информация в следующих полях:

  * **№** – порядковый номер отправленной рассылки;

  * **Сообщение** – текст отправленной рассылки или название шаблона (если указан тип рассылки **WhatsApp**);

  * **Имя оператора** – имя оператора, отправившего рассылку;

  * **Начат** – время отправки рассылки;

  * **Тип рассылки** – может быть **По чатам** или **WhatsApp**;

  * **Диалогов** – количество диалогов в рассылке;

  * **Статус** – статус отправленной рассылки. Если рассылка **со стороны сервера** отправлена успешно, то она будет иметь статус **Завершена**;

  * **Действия** – здесь можно посмотреть более подробную информацию об отправленной рассылке.

Список отправленных рассылок можно сортировать по значению одного из полей (как по возрастанию, так и по убыванию) с помощью кнопки ![Иконка сортировки](https://webim.ru/kb/img/icons/icon-sorting-arrow.svg). Также можно посмотреть информацию о конкретной отправленной рассылке, нажав кнопку ![Иконка «Подробнее»](https://webim.ru/kb/img/icons/icon-learn-more.svg) в поле **Действия**.

По нажатию этой кнопки будет отображена информация о статусе рассылки (включая информацию о количестве обработанных и отправленных сообщение, а также о количестве получателей). Далее (в зависимости от типа рассылки) отображается информация о содержании рассылки:

  * У рассылки с типом **По чатам** отображается информация о номерах диалогов и тексте рассылки.

  * У рассылки с типом **WhatsApp** отображается информация о провайдере, канале, шаблоне сообщения и т.д.

## Паузы между рассылками

Для корректной работы чат-бэкенда при создании большого количества рассылок одновременно предусмотрена временная задержка между рассылками. Её работа определяется параметром [account config](https://webim.ru/kb/for-admins/service-pages/account-config-editor.html) `broadcast_delay_between_recipients`. Длительность паузы между отдельным получателями при отправке рассылки определяется в зависимости от типа рассылки. По умолчанию пауза составляет 1 секунду.

[^1]: Нередки случаи, когда при создании рассылки или отправке одиночного сообщения (даже если канал настроен правильно) возникает ошибка вида **Нет подходящих шаблонов или сообщений**. Это связано с тем, что перед созданием рассылки шаблоны должны быть предварительно созданы и одобрены в кабинете провайдера: для **360Dialog** — в личном кабинете **360Dialog** (шаблоны должны быть загружены до того, как вы перейдёте на страницу создания рассылок **WhatsApp**); для **GupShup** — в кабинете **GupShup** (в приложении, к которому подключён ваш WhatsApp-номер) и иметь статус одобрения со стороны WhatsApp. Если шаблоны отсутствуют или не одобрены, Webim не сможет предложить их для выбора в форме рассылки.

[^whatsapp_footnote]: WhatsApp принадлежит корпорации Meta, деятельность которой признана экстремистской и запрещена в РФ.

---

Источник: https://webim.ru/kb/for-admins/broadcast.html