Каналы связи
Подключение WhatsApp Business через Meta Cloud API: что подготовить, откуда взять phone_number_id и токен, куда вставить Callback URL и Verify Token.
Агент отвечает клиентам в WhatsApp с вашего рабочего номера. Подключение идёт через официальный WhatsApp Cloud API от Meta — это самый долгий из наших каналов, потому что часть шагов делается на стороне Meta, а не в кабинете ReplAI.
Раздел в кабинете: Каналы → WhatsApp.
Что нужно подготовить
- Аккаунт Meta Business (business.facebook.com).
- Приложение в developers.facebook.com с добавленным продуктом WhatsApp.
- Номер телефона, который ещё не используется в обычном приложении WhatsApp или WhatsApp Business. Если номер уже занят — сначала удалите с него аккаунт WhatsApp, иначе Meta не даст его подключить.
Пошаговая инструкция Meta: WhatsApp Cloud API — Get Started.
Шаг 1. Данные из Meta
В приложении Meta откройте WhatsApp → API Setup. Оттуда понадобятся:
| Что | Где взять | Пример |
|---|---|---|
phone_number |
Ваш номер в международном формате | +996700000000 |
phone_number_id |
Поле «Phone number ID» на странице API Setup | 1234567890 |
| Access token | Кнопка генерации токена там же | EAAG... |
Шаг 2. Подключение в кабинете
- Каналы → WhatsApp → Подключить.
- Заполните
phone_number,phone_number_idи access token, сохраните. - После сохранения в карточке канала появятся два поля — Callback URL и Verify Token. Они нужны для следующего шага, каждое копируется кликом.
Шаг 3. Webhook на стороне Meta
Вернитесь в приложение Meta: WhatsApp → Configuration → Webhook → Edit.
- Callback URL — вставьте значение из кабинета ReplAI.
- Verify Token — вставьте значение из кабинета ReplAI.
- Нажмите Verify and save. Ошибка проверки почти всегда означает, что значения скопированы не полностью или перепутаны местами.
- В списке полей подписки (Webhook fields) включите messages — без этого Meta не будет присылать сообщения клиентов.
Шаг 4. Проверка
Напишите на свой рабочий номер с другого телефона. Ответ придёт от агента, а диалог появится в разделе Диалоги с пометкой WhatsApp.
Полезно знать
Окно 24 часов. Правило Meta, не ReplAI: свободно переписываться с клиентом можно в течение 24 часов после его последнего сообщения. Позже — только заранее одобренным шаблоном. Поэтому агент отвечает быстро, а «догонять» клиента через сутки уже не получится.
Номер занят обычным WhatsApp. Один номер не может быть одновременно в Cloud API и в приложении WhatsApp/WhatsApp Business. Планируйте отдельный номер для агента.
Смена токена. Протух или отозван — сохраните новый в кабинете, webhook заново настраивать не нужно.
Оператор подключается так же, как в других каналах — из раздела Диалоги.
Если сообщения не приходят
- Webhook: в Meta → Configuration статус должен быть подтверждён, поле messages — включено.
- Токен: тестовый токен на 24 часа — самая частая причина «работало вчера, молчит сегодня».
phone_number_id: это длинное число из API Setup, а не сам номер телефона — их легко перепутать.- Баланс токенов в разделе Биллинг: на нуле агент молчит во всех каналах — см. Тарифы и токены.
Если все четыре пункта в порядке, напишите в поддержку ReplAI — подскажем по конкретному приложению Meta.