Подключите номер WhatsApp Business через учётные данные Meta Cloud API и подписанные вебхуки.
Подключите номер WhatsApp Business через учётные данные Meta Cloud API и подписанные вебхуки.
Подготовьте приложение Meta и номер#
Используйте официальный гайд по началу работы с WhatsApp Cloud API Meta, чтобы создать или выбрать приложение Meta, добавить продукт WhatsApp и связать аккаунт WhatsApp Business и номер телефона.
Соберите эти три значения из одного приложения и номера:
| Поле Make Agent Fast | Значение провайдера | Примечания |
|---|---|---|
| ID номера телефона | Числовой Phone Number ID | Это не видимый номер + и не WABA ID |
| Токен доступа | Токен доступа Cloud API | Временные токены панели истекают; используйте подходящий долгоживущий токен системного пользователя для продакшена |
| Секрет приложения | Секрет приложения Meta | 32-символьный шестнадцатеричный секрет для проверки подписи вебхука |
Выдавайте только разрешения, нужные для номера и процесса сообщений. Держите ресурсы разработки/тестирования отдельно от продакшен-номера.
Сохраните и проверьте учётные данные#
Откройте страницу Коннекторы сайта, выберите WhatsApp, введите все три значения, выберите Отвечать голосом при необходимости и нажмите Подключить.
Make Agent Fast проверяет номер через Graph API с токеном доступа плюс appsecret_proof; это ловит неправильный номер, токен или секрет приложения до начала трафика вебхуков. Затем карточка коннектора раскрывает уникальный URL вебхука и Токен проверки.
Настройте вебхук Meta#
В том же приложении Meta:
- Откройте конфигурацию вебхука WhatsApp.
- Вставьте URL вебхука коннектора как URL обратного вызова.
- Вставьте Токен проверки коннектора точно; он чувствителен к регистру.
- Завершите проверку.
- Подпишите аккаунт/номер WhatsApp Business на поле вебхука
messages. - Убедитесь, что приложение и бизнес-ресурсы доступны предполагаемым тестовым или продакшен-пользователям.
Токен проверки доказывает владение во время GET-вызова проверки. Запросы POST во время работы отдельно аутентифицируются подписью секрета приложения Meta; не заменяйте одно другим.
Тестируйте текст и голос#
Сначала отправьте сообщение с разрешённого тестового номера. В режиме разработки Meta незарегистрированные пользователи могут не достигать приложения. Подтвердите ветку и канал в Диалогах и следите за Последним сообщением на карточке коннектора.
Входящий текст и голос поддерживаются. С включённым Отвечать голосом и настроенной речью Make Agent Fast загружает сгенерированное аудио через Cloud API и отправляет его вместе с текстовым ответом. Изображения, локации, контакты и другие неподдерживаемые типы сообщений игнорируются.
Готовность к продакшену#
Перед рекламой номера завершите проверку бизнеса Meta, проверку приложения, отображаемое имя, шаблоны и шаги политики сообщений, требуемые для вашего случая. Эти требования контролируются Meta и могут меняться независимо от Make Agent Fast.
Используйте продакшен-учётные данные с намеренным владельцем и процедурой истечения/ротации. Запишите, какое приложение Meta, системный пользователь, WABA и Phone Number ID принадлежат этому коннектору, чтобы оператор мог ротировать его без угадывания.
Ротация или отключение#
Создайте замещающий токен с тем же доступом к ресурсам, обновите коннектор, отправьте тестовое сообщение и только потом отзовите старый токен. Если секрет приложения меняется, обновите его в Make Agent Fast немедленно, иначе каждый подписанный входящий вебхук будет отклонён.
Отключение или удаление коннектора не отписывает и не удаляет конфигурацию вебхука Meta. Удалите подписку провайдера тоже при окончательном выводе номера из эксплуатации.
Решение проблем#
| Симптом | Решение |
|---|---|
| Учётные данные отклонены | Убедитесь, что токен может читать точный Phone Number ID и секрет приложения из того же приложения |
| Meta не может проверить обратный вызов | Используйте скопированный HTTPS URL и точный токен проверки; убедитесь, что коннектор всё ещё существует |
| Проверка успешна, но сообщения не приходят | Подпишите messages, проверьте связь WABA/номера, режим приложения, доступ тестовых пользователей и логи доставки провайдера |
| Вебхуки возвращают неавторизовано | Введите правильный секрет приложения заново; подписи POST Meta не используют токен проверки |
| Исходящие ответы не работают | Проверьте срок токена, разрешения номера, политику/окно получателя и ошибки Graph API |
| Текст работает, аудио нет | Проверьте ключи провайдеров транскрибации/речи и доступ токена к загрузке/скачиванию медиа |
Никогда не раскрывайте токен доступа или секрет приложения в браузерном коде. Используйте публичный API только с доверенного сервера при автоматизации создания коннекторов.