7 апреля, 2025

Обновления

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

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

Изменения в API

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

ПараметрТип данныхХарактерОписание
flowIdintegerОбязательный, если contentType = FLOWИдентификатор Flow, который присваивается в WhatsApp Manager в момент создания Flow.
screenstringНеобязательныйИдентификатор экрана, который первым будет отображаться во Flow.
captionstringОбязательный, если contentType = FLOWТекст кнопки, после нажатия на которую запускается Flow.
actionstringНеобязательныйТип взаимодействия Flow.

Возможные значения:
navigate — Flow не делает запрос к конечной точке. Значение по умолчанию.
data_exchange — Flow делает запрос к конечной точке.

Как создавать опросы с помощью WhatsApp Flows смотрите в инструкции Meta*.

Пример нешаблонного сообщения 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
    }
] 

Подробнее в API-документации:

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