Отправка сообщений с кнопкой вызова WhatsApp и прямых ссылок | Документация для разработчиков
Отправляйте сообщения с кнопкой вызова WhatsApp и прямые ссылки
Обновлено: 25 февраля 2026 г
Обзор
После внедрения функций Cloud API Calling вы сможете повысить осведомленность своих клиентов двумя основными способами:
Отправьте интерактивное сообщение с помощью кнопки вызова WhatsApp
Используйте этот конечный пункт для отправки интерактивного сообщения в свободной форме с кнопкой вызова WhatsApp во время работы службы поддержки клиентов или в открытом окне чата .
Когда пользователь WhatsApp нажимает кнопку вызова, инициируется звонок WhatsApp на номер компании, отправившей сообщение.
В ответ на отправку этого сообщения будет отправлен стандартный веб-перехватчик состояния сообщения
ЗапросТело синтаксиспараметры
ПОЧТАУчиться <НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/подробнее о отправке интерактивных свободных форм сообщения<PHONE_NUMBER_ID>кЦелое число
Необходимый
+12784358810Запрос
тело
{"messaging_product":"WhatsApp","recipient_type":"индивидуальный","к":"14085551234","тип":"интерактивный","интерактивный":{"тип":"голосовой_вызов","тело":{"текст":Для более быстрого обслуживания вы можете позвонить нам через WhatsApp прямо сейчас!},"действие":{"имя":"голосовой_вызов","параметры":{"display_text":"Позвоните через WhatsApp","ttl_minutes":100,"полезная нагрузка":"данные полезной нагрузки"}}}}Параметры тела
| "17863476655" |
типНить
Необходимый
В данном случае вы отправляете
голосовой вызов ."голосовой_вызов"действиеНить
Необходимый
Должно быть
voice_call ."голосовой_вызов"параметрыОбъект JSON
Необязательный
Дополнительные параметры для кнопки вызова WhatsApp, отправляемые пользователю.
Содержит три значения:
display_text , ttl_minutes и payload.display_text — ( String ) OptionalТекст, отображаемый на кнопке вызова WhatsApp, отправляется пользователю.
По умолчанию установлено значение «Позвонить сейчас»
Максимальная длина: 20 символов
ttl_minutes — ( Целое число ) НеобязательноВремя жить ради кнопки призыва к действию (CTA) — уже через несколько минут.
Должно быть от 1 до 43200 (30 дней)
Значение по умолчанию — 10080 (7 дней)
полезная нагрузка — ( Строка ) НеобязательноПроизвольная строка, полезная для отслеживания.
Любое приложение, подписанное на
звонков в бизнес-аккаунте WhatsApp, может получить эту строку, поскольку она включена в подключения и завершения в cta_payload .Cloud API не обрабатывает это поле, а просто возвращает его в составе веб-хуков.
Максимальное количество символов: 512.
Функция Payload доступна только в клиенте WhatsApp, начиная с версии 2.25.27.
"параметры":{"display_text":"Позвоните через WhatsApp","ttl_minutes":100,"полезная нагрузка":"данные полезной нагрузки"}Ответ об успехе
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
Отправка этого сообщения пользователям более старых версий приложения приводит к отправке веб-перехватчика с кодом ошибки
131026.Создайте и отправьте шаблон сообщения с кнопкой вызова WhatsApp
Используйте эти конечные точки для создания и отправки шаблонного сообщения кнопки вызова WhatsApp.
После создания шаблона сообщения для кнопки вызова вы можете отправить сообщение пользователю WhatsApp, пригласив его позвонить в вашу компанию.
Используйте этот конечный пункт для создания шаблона сообщения кнопки вызова.
Запрос
синтаксис
ПОЧТА/<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений | |
Текст запроса
{"имя":"<NAME> ","категория":"<CATEGORY> ","язык":"<LANGUAGE> ",«компоненты»:[{"тип":"ТЕЛО","текст":Для более быстрого обслуживания вы можете позвонить нам через WhatsApp прямо сейчас!},{"тип":"КНОПКИ","кнопки":[{"тип":"голосовой_вызов","текст":"Позвоните прямо сейчас","ttl_minutes":1440},{"тип":"URL","текст":"Связаться со службой поддержки","url":"https://www.luckyshrub.com/support"}]}]}Параметры тела
Вы можете создавать и управлять шаблонами сообщений как через Cloud API, так и через интерфейс WhatsApp Business Manager.
При создании шаблона кнопки вызова убедитесь, что вы указали
тип как voice_call .типНить
Необходимый
В данном случае вы создаете
голосовой вызов ."голосовой_вызов"текстНить
Необязательный
По умолчанию установлено значение «Позвонить сейчас»
Максимальная длина: 20 символов
"Позвоните прямо сейчас"ttl_minutesЦелое число
Необязательный
Должно быть в диапазоне от 1440 (1 день) до 43200 (30 дней).
Это значение можно изменить при отправке сообщения.
1440Ответ об успехе
{"идентификатор":"<ID> ",«статус»:"<STATUS> ","категория":"<CATEGORY> "}Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
бизнес-аккаунта WhatsAppОшибки доступа/авторизацииПредупреждения о проверке структуры/компонентов шаблона
Отправлять
шаблон сообщения для кнопки вызова
Синтаксис запроса
ПОЧТА/<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/сообщения | |
Текст запроса
{"к":"14085551234","messaging_product":"WhatsApp","тип":"шаблон","recipient_type":"индивидуальный","шаблон":{"имя":"wa_voice_call","язык":{"код":"ен"},«компоненты»:[{"тип":"кнопка","sub_type":"голосовой_вызов","параметры":[{"тип":"ttl_minutes","ttl_minutes":100},{"тип":"полезная нагрузка","полезная нагрузка":"данные полезной нагрузки"}]}]}}Параметры запроса
| | |
| | |
Ответ об успехе
Вызов прямых ссылок
Прямые ссылки — это гиперссылки, которые направляют пользователей WhatsApp к вашему бизнесу для связи.
Процесс создания прямой ссылки для звонка аналогичен созданию прямой ссылки для чата , за исключением того, что формат прямой ссылки для звонка —
wa.me/call/Обратите внимание, что прямые ссылки не поддерживаются в настольных версиях WhatsApp.
Встраивание прямых ссылок
Вы можете использовать прямые ссылки для рекламы звонков через WhatsApp для своего бизнеса.
Используйте эти ссылки везде, где может быть полезна функция звонков, например, на вашем веб-сайте, в основном приложении или даже в качестве QR-кода для распространения.
Отправить ссылки для звонков
Вы также можете отправлять сообщения пользователям WhatsApp с помощью прямой ссылки для звонка.
Поскольку прямые ссылки можно создавать для каждого корпоративного номера телефона, вы можете использовать прямые ссылки для звонков, чтобы предложить пользователям WhatsApp связаться с другим номером телефона, на котором включена голосовая связь.
The
wa.me/call/ Этот формат легко скопировать, вставить и отправить, и для его использования не требуется создавать шаблон в Business Manager.
Отправка данных полезной нагрузки при вызове глубокой ссылки
При отправке прямой ссылки на звонок любому пользователю можно использовать
biz_payload wa.me/call/). ?biz_payload=payload ).Когда пользователь совершает звонок, используя предоставленную глубокую ссылку с параметром
biz_payload, любое приложение, подписанное на звонков в бизнес-аккаунте WhatsApp, может получить эту строку, поскольку она включена в подключения и завершения в deeplink_payload .Функция передачи данных по ссылке в звонке доступна только в клиенте WhatsApp, начиная с версии 2.25.27.