Інтеграція чатботу із 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 календарних днів із моменту прийняття замовлення.

Бюджет

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

• Вкажіть ваші пропозиції по бюджету у заявці.