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