Интерактивные сообщения с призывами к действию в виде кнопок URL | Документация для разработчиков
Интерактивные сообщения с призывом к действию в виде кнопок URL
Обновлено: 3 ноября 2025 г
Пользователи WhatsApp могут опасаться нажимать на длинные или непонятные URL-адреса в текстовых сообщениях. В таких ситуациях может быть полезно отправить интерактивное сообщение с призывом к действию (CTA) в виде кнопки. Сообщения с кнопками CTA позволяют сопоставить любой URL-адрес с кнопкой, поэтому вам не нужно включать сам URL-адрес в текст сообщения.
Синтаксис запроса
Конечная точка: POST / /сообщения
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "interactive", "interactive": { "type": "cta_url",<!-- If using document header, otherwise omit --> "header": { "type": "document", "document": { "link": "<ASSET_URL> " } },<!-- If using image header, otherwise omit --> "header": { "type": "image", "image": { "link": "<ASSET_URL> " } },<!-- If using text header, otherwise omit --> "header": { "type": "text", "text": "<HEADER_TEXT> " } },<!-- If using video header, otherwise omit --> "header": { "type": "video", "video": { "link": "<ASSET_URL> " } }, "body": { "text": "<BODY_TEXT> " }, "action": { "name": "cta_url", "parameters": { "display_text": "<BUTTON_LABEL_TEXT> ", "url": "<BUTTON_URL> " } },<!-- If using footer text, otherwise omit --> "футер": { "текст": "<FOOTER_TEXT> " } } }'Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить | Необходимый. Системный токен или бизнес-токен . | |
<API_VERSION>Нить | Необязательный. Версия Graph API. | v25.0 |
<ASSET_URL>Нить | Обязательно, если используется заголовок с медиафайлом. URL ресурса на общедоступном сервере. | https://www.luckyshrub.com/assets/lucky-shrub-banner-logo-v1.png |
<BODY_TEXT>Нить | Необходимый. Основной текст. URL-адреса автоматически преобразуются в гиперссылки. Максимальное количество символов: 1024. | Нажмите на кнопку ниже, чтобы посмотреть доступные даты. |
<BUTTON_LABEL_TEXT>Нить | Необходимый. Текст надписи на кнопке. Должен быть уникальным, если используется несколько кнопок. Максимум 20 символов. | Смотрите даты |
<BUTTON_URL> | Необходимый. URL-адрес, который будет загружаться в веб-браузере по умолчанию на устройстве при нажатии пользователем WhatsApp. | https://www.luckyshrub.com?clickID=kqDGWd24Q5TRwoEQTICY7W1JKoXvaZOXWAS7h1P76s0R7Paec4 |
<FOOTER_TEXT>Нить | Обязательно, если используется нижний колонтитул. Текст в нижнем колонтитуле. URL-адреса автоматически преобразуются в гиперссылки. Максимум 60 символов. | Даты могут быть изменены. |
<HEADER_TEXT>Нить | Обязательно, если используется текстовый заголовок. Заголовочный текст. Максимум 60 символов. | Объявлены новые даты проведения мастер-классов! |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить | Необходимый. Идентификатор бизнес-телефона WhatsApp. | 106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>Нить | Необходимый. Номер телефона пользователя WhatsApp. | +16505551234 |
Пример запроса
curl 'https://graph.facebook.com/v25.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "interactive", "interactive": { "type": "cta_url", "header": { "type": "image", "image": { "link": "https://www.luckyshrub.com/assets/lucky-shrub-banner-logo-v1.png" } }, "body": { "text": "Нажмите кнопку ниже, чтобы увидеть доступные даты." }, "action": { "name": "cta_url", "parameters": { "display_text": "См. даты", "url": "https://www.luckyshrub.com?clickID=kqDGWd24Q5TRwoEQTICY7W1JKoXvaZOXWAS7h1P76s0R7Paec4" } }, "footer": { "text": "Даты могут быть изменены." } } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }
Комментарии отсутствуют
Комментарии отсутствуют