Перейти к основному содержимому
Версия: Последняя

Facebook-канал: создание и настройка

Лицензия

Данный функционал доступен только при наличии модуля Facebook.

Доступы

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.

Модуль Facebook поддерживает работу с комментариями к публикациям Facebook-страницы (Page Comments).

После подключения канала комментарии пользователей автоматически преобразуются в обращения IQChannels, а ответы операторов публикуются обратно в Facebook.

1. Предварительная подготовка​

Перед подключением Facebook-канала необходимо подготовить окружение в Meta (Facebook Developers).

1.1 Требования​

Необходимо:

  • иметь Facebook Page (страницу), от имени которой будет вестись работа;
  • иметь доступ к Meta for Developers;
  • создать приложение в Meta Developers;
  • получить доступ к странице через приложение;
  • получить Page Access Token для Facebook Page;
  • настроить Webhook для объекта Page.

1.2 Базовая схема подключения (важно для понимания)​

Процесс подготовки интеграции включает:

  1. Создается приложение в Meta Developers.
  2. Приложение привязывается к Facebook Page.
  3. Получается Page Access Token.
  4. В IQChannels создается канал Facebook.
  5. В канал добавляется Page Access Token.
  6. Система генерирует:
    • Webhook URL
    • Verify Token
  7. Webhook настраивается в Meta Developers.
  8. Подписка активируется на событие:
    • feed (комментарии страницы)

1.3 Права доступа (минимально необходимые)​

Приложению должны быть доступны:

  • чтение активности страницы
  • доступ к комментариям
  • управление комментариями страницы
  • доступ к событиям Page Webhooks (feed)

1.4 Важное ограничение Meta​

  • Комментарии доступны только для страниц, подключенных к приложению
  • Без подписки на Webhook события данные не поступают в IQChannels
  • Доступ к профилям пользователей может быть ограничен режимом Meta (особенно в Development Mode)

2. Подготовка страницы Facebook​

2.1 Создание и наличие страницы​

Должна быть создана Facebook Page, с которой будет вестись работа.

2.2 Привязка к приложению​

Страница должна быть подключена к созданному приложению в Meta Developers.

2.3 Проверка доступа​

Необходимо убедиться, что:

  • приложение имеет доступ к странице
  • пользователь, настраивающий интеграцию, имеет права администратора страницы

3. Создание Facebook-канала в IQChannels​

  1. Перейдите в нужный проект.

  2. Откройте раздел «Каналы».

  3. Нажмите «Создать канал».

  4. Выберите тип канала:

    • Facebook (Page Comments)

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

  • Название — отображаемое имя канала
  • На английском — системное уникальное имя
  • Описание — (опционально)
  1. Нажмите «Создать канал».

4. Настройка канала​

4.1 Подключение Page Access Token​

  1. Откройте созданный канал.

  2. Перейдите в Настройки.

  3. Укажите:

    • Page Access Token

  4. Сохраните изменения.

4.2 Автоматически создаваемые параметры​

После сохранения система автоматически генерирует:

  • Webhook URL
  • Verify Token

Эти значения используются для подключения Facebook Webhook.

5. Настройка Webhook в Meta​

  1. Перейдите в Meta Developers → ваше приложение.

  2. Откройте раздел Webhooks.

  3. Выберите объект:

    • Page

  4. Укажите:

    • Callback URL → Webhook URL из IQChannels
    • Verify Token → Verify Token из IQChannels

  5. Подтвердите подключение.

  6. Активируйте подписку на событие:

    • feed

6. Модель работы канала​

После подключения канал работает по следующей логике:

6.1 Входящие комментарии​

  • Пользователь оставляет комментарий к посту
  • Facebook отправляет событие feed
  • IQChannels создает обращение

6.2 Ответ оператора​

  • Оператор отвечает в IQChannels
  • Ответ публикуется как комментарий в Facebook
  • Ответ привязывается к исходному комментарию

6.3 Ответ пользователя​

  • Ответ на комментарий оператора
  • Добавляется в существующее обращение
  • Новое обращение не создается

6.4 Удаление комментария​

  • Комментарий может быть удален пользователем
  • Обращение в IQChannels сохраняется
  • Привязка к comment_id очищается

6.5 Игнорируемые события​

  • новые посты страницы
  • нерелевантные события feed
  • системные изменения, не относящиеся к комментариям

7. Работа операторов​

7.1 Обработка обращений​

Оператор может:

  • просматривать комментарии пользователей
  • отвечать на комментарии
  • вести диалог в рамках одного обращения
  • переходить к исходному посту Facebook

7.2 Контекст обращения​

В карточке обращения доступно:

  • исходный комментарий
  • ссылка на публикацию Facebook
  • история диалога

8. Проверка работоспособности​

После подключения необходимо проверить:

  • комментарии из Facebook поступают в IQChannels
  • создаются обращения
  • ответы операторов публикуются в Facebook
  • ответы пользователей продолжают существующий диалог
  • не создаются дубли обращений

9. Диагностика проблем​

9.1 Комментарии не поступают​

Проверить:

  • активирован ли модуль Facebook
  • корректность Page Access Token
  • привязка страницы к приложению
  • подписка Webhook на feed

9.2 Ответы не публикуются​

Проверить:

  • валидность Page Access Token
  • наличие прав на управление комментариями
  • корректную привязку comment_id к обращению

9.3 Webhook не работает​

Проверить:

  • доступность Webhook URL извне (HTTPS обязателен)
  • корректность Verify Token
  • активную подписку на feed

9.4 Потеря привязки комментария​

Причины:

  • удаление комментария пользователем
  • ограничения доступа Facebook к объекту
  • изменение или удаление ветки комментариев

10. Итоговая модель интеграции​