Отправка сообщений с кнопкой вызова WhatsApp и прямых ссылок | Документация для разработчиков
Отправляйте сообщения с кнопкой вызова WhatsApp и прямые ссылки
Обновлено: 25 февраля 2026 г
Обзор
После внедрения функций Cloud API Calling вы сможете повысить осведомленность своих клиентов двумя основными способами:
Отправьте интерактивное сообщение с помощью кнопки вызова WhatsApp
Используйте этот конечный пункт для отправки интерактивного сообщения в свободной форме с кнопкой вызова WhatsApp во время работы службы поддержки клиентов или в открытом окне чата .
Когда пользователь WhatsApp нажимает кнопку вызова, инициируется звонок WhatsApp на номер компании, отправившей сообщение.
В ответ на отправку этого сообщения будет отправлен стандартный веб-перехватчик состояния сообщения
Параметры тела
| Параметр | Описание | Пример значения |
|---|---|---|
кЦелое число |
Необходимый
Номер телефона пользователя WhatsApp, которому вы отправляете сообщение. |
"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. |
|
Ответ об успехе
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
Отправка этого сообщения пользователям более старых версий приложения приводит к отправке веб-перехватчика с кодом ошибки
131026.Создайте и отправьте шаблон сообщения с кнопкой вызова WhatsApp
Используйте эти конечные точки для создания и отправки шаблонного сообщения кнопки вызова WhatsApp.
После создания шаблона сообщения для кнопки вызова вы можете отправить сообщение пользователю WhatsApp, пригласив его позвонить в вашу компанию.
Используйте этот конечный пункт для создания шаблона сообщения кнопки вызова.
Параметры тела
Вы можете создавать и управлять шаблонами сообщений как через Cloud API, так и через интерфейс WhatsApp Business Manager.
При создании шаблона кнопки вызова убедитесь, что вы указали
тип как voice_call .| Параметр | Описание | Пример значения |
|---|---|---|
типНить |
Необходимый
Тип создаваемого вами шаблонного сообщения. В данном случае вы создаете голосовой вызов . |
"голосовой_вызов" |
текстНить |
Необязательный
Текст, отображаемый на кнопке вызова WhatsApp, отправляется пользователю. По умолчанию установлено значение «Позвонить сейчас»
Максимальная длина: 20 символов |
"Позвоните прямо сейчас" |
ttl_minutesЦелое число |
Необязательный
Пора начать жить ради кнопки призыва к действию (CTA) уже через несколько минут. Должно быть в диапазоне от 1440 (1 день) до 43200 (30 дней).
Это значение можно изменить при отправке сообщения. |
1440 |
Ответ об успехе
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
бизнес-аккаунта WhatsAppОшибки доступа/авторизацииПредупреждения о проверке структуры/компонентов шаблона
Вызов прямых ссылок
Прямые ссылки — это гиперссылки, которые направляют пользователей 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.
Комментарии отсутствуют
Комментарии отсутствуют