Интерактивные сообщения с призывами к действию в виде кнопок URL | Документация для разработчиков
Интерактивные сообщения с призывом к действию в виде кнопок URL
Обновлено: 3 ноября 2025 г
Пользователи WhatsApp могут опасаться нажимать на прямые URL-адреса, содержащие длинные или непонятные строки в текстовых сообщениях. В таких ситуациях вы можете предпочесть отправить интерактивное сообщение с призывом к действию (CTA) в виде кнопки URL. Сообщения с кнопками CTA позволяют сопоставить любой URL-адрес с кнопкой, чтобы вы могли.. дон'дон'Необходимо включить необработанный URL-адрес в тело сообщения.
Запрос
синтаксис
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>Нить
Необходимый.
Системный токен или бизнес-токен .
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD<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" } ] }