Интеграция Dialogflow CX с WhatsApp через официальный Meta Cloud API

1. Мета

Сделать так, чтобы чат-бот в Dialogflow CX мог отвечать пользователям в WhatsApp, используя официальный WhatsApp Cloud API от Meta (без сторонних сервисов типа Twilio или 360Dialog).

2. Что делает заказчик

• Создаю и настраиваю приложение в Meta for Developers
• Добавляю продукт WhatsApp.
• Получаю необходимые данные: Access Token, Verify Token, Phone Number ID
• Передаю эти данные фрилансеру для подключения.

3. Что должен сделать фрилансер

• Создать небольшой сервер (middleware), который будет “переводчиком” между WhatsApp и Dialogflow.
• Настроить два основных маршрута:

GET /wa — для проверки соединения (Meta проверяет Verify Token и возвращает Challenge).

POST /wa — получает сообщение из WhatsApp, отправляет его в Dialogflow, получает ответ от бота и возвращает этот ответ обратно в WhatsApp.

• Подключить сервер к Dialogflow CX через официальный API (detectIntent).
• Подключить сервер к WhatsApp API через https://graph.facebook.com/vXX.X/{PHONE_NUMBER_ID}/messages.
• Развернуть сервер в Google Cloud Run (HTTPS, доступ “без авторизации”).
• Предоставить мне публичную ссылку на сервер (чтобы я добавил его в Meta Developer App в поле Webhook URL).
• Протестировать работу с тестовым WhatsApp номером.

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

• Человек отправляет сообщение в WhatsApp.
• Meta передает это сообщение на ваш сервер.
• Сервер берет текст и отправляет его в Dialogflow CX.
• Dialogflow формирует ответ.
• Сервер получает этот ответ и отправляет его обратно пользователю в WhatsApp.
• Пользователь видит ответ бота в чате.

5. Требования к реализации

• Сервер должен работать 24/7 и принимать запросы через HTTPS.
• Использовать Node.js (Express) или Python (FastAPI / Flask).
• Код должен быть аккуратным, с короткими комментариями.
• Токены (Access Token, Verify Token, Dialogflow ключ) должны храниться как переменные окружения (не в коде).

6. Результат работы (что я должен получить)

✅ Рабочий сервер в Cloud Run, который:

принимает сообщения из WhatsApp,

передает их в Dialogflow,

возвращает ответы в WhatsApp.

✅ Ссылка на сервер (Callback URL), которую я вставлю в Meta Developer App.

✅ Репозиторий с кодом (GitHub или GitLab) с инструкцией, как запустить.

✅ Файл README с кратким описанием:

• как настроить сервер,
• как подключить к Meta,
• как протестировать.

7. Пример потока данных

WhatsApp → Meta Webhook → Middleware Server → Dialogflow CX → Middleware Server → WhatsApp