Facebook в UnifyPort: подключите личные сообщения к процессам поддержки

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

UnifyPort добавляет Facebook в единый API сообщений наряду с WhatsApp, Telegram, LINE, X, Zalo и TikTok. Разработчики могут отправлять личные сообщения через общий эндпоинт и получать поддерживаемые входящие сообщения в виде стандартных событий Webhook.

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

Ещё один канал в знакомой схеме обработки

Сообщения Facebook можно включить в тот же поток обработки событий, который ваше приложение использует для других каналов UnifyPort. Настройте активную подписку Webhook на message.received, а дальнейшие действия определите в своём бэкенде.

Интеграция Facebook преобразует поддерживаемые личные сообщения со сквозным шифрованием (E2EE) в это стандартное событие. Приложение может связать его с аккаунтом для обмена сообщениями и диалогом, затем передать в собственную очередь поддержки или бизнес-систему.

Схема интеграции остаётся общей: получить событие, обработать его в приложении и отправить ответ через POST /v1/messages. Особенности каналов описаны в руководстве по поддержке сообщений.

Общение не ограничивается текстом

Интеграция Facebook поддерживает текст и отправку отдельных изображений, видео, аудио и файлов. Приложение может выбирать формат под конкретную задачу:

• Отправить фотографию товара во время обсуждения покупки.
• Показать порядок действий в видео, когда текстового объяснения недостаточно.
• Передать документ или файл, к которому клиент сможет вернуться позже.

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

API также предоставляет список диалогов в пределах текущей синхронизации аккаунта. Приложение может получить идентификаторы диалогов и использовать их в дальнейшей обработке.

Свяжите сообщения с работой команды

Входящее сообщение может запускать разные процессы в вашем приложении:

• Поддержка: создать задачу в собственной службе поддержки и передать ответ сотруднику.
• CRM: связать диалог с карточкой клиента и сохранить нужный контекст.
• AI-помощь: передать сообщение в собственный AI-процесс для подготовки варианта ответа, а проверку и отправку организовать в приложении.

Сопоставление клиентов, назначение ответственных и AI-логику вы реализуете в своём приложении вокруг сообщений и событий UnifyPort. Начните с одной понятной задачи — например, принять вопрос о товаре и ответить на него, — затем расширяйте процесс.

Подключение через существующую сессию Facebook

Facebook подключается через уже авторизованную Cookie-сессию. Подготовка состоит из четырёх шагов:

1. Разместите JSON сессии по контролируемому URL с коротким сроком действия, доступному серверу.
2. Создайте аккаунт для обмена сообщениями с provider=facebook и auth_mode=session.
3. Импортируйте сессию через session_url.
4. Перед отправкой подтвердите авторизацию и runtime_status=running.

Храните данные сессии на сервере. Когда аккаунт и подписка Webhook готовы, проверьте полный путь на тестовом диалоге: получение сообщения, обработка в своей системе и отправка ответа.

Начните с одного диалога Facebook

Выберите один диалог Facebook и одну бизнес-задачу, которую хотите с ним связать. Настройте первый поток сообщений, а при добавлении других каналов UnifyPort используйте тот же подход.

Откройте руководство по подключению Facebook, чтобы подключить аккаунт, или создайте рабочее пространство UnifyPort, чтобы начать подготовку.