Официальные каналы
Как подключить WhatsApp Business и Telegram-бота через официальные API — WhatsApp Cloud API от Meta и Bot API от Telegram.
Кроме Подключений в Lalexi есть официальные каналы — подключение напрямую к бизнес-API мессенджера, по ключам, которые вы получаете у самой платформы:
- WhatsApp Business — через WhatsApp Cloud API (Meta);
- Telegram-бот — через Bot API (токен от BotFather).
Переписка из них попадает в тот же общий список чатов, а команда отвечает так же, как и в любом другом канале.
Чем это отличается от «Подключений»
| Подключения (меню «Главная») | Официальные каналы (Настройки) | |
|---|---|---|
| Что подключается | личный аккаунт по QR-коду или бот по токену | WhatsApp Business API и Telegram-бот |
| Кто настраивает | любой сотрудник с доступом к разделу | только администратор пространства |
| Нужны ключи от платформы | нет | да: Meta или BotFather |
| Занимает слот в лимите подключений | да | нет |
| Массовая рассылка, Прогрев, Начать диалог, Расход | да | нет |
| Импорт прежней переписки | да, у личных аккаунтов | нет, только новые сообщения |
| SLA, Контроль качества, отчёты | да | да |
Официальные каналы живут вне раздела «Главная»: их не видно в «Подключениях», они не занимают слот лимита и их сообщения не попадают в Расход. Отвечать на них, назначать SLA и проверять качество переписки при этом можно как обычно.
Где это находится
Настройки → Источники (в английском интерфейсе — Settings → Inboxes) → кнопка Добавить источник (Add Inbox). Дальше — четыре шага мастера: выбрать канал, ввести данные, добавить операторов, готово.
Раздел Настройки → Источники доступен только администраторам пространства. У сотрудника с ролью «оператор» его в меню не будет — см. Команда.
Часть каналов в списке показана бледной и не нажимается — Facebook, Instagram и голосовые звонки не настроены в вашей инсталляции. WhatsApp и Telegram доступны.
WhatsApp Business (WhatsApp Cloud API)
Что нужно подготовить заранее
Всё это делается на стороне Meta, до захода в Lalexi:
- Бизнес-аккаунт WhatsApp (WABA) в Meta Business.
- Номер телефона, заведённый в WABA. Он не должен быть при этом привязан к обычному приложению WhatsApp или WhatsApp Business — номер живёт либо там, либо в API.
- Приложение в Meta for Developers с подключённым продуктом WhatsApp.
- Постоянный токен доступа — токен системного пользователя с правами
whatsapp_business_messagingиwhatsapp_business_management. Временный токен с вкладки «API Setup» живёт сутки: канал на нём создастся, а на следующий день отвалится.
На странице приложения WhatsApp → API Setup заодно скопируйте два значения: Phone number ID и WhatsApp Business Account ID.
Подключение
-
Настройки → Источники → Добавить источник и выберите WhatsApp.
-
На шаге выбора провайдера нажмите WhatsApp Cloud. Вариант Twilio нужен, только если ваши номера обслуживает Twilio.
-
Заполните форму:
Поле Что вводить Имя источника Как канал будет называться в списке чатов, например «WhatsApp Business». Номер телефона Номер из WABA в международном формате: со знаком +, без пробелов и дефисов.ID номера телефона Phone number ID из панели Meta — только цифры. ID бизнес-аккаунта WhatsApp Business Account ID из панели Meta — только цифры. Ключ API Постоянный токен доступа. -
Нажмите Создать канал WhatsApp.
-
На следующем шаге добавьте операторов — сотрудников, которые будут видеть эти переписки, и себя в том числе. Без этого шага диалоги никому не видны.
Что происходит само
Ничего дописывать в панели Meta не нужно — Lalexi при создании канала сам:
- проверяет ключи, обращаясь к Meta (если данные неверны, канал просто не создастся);
- при необходимости регистрирует номер в Cloud API;
- прописывает вебхук у Meta — адрес обратного вызова и токен проверки, чтобы входящие сообщения приходили в Lalexi.
Посмотреть Webhook Verification Token и текущий API Key, заменить ключ на новый или обновить список шаблонов можно потом в самом источнике: его карточка → вкладка Configuration.
24-часовое окно и шаблоны
Это правило Meta, а не Lalexi: свободно писать клиенту можно только 24 часа после его последнего сообщения. Когда окно закрылось, поле ответа блокируется с подсказкой, что доступны только шаблоны, и отправить можно лишь одобренный шаблон — выбрать его можно там же, в окне диалога.
Шаблоны создаются и проходят модерацию на стороне Meta. Кнопка Sync Templates во вкладке Configuration подтягивает свежий список — нажмите её после того, как Meta одобрит новый шаблон.
Если что-то не получилось
| Симптом | Причина |
|---|---|
| При создании канала — ошибка про неверные данные | Токен без нужных прав, временный (уже истёк) токен, либо перепутаны местами ID номера и ID бизнес-аккаунта. |
| Форма не принимает номер | Номер должен начинаться с + и идти без пробелов, скобок и дефисов. |
| Форма не принимает ID | В обоих полях ID — только цифры, без пробелов. |
| Номер уже используется | Один и тот же номер нельзя завести в двух источниках. Удалите старый источник или используйте другой номер. |
| Канал создан, но входящие не приходят | Проверьте, что номер в WABA действительно закреплён за тем же приложением, чей токен вы указали, и что приложение не в режиме разработки с ограничениями. |
Telegram-бот
Создайте бота
- В Telegram напишите аккаунту @BotFather.
- Отправьте команду
/newbot, задайте имя иusernameбота. - BotFather пришлёт в ответ токен — длинную строку вида
123456789:AA.... Это и есть доступ к боту.
Подключение
-
Настройки → Источники → Добавить источник и выберите Telegram.
-
Вставьте токен в поле Токен авторизации (Bot Token).
-
Нажмите Создать канал Telegram.
-
Добавьте операторов — иначе переписку никто не увидит.
Токен проверяется сразу: если он неверный или отозван, канал не создастся. Имя вводить не нужно — источник появится в списке как Telegram; переименовать его можно потом в его настройках. Вебхук у Telegram Lalexi прописывает сам.
Один бот — одна система. При подключении Lalexi перенастраивает вебхук бота на себя, а прежний — снимает. Если этот бот уже работал в другом сервисе или на своём скрипте, там он замолчит. Для проверки заведите отдельного бота.
Как этим пользоваться
- Бот не может написать первым. Разговор начинает человек: он открывает
бота и нажимает Start. Дайте клиентам ссылку вида
t.me/имя_бота— например, на сайте или в подписи. - Переписка появляется в общем списке чатов с первым же входящим сообщением.
- Основной сценарий — личная переписка один-на-один.
- Как и у ботов из «Подключений», у Telegram-бота нет прежней истории: подтянутся только сообщения, пришедшие после подключения.
Zalo-бот
Zalo подключается не здесь, а в разделе «Главная» → «Подключения»: это наша интеграция, и токен бота вставляется там. Пошагово — в разделе Подключения, пункт «Бот по токену».