Перейти к основному содержимому

Нажмите на заголовок, чтобы изменить URL-адрес | Документация для разработчиков

Нажмите на целевой заголовок, чтобы изменить URL-адрес

Обновлено: 13 ноября 2025 г
В этом документе объясняется, как отправлять утвержденные шаблоны сообщений с помощью tap_target_configuration внутри шаблона сообщения. Переопределение параметра tap_target позволяет использовать шаблоны сообщений с изображениями, текстом и без заголовка в качестве интерактивных кнопок призыва к действию. Эти кнопки отображают пользовательский заголовок и открывают целевую страницу, связанную с первой кнопкой URL.
Для обеспечения соответствия требованиям и доступа к этому компоненту бизнес-аккаунты WhatsApp (WABA) должны быть полностью верифицированы и постоянно соответствовать высоким стандартам качества.

Синтаксис запроса

Используйте POST / /messages для отправки шаблона текстового сообщения пользователю WhatsApp.
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": "template", "template": { "name": "<TEMPLATE_NAME> ", "язык": { "код": "<LANGUAGE_AND_LOCALE_CODE> " }, "components": [ { "type": "tap_target_configuration", "parameters": [ { "type": "tap_target_configuration", "tap_target_configuration": [ { "url": "<URL> ", "заголовок": "<TITLE> " } ] } ] }, <!-- Добавить дополнительные компоненты --> ] } }

Параметры запроса

Заполнитель Описание Пример значения
<ACCESS_TOKEN>
Нить
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<API_VERSION>
Нить
Необязательный.
Версия Graph API.
v25.0
<LANGUAGE_AND_LOCAL_CODE>
Нить
Необходимый.
шаблона и код локали .
эн
<TEMPLATE_NAME>
Нить
Необходимый.
Название шаблона.
август_промоакция
<TITLE>
Нить
Необходимый.
Заголовок URL.
Подробности предложения!
<URL>
Нить
Необходимый.
URL.
https://www.luckyshrubs.com
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
Нить
Необходимый.
Идентификатор бизнес-телефона WhatsApp.
106540352242922
<WHATSAPP_USER_PHONE_NUMBER>
Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234

Пример запроса

Пример запроса на отправку шаблонного сообщения с tap_target_configuration .
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": "+1233214532", "type": "template", "template": { "name": "august_promotion", "language": { "code": "en" }, "components": [ { "type": "header", "parameters": [ { "type": "image", "image": { "link": "https://www.luckyshrubs.com" } } ] }, { "type": "body", "parameters": [ { "type": "text", "text": "Hello Энди..." } ] }, { "type": "tap_target_configuration", "parameters": [ { "type": "tap_target_configuration", "tap_target_configuration": [ { "url": "https://www.luckyshrubs.com/", "title": "Подробности предложения" } ] } ] } ] } }'

Пример ответа

{ "messaging_product": "whatsapp", "contacts": [ { "input": "+1233214532", "wa_id": "1233214532" } ], "messages": [ { "id": "wamid.HBgLMTMyMzI4NjU2NzgVAgARGBJBQzRBRDBEMDEwQzVBM0M0QkIA", "message_status": "accepted" } ] }