Lalexi
РуководствоПодключения

Facebook

Как подключить страницу Facebook (Messenger) через своё приложение Meta: ID и секрет приложения, токен страницы, проверка и вебхук — автоматически.

Это переписка со страницей Facebook через Messenger. Подключение идёт через ваше собственное приложение Meta, так же как WhatsApp Business: приложение и страница принадлежат вам, Lalexi только принимает и отправляет сообщения. Правила Meta приложение соблюдает от вашего имени, и её решения касаются только вашего приложения.

Первым написать нельзя: Meta разрешает отвечать тем, кто написал сам, в течение 24 часов после его последнего сообщения.

Что нужно подготовить

Всё это делается на стороне Meta, до захода в Lalexi:

  1. Страница Facebook, где вы администратор.
  2. Приложение в Meta for Developers (developers.facebook.com): My Apps → Create App, тип Business, привязанное к вашему бизнес-портфелю. Добавьте в него продукт Messenger.
  3. ID и секрет приложения — на странице приложения App settings → Basic: поля App ID и App Secret. Там же укажите ссылку на политику конфиденциальности и переведите приложение в режим Live.
  4. Токен страницы: Messenger → Messenger API Settings → Generate access tokens — подключите страницу и нажмите Generate. Токену нужны разрешения pages_messaging и pages_manage_metadata. Нужен бессрочный токен страницы, а не временный токен пользователя: Lalexi проверит это при подключении и скажет, если что-то не так.

Подключение делает администратор пространства — см. Команда.

Как подключить

  1. Откройте Настройки → Источники (Settings → Inboxes) и нажмите Добавить источник (Add Inbox).

  2. Выберите Facebook.

  3. Заполните форму:

    ПолеЧто вводить
    Название источникаНеобязательно. Пусто — возьмём название страницы.
    ID приложенияApp ID, только цифры.
    Секрет приложенияApp Secret.
    Токен страницыТокен из шага 4 выше.
  4. Нажмите Подключить. Lalexi проверит в Meta, что токен живой, выпущен этим приложением и принадлежит странице, пропишет в приложении наш вебхук и подпишет на него страницу. Руками в кабинете Meta вебхук настраивать не нужно.

  5. Добавьте операторов источника — как у любого стандартного источника.

Если ключи перестали работать

Токен могут отозвать, секрет приложения — сбросить. Тогда в настройках источника появится предупреждение. Откройте вкладку «Приложение Meta», вставьте новые значения в «Заменить ключи» и сохраните: источник и вся переписка остаются.

Если что-то пошло не так

СообщениеЧто делать
Meta не приняла ID или секрет приложенияСверьте App ID и App Secret на странице App settings → Basic.
Токен выпущен другим приложениемСгенерируйте токен страницы в том же приложении, чей ID вводите.
Это не токен страницыНужен токен страницы из Messenger API Settings, а не токен пользователя.
У токена не хватает разрешенийВыдайте pages_messaging и pages_manage_metadata и сгенерируйте токен заново.
Уже подключено в другом пространствеОдна страница может быть только в одном пространстве Lalexi.
Сообщения от клиентов не приходятПроверьте, что приложение в режиме Live. Если пишут только люди с ролью в приложении, Meta требует проверку приложения (App Review) на pages_messaging.

Содержание