Интеграция с Meta (Facebook)

Подключите вашего агента к Facebook Messenger через вашу страницу Facebook.

Обзор

Интеграция с Meta обеспечивает:

• Диалоги в Facebook Messenger через вашу страницу
• Встроенный Магазин Messenger, запускаемый из Persistent Menu страницы
• Фоновую обработку с индикатором набора текста
• Автоматическое разделение длинных ответов на части
• Соответствие правилу 24-часового окна обмена сообщениями
• Память диалога в рамках сессии

Предварительные требования

• Страница Facebook, которой вы управляете
• Роль администратора или редактора на странице
• Учётная запись Cuneiform Chat с активным агентом

Шаги настройки

1. Начало настройки интеграции

1. Перейдите в Integrations в боковой панели
2. Откройте карточку Facebook Pages
3. Нажмите Connect Page

2. Авторизация через Facebook

1. Выберите, какой Agent должен отвечать
2. Нажмите Connect with Facebook
3. Войдите в Facebook (если необходимо)
4. Выберите страницу, которую хотите подключить
5. Предоставьте разрешения Messenger
6. Вы будете перенаправлены обратно с сообщением об успехе

3. Проверка подключения

После подключения ваша страница появится в списке интеграций с указанием:

• Названия страницы и статуса
• ID страницы
• Временной метки последней активности

Как это работает

Когда пользователи пишут на вашу страницу Facebook через Messenger:

1. Сообщение поступает через Facebook Messenger
2. Бот показывает индикатор набора текста во время обработки
3. Ваш агент обрабатывает вопрос
4. Ответ отправляется обратно через Messenger

Возможности

Автоматические ответы

Ваш агент автоматически отвечает на входящие сообщения в Messenger на основе вашего контента. Все текстовые сообщения вызывают ответ — команды или префиксы не нужны.

Индикатор набора текста

Пока ваш агент обрабатывает сообщение, пользователи видят индикатор набора текста (”…”) в Messenger, создавая ощущение естественного разговора.

Разделение сообщений

Ответы длиннее 2 000 символов автоматически разделяются на несколько сообщений с сохранением границ абзацев и предложений для удобства чтения.

Память диалога

Бот запоминает контекст в рамках сессии, поэтому пользователи могут задавать уточняющие вопросы, не повторяя сказанное ранее.

Очередь сообщений

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

24-часовое окно обмена сообщениями

Политика Facebook позволяет отвечать в течение 24 часов после последнего сообщения пользователя. Ваш агент отвечает в реальном времени, укладываясь в это окно. После 24 часов бездействия пользователь должен отправить новое сообщение, чтобы возобновить диалог.

Управление страницами

Просмотр подключённых страниц

Для каждой подключённой страницы отображается:

• Название страницы и статус подключения
• Связанный агент
• Информация об активности

Доступные действия

Доступ к этим действиям через меню с тремя точками на каждой подключённой странице.

Устранение неполадок

Страница не отображается

1. Убедитесь, что у вас есть роль администратора или редактора на странице
2. Проверьте, что вы предоставили все запрошенные разрешения
3. Попробуйте отключить и подключить заново

Сообщения не получают ответов

1. Используйте “Test Connection” для проверки интеграции
2. Убедитесь, что ваш агент настроен и работает (протестируйте в Playground)
3. Проверьте, что разрешения Messenger предоставлены
4. Убедитесь, что пользователь писал в течение последних 24 часов (политика окна обмена сообщениями)

Ошибки авторизации

1. Очистите сессию входа в Facebook и попробуйте снова
2. Убедитесь, что ваша учётная запись Facebook имеет доступ к странице
3. Проверьте, что страница не ограничена Facebook

Безопасность

• Токены OAuth зашифрованы и хранятся безопасно
• Подписи webhook проверяются с помощью HMAC-SHA256 для каждого входящего запроса
• Нет доступа к контенту страницы за пределами диалогов в Messenger
• Соответствие политикам платформы Facebook

Отключение

Чтобы удалить интеграцию с Meta:

1. Перейдите в Integrations в боковой панели
2. Нажмите на меню с тремя точками на вашей странице
3. Выберите Disconnect

Для полного отзыва доступа:

1. Перейдите в Facebook Settings → Business Integrations
2. Удалите приложение Cuneiform Chat

Важные замечания

• Один агент на страницу: Каждая страница Facebook может быть подключена только к одному AI-агенту одновременно
• Только Messenger: Эта интеграция работает через Facebook Messenger, а не через комментарии или публикации на странице
• Лимит сообщений: Отдельные сообщения ограничены 2 000 символами; более длинные ответы автоматически разделяются
• Смена агента: Сначала отключите существующую интеграцию, затем подключите заново с другим агентом