Перейти к основному содержимому

Аудитории и кампании сообщений

Аудитория — это список людей, общий для всей компании. Кампания сообщений отправляет одно сообщение или упорядоченную цепочку сообщений в одну или несколько аудиторий по 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 — это отдельный человек, пока вы не свяжете диалог с человеком (диалог из входящих можно привязать к записи). Сообщение от человека не является согласием.
APIPOST /audiences/{id}/entries для одного человека, POST /audiences/{id}/import для небольшого CSV

Мастер импорта​

  1. Загрузите файл CSV или Excel. Файл передаётся на сервер потоком и никогда не хранится целиком в памяти. Предел задаёт оператор (по умолчанию 512 МБ, около миллиона строк и больше); файл большего размера отклоняется с кодом MPBX-AUDIENCE-IMPORT-TOO-LARGE, а компания, превысившая квоту хранилища, получает MPBX-STORAGE-QUOTA-EXCEEDED. В обоих случаях ничего не сохраняется, и ничего никогда не удаляется, чтобы освободить место.
  2. Предпросмотр. Мастер определяет кодировку (UTF-8, UTF-8 с BOM, Windows-1252) и разделитель (запятая, точка с запятой, табуляция), перечисляет листы книги, чтобы вы выбрали один, показывает заголовок и первые строки и предлагает сопоставление столбцов. Если вы раньше импортировали файл с таким же заголовком, предлагается сопоставление, использованное тогда.
  3. Сопоставьте столбцы с полями человека, с пользовательскими полями (field:plan) или со столбцом согласия (consent:sms, да или нет). Можно также указать, что все в файле согласились на некоторые каналы; для этого нужен источник, который сохраняется вместе с согласием.
  4. Импорт. Фоновое задание читает файл пакетами по 2 000 строк с показом хода выполнения в реальном времени (прочитано, сохранено, отклонено, повторено строк); ход также публикуется в WebSocket событий как audience.import_progress. Задание можно отменить; уже сохранённые люди остаются. Задание переживает перезапуск сервера и продолжается с того же места. Строки, повторяющие человека, который уже есть в списке, пропускаются.
  5. Отчёт. Отклонённые строки (недопустимый телефон или адрес электронной почты, национальный номер без выбранной страны, нет способа связаться с человеком) перечислены с причиной, и их можно скачать в виде 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, InstagramSTART возвращает человека
Ссылка отписки в сообщениях кампанииодин щелчок, на языке браузера, отказывает человека от того канала, по которому пришло сообщение
«Нажмите 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.

Ответ попадает в общие входящие, как любое другое сообщение, и отмечается в строке человека со ссылкой на диалог. История человека по кампаниям (последний контакт, исход, количество) хранится в записи человека.

Что разрешает каждый канал​

Планировщик применяет эти правила к каждому человеку. Тот, до кого канал дотянуться не может, пропускается, учитывается и, если есть запасной шаг, передаётся следующему шагу. Приведённые ниже правила — это правила самих поставщиков; они меняются, поэтому проверяйте источники.

КаналПрименяемое правило
WhatsAppЗа пределами 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, не буферизуйте запрос в памяти и разрешите час простоя при чтении и записи.