7 апреля, 2025

Отправляйте WhatsApp Flows по API в нешаблонных сообщениях WhatsApp.

Обновления

---

Добавили возможность отправлять WhatsApp Flows по API в нешаблонных сообщениях WhatsApp.

Теперь вы можете использовать WhatsApp Flows, чтобы автоматизировать сценарии взаимодействия с получателями, собирать больше данных о получателях, а также автоматизировать продажи, предлагать товары или услуги и многое другое. Подробнее про WhatsApp Flows читайте в документации Meta*.

developers.facebook.com

Изменения в API

Добавили новые параметры whatsappContent при отправке сообщений в канал WhatsApp:

Параметр	Тип данных	Характер	Описание
flowId	integer	Обязательный, если contentType = FLOW	Идентификатор Flow, который присваивается в WhatsApp Manager в момент создания Flow.
screen	string	Необязательный	Идентификатор экрана, который первым будет отображаться во Flow.
caption	string	Обязательный, если contentType = FLOW	Текст кнопки, после нажатия на которую запускается Flow.
action	string	Необязательный	Тип взаимодействия Flow. Возможные значения: navigate — по умолчанию Flow не делает запрос к конечной точке и data_exchange — Flow делает запрос к конечной точке. Как создавать опросы с помощью WhatsApp Flows смотрите в инструкции Meta*.

developers.facebook.com

Пример нешаблонного сообщения WhatsApp с функцией WhatsApp Flows:

{
    "requestId": "test-001",
    "cascadeId": "3",
    "subscriberFilter": {
        "address": "79000000000",
        "type": "PHONE"
    },
    "content": {
        "whatsappContent": {
            "contentType": "FLOW",
            "caption": "Перейти",
            "text": "Купить товары по скидкам",
            "flowId": 3779320943795899,
            "action": "navigate"
        }
    }
} 

Пример колбэка для входящего сообщения со значением FLOW в параметре messageContent.type:

[
    {
        "id": 101,
        "subject": "test_subject_WA",
        "subjectId": 50520,
        "subscriber": {
            "id": 4633047,
            "identifier": "79997776655"
        },
        "userInfo": {
            "userName": "Иван Иванов",
            "firstName": null,
            "lastName": null,
            "avatarUrl": null
        },
        "messageContent": {
            "type": "FLOW",
            "attachment": null,
            "location": null,
            "referral": null,
            "caption": null,
            "text": "{\"flow_token\":\"example\"}",
            "payload": null,
            "story": null,
            "items": null,
            "contact": null,
            "product": null,
            "catalog": null,
            "order": null
        },
        "receivedAt": "2025-03-25T12:12:12Z",
        "replyOutMessageId": null,
        "replyOutMessageExternalRequestId": null,
        "replyInMessageId": null
    }
] 

         

---

осторожно

* Деятельность компании Meta запрещена на территории Российской Федерации.