Отправка сообщений о заказах Shopify в WhatsApp

Как Shopify Flow отправляет сообщение в WhatsApp?

С помощью действия Send HTTP request: оно отправляет запрос на любой URL с заголовками и телом, где можно использовать переменные Liquid из триггера.

Создайте рабочий процесс с триггером создания заказа и добавьте Send HTTP request. В качестве URL укажите эндпоинт сообщений Cloud API для `phone number id` подключённого номера. Добавьте заголовок Authorization со значением Bearer и токеном доступа номера: храните токен как секрет Flow и подставляйте его через переменную секрета. Значения секретов не отображаются в интерфейсе Flow и скрываются в журналах запусков, там токену и место. Тело запроса представляет собой шаблонное сообщение: номер телефона клиента в поле `to`, данные заказа в параметрах шаблона.

Flow считает успехом ответ 2XX или 3XX. На корректный запрос Meta возвращает идентификатор сообщения, поэтому успешный запуск означает, что Meta приняла сообщение.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Почему сообщение о заказе должно быть шаблоном?

Потому что первым пишет магазин. Окно обслуживания клиентов Meta (24 часа) открывается только тогда, когда клиент сам пишет на номер. Подтверждение заказа, обновление о доставке или напоминание о брошенной корзине отправляются раньше, поэтому свободный текст отклоняется, а проходит только заранее одобренный шаблон.

Создайте шаблон один раз, в категории `utility` для обновлений о заказах и доставке, и дождитесь одобрения, прежде чем включать рабочий процесс. Название и язык в теле запроса должны точно совпадать с одобренным шаблоном, а количество параметров должно совпадать с количеством его плейсхолдеров.

Есть и вопрос согласия. Meta требует opt-in до того, как бизнес напишет человеку в WhatsApp: человек оставил свой номер и согласился получать сообщения от этого бизнеса. Обычно согласие собирают флажком при оформлении заказа, а рабочий процесс должен проверять его перед отправкой.

Что делать, если на тарифе магазина нет Send HTTP request?

Используйте вебхук администратора Shopify. В разделе «Настройки», «Уведомления», «Webhooks» можно создать вебхук на событие, например создание заказа, в формате JSON на нужный URL. Направьте его на приёмник: узел Webhook в n8n или маршрут на PHP, Python либо Node. Приёмник читает заказ, проверяет согласие и делает тот же вызов Cloud API с шаблоном.

Независимо от способа отправки ответы работают одинаково. Когда клиент отвечает на сообщение о заказе, ответ приходит в приложение WhatsApp Business на телефоне магазина, потому что номер работает в режиме Coexistence, и окно в 24 часа открыто для свободного текста. Если для номера задан адрес вебхука, ответ также попадёт в вашу систему. Само сообщение о заказе тоже отображается в приложении, поэтому сотрудник видит, на что отвечает клиент.

Распространённые ошибки

• Отправка свободного текста при создании заказа. Клиент ещё не писал, поэтому Meta отклонит сообщение: нужен одобренный шаблон.
• Обработка ошибок с повторной отправкой для ответов 4XX. Flow может до 24 часов повторять запрос, который Meta никогда не примет.
• Токен в заголовке открытым текстом. Храните его как секрет Flow, чтобы он не попадал в интерфейс и журналы.

Часто задаваемые вопросы

Читайте дальше