Интеграция чатбота с Facebook Messenger

Мета

Разработать интеграцию нашего сервиса чат-ботов с Facebook Messenger через Meta Messenger API. Интеграция должна обеспечить:

1. Прием сообщений от пользователей в Facebook Messenger.
2. Отправку ответов пользователям через Messenger.

Интеграция должна быть выполнена как отдельный модуль, который взаимодействует с нашим API.

Задачи

1. Авторизация

   • Обеспечить процесс авторизации через Meta App Dashboard.
   • Реализовать обработку и хранение токенов доступа (Page Access Token).
   • Добавить проверку валидности токенов.

2. Настройка вебхука

   • Реализовать вебхук для приема событий от Facebook Messenger:
     • messages: получение сообщений от пользователей.
     • message_deliveries, message_reads: информация о доставке и прочтении сообщений.
   • Регистрация вебхука через Meta App Dashboard.

3. Прием сообщений

   • Обработка входящих сообщений и передача их в стандартном формате через наше API:
     Формат сообщения:

     jsonКопировать код{
     
       "message_id": "string",
     
       "sender_id": "string",
     
       "recipient_id": "string",
     
       "timestamp": "ISO8601",
     
       "content": "string",
     
       "type": "text|image|video|audio|file"
     
     }
     
     

   • Поддерживаемые типы контента:
     • Текст.
     • Изображения.
     • Видео.
     • Аудио.
     • Документы.

4. Отправка сообщений

   • Реализовать функционал отправки сообщений через Messenger API.
   • Поддерживаемые типы ответов:
     • Текстовые сообщения.
     • Медийные файлы (изображения, видео, аудио).
     • Документы.
     • Quick Replies (быстрые ответы).

5. Обработка ошибок

   • Реализовать логику обработки ошибок:
     • Невалидный токен доступа.
     • Отсутствие разрешений.
     • Ошибки доставки сообщений.
   • Все ошибки фиксировать в журнале с детальным описанием.

6. Настройка и тестирование

   • Обеспечить настройку интеграции через Meta App Dashboard:
     • Подключение страниц.
     • Выбор событий для вебхука.
   • Предоставить тестовую страницу для демонстрации работы интеграции.

7. Документация

   • Подготовить документацию, которая включает:
     • Инструкции по настройке интеграции в Meta App Dashboard.
     • Описание API, которое будет использоваться для взаимодействия.
     • Примеры запросов и ответов.

Технические требования

1. API Facebook Messenger

   • Использовать Messenger Platform API.
   • Обязательно реализовать вебхук для обработки событий.

2. Формат данных

   • Принятые сообщения передавать в JSON-формате, описанном выше.
   • Ответы в соответствии с форматом Messenger API.

3. Языки программирования

   • Предпочтение: Python или Node.js.
   • Другие языки допускаются по предварительному согласованию.

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

   • Все запросы должны выполняться через HTTPS.
   • Токены доступа должны быть зашифрованы.

Ожидаемый результат

1. Модуль интеграции, который позволяет принимать и отправлять сообщения через Facebook Messenger.
2. Документация для настройки и использования модуля.
3. Демонстрация работы интеграции на тестовой странице Facebook.

Срок выполнения

• Ориентировочный срок выполнения: 14 календарных дней с момента принятия заказа.

Бюджет

это предварительный отбор, наиболее подходящим исполнителям будет предоставлена документация нашего API

• Укажите ваши предложения по бюджету в заявке.