Аудитории и кампании сообщений
Аудитория — это список людей, общий для всей компании. Кампания сообщений отправляет одно сообщение или упорядоченную цепочку сообщений в одну или несколько аудиторий по SMS/MMS, WhatsApp, Telegram, Messenger, Instagram или электронной почте. Обе сущности находятся в разделе Кампании консоли рядом с голосовыми кампаниями и доступны через API (/audiences, /contact-optouts, /message-campaigns).
На этой странице описано, как ведёт себя продукт и что требует поставщик каждого канала. Это не юридическая консультация. Какое согласие вам нужно, зависит от вашей страны и вашего бизнеса; обратитесь к юристу.
Аудитории
У человека в аудитории есть имя и любые из следующих данных: номер телефона (хранится в формате E.164, например +15550100100), адрес электронной почты, идентификатор чата Telegram, идентификатор WhatsApp (если пусто, берутся цифры телефона), идентификаторы Messenger и Instagram в области страницы, язык, часовой пояс, страна и пользовательские поля, которые можно использовать в шаблонах сообщений ({plan}). Кроме того, у каждого человека хранится согласие по каналам: есть оно или нет, когда и где оно было дано.
- Согласие ниоткуда не следует. Человек считается согласившимся на канал только тогда, когда вы это записали, указав источник («веб-форма 2026-10», «оформление заказа в магазине»).
- Телефон, адрес электронной почты или идентификатор канала встречается в аудитории только один раз.
- Списки от 100 000 человек и больше ищутся и разбиваются на страницы на сервере; согласие можно записать сразу для многих людей.
- Один и тот же человек в двух аудиториях получит от кампании, нацеленной на обе, одно сообщение (его определяют по телефону, иначе по адресу электронной почты, иначе по идентификатору канала).
Как добавить людей
| Откуда | Как |
|---|---|
| Из файла | CSV или Excel (.xlsx, .xls) с помощью мастера импорта (ниже) |
| Из справочника контактов | Импорт из контактов: телефонная книга компании или контакты одного пользователя, у которых есть пригодный номер или адрес. У контактов нет согласия. |
| Из входящих | Импорт из входящих: люди, написавшие в Telegram, Messenger, Instagram и WhatsApp. Номер WhatsApp становится телефоном человека. Идентификатор Telegram, Messenger или Instagram — это отдельный человек, пока вы не свяжете диалог с человеком (диалог из входящих можно привязать к записи). Сообщение от человека не является согласием. |
| API | POST /audiences/{id}/entries для одного человека, POST /audiences/{id}/import для небольшого CSV |
Мастер импорта
- Загрузите файл CSV или Excel. Файл передаётся на сервер потоком и никогда не хранится целиком в памяти. Предел задаёт оператор (по умолчанию 512 МБ, около миллиона строк и больше); файл большего размера отклоняется с кодом
MPBX-AUDIENCE-IMPORT-TOO-LARGE, а компания, превысившая квоту хранилища, получаетMPBX-STORAGE-QUOTA-EXCEEDED. В обоих случаях ничего не сохраняется, и ничего никогда не удаляется, чтобы освободить место. - Предпросмотр. Мастер определяет кодировку (UTF-8, UTF-8 с BOM, Windows-1252) и разделитель (запятая, точка с запятой, табуляция), перечисляет листы книги, чтобы вы выбрали один, показывает заголовок и первые строки и предлагает сопоставление столбцов. Если вы раньше импортировали файл с таким же заголовком, предлагается сопоставление, использованное тогда.
- Сопоставьте столбцы с полями человека, с пользовательскими полями (
field:plan) или со столбцом согласия (consent:sms, да или нет). Можно также указать, что все в файле согласились на некоторые каналы; для этого нужен источник, который сохраняется вместе с согласием. - Импорт. Фоновое задание читает файл пакетами по 2 000 строк с показом хода выполнения в реальном времени (прочитано, сохранено, отклонено, повторено строк); ход также публикуется в WebSocket событий как
audience.import_progress. Задание можно отменить; уже сохранённые люди остаются. Задание переживает перезапуск сервера и продолжается с того же места. Строки, повторяющие человека, который уже есть в списке, пропускаются. - Отчёт. Отклонённые строки (недопустимый телефон или адрес электронной почты, национальный номер без выбранной страны, нет способа связаться с человеком) перечислены с причиной, и их можно скачать в виде CSV вместе со строкой в том виде, в каком она была в файле.
Шаблоны. Скачайте пустой CSV или XLSX из мастера (или через GET /audiences/import-template): в нём есть заголовок для каждого поля, столбец согласия для каждого канала, столбцы field: для названных вами пользовательских полей и две строки-примера. Заголовки (а в книге ещё и лист с пояснениями) на вашем языке; импорт их распознаёт. Перед импортом удалите строки-примеры.
Отказы от контакта
Одно хранилище не беспокоить обслуживает все каналы. Запись — это канал (sms, whatsapp, telegram, messenger, instagram, email, voice или all) и номер, адрес или идентификатор.
| Чем заполняется | Примечания |
|---|---|
| SMS STOP, UNSUBSCRIBE, CANCEL, END, QUIT (и слова на местном языке) | обрабатывается ядром SMS; отражается здесь |
| STOP, UNSUBSCRIBE и слова на местном языке как всё сообщение в WhatsApp, Telegram, Messenger, Instagram | START возвращает человека |
| Ссылка отписки в сообщениях кампании | один щелчок, на языке браузера, отказывает человека от того канала, по которому пришло сообщение |
| «Нажмите 9» (клавиша отказа) в исходящих звонках ИИ и в списке «не звонить» | существующие записи списка «не звонить» перенесены в хранилище; список «не звонить» продолжает работать |
| Администраторы | страница Отказы или API, с аудитом |
Удаление записи фиксируется в аудите и должно происходить только тогда, когда человек сам попросил снова с ним связываться. Кампании проверяют хранилище перед каждым сообщением, в том числе в уже запущенных кампаниях.
Кампании сообщений
В кампании есть:
- Аудитории: одна или несколько; повторяющиеся люди объединяются.
- Шаги: у каждого свой канал и содержимое. Если шагов больше одного, последующие служат запасными: например, сначала шаблон WhatsApp, затем SMS, если человека нет в WhatsApp или сообщение не доставлено за 30 минут.
- Назначение: маркетинговое (требуется согласие по каналу) или транзакционное (напоминание о приёме, сообщение о доставке; продукт не требует согласия, но отказы по-прежнему действуют).
- Окно отправки в часовом поясе человека (указанном в записи, иначе в часовом поясе кампании) с днями недели; скорость в минуту; повторы при временных сбоях.
- Шаблоны с подстановкой
{field}и{field|default}, текст на каждом языке, выбираемый по языку человека, счётчик сегментов SMS (GSM 7 бит — 160/153 символа на часть, UCS-2 — 70/67), тема письма и HTML с обязательной ссылкой{unsubscribe_url}, а для WhatsApp — утверждённый шаблон со значениями его заполнителей (выбираются из вашей учётной записи WhatsApp Business). - Жизненный цикл: черновик, запланирована, выполняется, приостановлена, остановлена (окончательно), завершена. Запуск, планирование, приостановка, возобновление и остановка выполняются на странице.
Перед запуском кампания показывает, скольких людей она может охватить по каждому каналу (людей с адресом, с согласием, которого требует назначение, и без отказа), а если вы задали цену сегмента SMS, — верхнюю оценку стоимости SMS. Пока кампания выполняется, вы в реальном времени видите отправленные, доставленные, прочитанные, с ответом, неудачные, пропущенные (и почему: нет адреса, нет согласия, окно закрыто, нет шаблона), отказавшиеся и фактическую стоимость; людей можно вывести списком и экспортировать в CSV.
Ответ попадает в общие входящие, как любое другое сообщение, и отмечается в строке человека со ссылкой на диалог. История человека по кампаниям (последний контакт, исход, количество) хранится в записи человека.
Что разрешает каждый канал
Планировщик применяет эти правила к каждому человеку. Тот, до кого канал дотянуться не может, пропускается, учитывается и, если есть запасной шаг, передаётся следующему шагу. Приведённые ниже правила — это правила самих поставщиков; они меняются, поэтому проверяйте источники.
| Канал | Применяемое правило |
|---|---|
| За пределами 24-часового окна обслуживания клиента можно отправить только утверждённый шаблон, поэтому для маркетингового шага он нужен. Внутри окна (человек писал в последние 24 часа) отправляется свободный текст. Маркетинговым шаблонам нужно согласие человека — то самое, которое вы записываете. Уведомления о доставке и прочтении приходят на вебхук канала. Основы шаблонов | |
| Telegram | Бот может писать только тем, кто его запустил, поэтому доступны только люди с идентификатором чата (написавшие боту). Планировщик держится ниже примерно 25 сообщений в секунду для бота (Telegram допускает около 30 в секунду в целом, около одного в секунду на чат и 20 в минуту на группу). FAQ по ботам |
| Messenger и Instagram | Свободный текст только внутри 24-часового окна стандартных сообщений. Теги сообщений предназначены для утверждённых нерекламных уведомлений и в кампаниях не используются; рекламные сообщения за пределами окна требуют собственных продуктов Meta (Sponsored Messages, одноразовые уведомления), которых здесь нет. Уведомления о доставке называют сообщение; уведомление о прочтении охватывает всё отправленное до своей отметки (Instagram называет просмотренное сообщение). Политика Messenger Platform |
| SMS и MMS | Согласие для маркетинга, отказ по STOP учитывается автоматически, окно отправки в часовом поясе получателя, стоимость считается по сегментам. Правила операторов и стран (регистрация отправителя, тихие часы) остаются на вашей стороне: см. руководство по соответствию требованиям для SMS. |
| Электронная почта | Согласие для маркетинга и ссылка отписки в каждом сообщении (добавляется, если в шаблоне её забыли). Сообщения содержат ссылку в тексте и заголовки List-Unsubscribe и List-Unsubscribe-Post для отписки в один щелчок (RFC 8058), которые почтовые сервисы показывают как кнопку отписки (SMTP, Amazon SES, SendGrid и Mailgun). |
| Apple Messages for Business, Google Business Messages | Не поддерживаются: они отвечают людям, которые пишут первыми, и не имеют исходящих кампаний. |
Голосовые кампании по аудиториям
Кампании автодозвона (операторы или рассылка) и исходящие кампании ИИ тоже звонят аудиториям: привяжите к кампании один или несколько списков (PUT /campaigns/{id}/lists, PUT /ai/outbound/campaigns/{id}/lists), и каждый человек с номером телефона станет контактом (или заданием) кампании, если только номер не внесён в хранилище «не беспокоить» для голоса или для всех каналов. POST .../lists/sync добавляет людей, присоединившихся к спискам с тех пор. У кампании остаётся собственная очередь контактов (попытки, следующая попытка, состояние звонка); контакты, существовавшие раньше, и контакты, добавленные напрямую, перенесены в автоматически созданный для каждой кампании список («Calls: ...», «AI calls: ...»), поэтому их попытки теперь относятся к человеку.
- Нажмите 9. Клавиша отказа в звонке автодозвона или ИИ записывает отказ в единое хранилище; запись, добавленная там для голоса, учитывается обоими видами кампаний, а её удаление снимает отказ везде.
- История. У каждого человека показаны кампании, которые с ним связывались: сообщения, звонки автодозвона и звонки ИИ, с исходом и попытками; последний контакт и их количество хранятся в записи человека.
Тестовый режим
Перед настоящим запуском отправьте один тестовый звонок или одно тестовое сообщение тестовому получателю. Тест находится на странице кампании и в её редакторе (Тестовый режим) для кампаний автодозвона и рассылки, а через API — для исходящих кампаний ИИ и кампаний сообщений.
- Тестовый получатель. Номер телефона в международном формате (тестовые звонки, SMS, WhatsApp), адрес электронной почты и идентификатор чата Telegram, идентификатор Messenger или Instagram (выберите идентификаторы из контактов входящих). Задайте значение компании по умолчанию в разделе Кампании, Тестовый получатель компании (
settings:write); у кампании может быть собственный тестовый получатель, поле за полем поверх значения по умолчанию (пустые поля берут значение по умолчанию). - Тестовый звонок (голос). Совершает один настоящий звонок на тестовый номер ровно с той конфигурацией, которая задана в кампании: сообщение (озвучиваемый текст или запись), определение автоответчика и оставление сообщения на автоответчике, клавиши оператора и отказа, АОН и план набора внутреннего номера с его исходящими правилами и защитой от телефонного мошенничества. Звонок учитывается в одновременных звонках лицензии, как любой звонок через транк. Звонок в очередь операторов (power, preview, predictive) соединяет вас со свободным оператором точно так же, как настоящий звонок. Страница показывает звонок в реальном времени (вызов, воспроизведение сообщения, ожидание клавиши) и его исход. Нажатие клавиши отказа во время теста сообщает
opted out, но не вносит ваш номер в список «не беспокоить». - Отправить тест (сообщения). Формирует каждый шаг для условного человека (в поле имени стоит «Test Recipient»; поля, которых у тестового человека нет, показываются как
[field]) и отправляет по одному сообщению в каждый отмеченный вами канал по правилам канала: WhatsApp за пределами 24-часового окна уходит как утверждённый шаблон, Messenger и Instagram — только внутри своего окна (иначе в строке будет написано Окно ответа в 24 часа закрыто), канал, который не подключён, или шаг, который вы не написали, пропускается с указанием причины. Темы писем начинаются с[Test]и содержат пример ссылки отписки. Страница показывает отправку, доставку и прочтение по мере поступления уведомлений. - Когда. Тестировать можно кампанию в статусе черновика, запланированную или приостановленную. Выполняющуюся, остановленную или завершённую кампанию тестировать нельзя (сначала приостановите её). У исходящих кампаний ИИ нет состояния выполнения, и их можно тестировать всегда.
- Безопасность. Тест уходит только сохранённому тестовому получателю: адрес никогда не берётся из запроса или из аудитории, а аудитория не читается и не изменяется. Тестовые попытки хранятся в собственном журнале, поэтому не попадают ни в статистику кампаний, ни в историю контактов человека, ни в оценки и итоги стоимости SMS. Хранилище «не беспокоить» действует: тестовый получатель, который в нём есть (для этого канала или для всех), отклоняется с понятным сообщением. На кампанию допускается не более 10 тестовых попыток в час. Каждый тест и каждое изменение тестового получателя записываются в журнал аудита.
Большие файлы: настройки сервера и прокси
Сервер читает две настройки из раздела [uploads] своей конфигурации:
[uploads]
max_import_bytes = 536870912 # the largest import file (default 512 MB)
import_timeout_secs = 3600 # how long one upload may take (default 1 hour)
Держите лимит размера тела запроса на прокси небольшим для всего сайта и увеличивайте его только для пути загрузки импорта (POST /api/v1/audiences/{id}/imports):
- Caddy (внешний прокси установщика): в поставляемом
Caddyfileдля этого пути есть блок сrequest_body { max_size 1GB }и часовыми тайм-аутами чтения и записи. - ingress-nginx (Kubernetes): второй Ingress для того же хоста,
/api/v1/audiences/[0-9a-fA-F-]+/imports, сproxy-body-size: 1g,proxy-request-buffering: "off"и часовыми тайм-аутами (deploy/k8s/components/ingress/ingress.yaml). - Другой прокси: разрешите на этом пути тело размером не менее
max_import_bytes, не буферизуйте запрос в памяти и разрешите час простоя при чтении и записи.