Каналы: SMS, WhatsApp, Telegram
4 мин чтения
Сообщения нужны там, где звонок лишний: подтверждение заказа, номер посылки, напоминание перед доставкой. Каналов три — SMS, WhatsApp и Telegram, — и различаются они не столько ценой, сколько тем, кому и когда вы имеете право написать первым.
Три канала и их особенности
НастройкиКаналыЛогин
xe-kg
Пароль
Задан — оставьте пустым
Подпись отправителя
XE
Идентификатор номера
109876543210987
Постоянный токен
Задан — оставьте пустым
Токен подтверждения адреса
xe-verify-2026
Секрет подписи вебхука
App Secret из панели Meta
Адрес вебхука для Meta
https://demo.xe.kg/api/v1/comms/hooks/whatsapp
Токен бота от @BotFather
123456:ABC-DEF…
Секрет вебхука
произвольная строка
Каждый канал включается своим переключателем и работает независимо от остальных. Пароли и токены наружу не отдаются: в поле стоит подпись Задан — оставьте пустым, и пустое поле при сохранении оставляет прежнее значение. Если канал включён, но отправка не идёт, рядом с кнопкой Сохранить будет видна последняя ошибка провайдера — с неё и начинайте разбор.
| Канал | Кому можно написать первым |
|---|---|
| SMS | Любому номеру. Самый безотказный канал и самый дорогой при длинном тексте. |
| Только согласованным с Meta шаблоном. Свободный текст открывается на сутки после ответа клиента. | |
| Telegram | Никому: диалог начинает клиент. Пока его номер не связан с чатом, сообщения по заказу уходят в SMS или WhatsApp. |
Электронной почты и Viber в системе нет. Не потому, что их нельзя добавить, а потому, что в этой нише они не работают: заказ подтверждают по телефону, а трек читают в мессенджере.
SMS через Nikita
От клиента нужны три вещи: логин, пароль и согласованная подпись отправителя. Подпись согласуется с оператором связи заранее — с непрописанной подписью шлюз просто откажет в отправке.
WhatsApp через Meta
Канал работает через Meta Cloud API, и настройка требует четырёх значений из панели Meta:
- Идентификатор номера — того номера, с которого пишете.
- Постоянный токен — доступ к отправке.
- Токен подтверждения адреса — произвольная строка, которой Meta проверяет ваш адрес при подключении вебхука.
- Секрет подписи вебхука — App Secret. Без него подпись входящих не проверяется, и на боевом подключении их сможет прислать кто угодно.
Готовый Адрес вебхука для Meta система показывает сама — его нужно скопировать в настройки приложения на стороне Meta, иначе ответы клиентов до системы не дойдут.
Telegram через бота
Нужны токен бота от @BotFather и произвольный секрет вебхука. После сохранения нажмите Подключить вебхук: система сама подпишет бота на события и покажет его имя и число связанных чатов.
Главное ограничение канала техническое, а не наше: боту нельзя написать первым. Клиент открывает диалог сам и делится номером по кнопке — только после этого его чат связывается с заказами. Поэтому Telegram хорош как второй канал для тех, кто уже написал, но не годится как основной способ уведомлений.
Переписка в карточке
10.08 14:31WhatsAppавтоматическиДоставлено
Заказ 10553 принят. Курьер приедет 12 августа, к оплате 3 480 KGS.
10.08 15:02WhatsAppклиент
А можно после шести? Я до шести на работе
10.08 15:04SMSАйгульВ очереди
Передали курьеру: доставка после 18:00.
09.08 21:40SMSавтоматическиНе доставлено
Заказ 10498 отправлен, номер посылки KG123456789.
Вкладка Сообщения в карточке заказа держит одну ленту на все каналы: оператору важно, что клиенту уже писали, а чем именно — второй вопрос. Канал виден меткой у каждого сообщения. Входящие приходят вебхуком в ту же ленту, вложения поддерживаются. Отдельно помечено, что ушло автоматически, а что написал человек, — остальные вкладки разобраны в Карточке заказа.
Чтобы написать самому, выберите канал и при желании Шаблон — текст подставится с уже заполненными данными заказа, и его ещё можно поправить. Пункт Свой текст оставляет поле пустым. Для SMS под полем показывается, сколько знаков набрано и во сколько частей уложится сообщение.
Состояния доставки
| Состояние | Что значит и что можно сделать |
|---|---|
| В очереди | Сообщение принято, но ещё не ушло: ждёт отправки или утра. Можно отменить. |
| Отправлено | Передано провайдеру. |
| Доставлено | Провайдер подтвердил доставку. WhatsApp сообщает об этом сам, у SMS система спрашивает шлюз. |
| Не доставлено | Провайдер отказал или доставка не удалась. Рядом текст ошибки, можно повторить. |
| Отменено | Отменено вручную или снято автоматически — например, заказ удалили как дубль. |
Неудачную отправку система повторяет сама: до пяти попыток с растущим интервалом — две минуты, четыре, восемь и так до часа. Только после этого сообщение получает состояние Не доставлено. Так что кнопка повтора нужна не сразу, а когда причина устранена: пополнен баланс, исправлена подпись отправителя.
Ночью очередь копится и уходит утром — по часовому поясу клиента, а не колл-центра. Часы тишины задаются в настройках проекта и действуют на все каналы; подробности и привязка шаблонов к статусам — в Шаблоны сообщений и автоотправка. Отправку по условию, а не по статусу, умеют правила автоматизации: там же настраивается, кому и когда уходит уведомление помимо смены статуса.
Не нашли ответ
Напишите на hello@xe.kg — ответим и дополним статью. Так она и растёт.