Получение разрешений на вызов пользователем | Документация для разработчиков
Получение разрешений пользователя на вызов
Обновлено: 13 ноября 2025 г
С 3 ноября 2025 года стало доступно постоянное разрешение на звонки. Пользователи могут предоставлять компании постоянное разрешение на звонки. Пользователи могут в любое время просмотреть и изменить разрешение на звонки для компании в своем профиле.
Функции, связанные с разрешением на совершение звонков, доступны только в регионах, где разрешены звонки, инициированные компанией .
Обзор
Чтобы позвонить пользователю WhatsApp, вашей компании сначала необходимо получить разрешение пользователя. Разрешение на звонок, предоставленное пользователем WhatsApp, может быть временным или постоянным.
Компания не контролирует это разрешение, поскольку оно предоставляется только пользователем и может быть отозвано только пользователем в любое время. Данные о постоянном разрешении будут храниться до тех пор, пока оно не будет отозвано.
Получить разрешение на звонок от пользователя WhatsApp можно одним из следующих способов:
Ограничения (на пару «компания + пользователь WhatsApp»)
Эти ограничения введены для защиты пользователей WhatsApp от нежелательных звонков.
При тестировании интеграции звонков WhatsApp с использованием общедоступных тестовых номеров (PTN) и тестовых учетных записей ограничения API звонков снимаются.
Основные принципы запроса разрешения на вызов
Вы можете запросить разрешение на звонок у пользователя WhatsApp, отправив запрос на разрешение одним из следующих способов:
Пользователь WhatsApp может одобрить (временно или навсегда), отклонить или просто не отвечать на запрос о разрешении на звонок.
Благодаря настройкам разрешений пользователь WhatsApp контролирует ситуацию. Даже если пользователь предоставляет разрешение на звонки, он может отозвать этот запрос в любое время. И наоборот, если пользователь отклоняет запрос на разрешение, он все равно может предоставить разрешение на звонки, пока срок действия запроса не истечет.
Запрос на разрешение вызова истекает при наступлении любого из следующих событий:
Для обеспечения оптимального пользовательского опыта при совершении деловых звонков действуют следующие ограничения:
Просмотрите поведение пользовательского интерфейса клиента при последовательных неотвеченных звонках
Свободная форма против шаблона: запрос разрешения на вызов сообщения
Сообщения с запросом разрешения на вызов подлежат оплате за отправку.
Запрос на разрешение вызова может быть отправлен пользователям одним из следующих способов:
Отправьте сообщение в свободной форме
Создайте и отправьте шаблонное сообщение
Пользовательский интерфейс клиентского приложения
Схема запроса разрешения на вызов и примеры сообщений
Разрешить звонки
Временно разрешить звонки
Шаблон сообщения
С заголовком, нижним колонтитулом и основным текстом 
Только с телом 
Без основного текста 
Типы сообщений в свободной форме
Без основного текста 
Только основной текст 
Обновление разрешений на звонки в профиле компании
Пользователи всегда могут изменить права доступа, используя новую опцию в профиле компании.
Последовательные звонки без ответа
2 последовательных неотвеченных звонка — Системное сообщение пользователю с просьбой обновить разрешения
4 последовательных неотвеченных звонка — Права доступа автоматически отозваны
Сценарии истечения срока действия запроса на разрешение вызова
Запрос на разрешение истекает через 7 дней — пользователь взаимодействует с запросом 
Запрос на разрешение истекает через 7 дней — пользователь не взаимодействует 
Предыдущий запрос на разрешение истекает немедленно — Пользователь не взаимодействует / Получен новый запрос на разрешение вызова 
Предыдущий запрос на разрешение немедленно истекает — Пользователь разрешает новый запрос / Взаимодействует с ним 
Отправить сообщение с запросом на разрешение на звонок в свободной форме
Сообщения с запросом разрешения на вызов подлежат оплате за отправку.
Используйте этот конечный пункт для отправки интерактивного сообщения в свободной форме с запросом разрешения на звонок во время работы службы поддержки клиентов В ответ на отправку этого сообщения будет отправлен стандартный веб-перехватчик статуса сообщения
Примечание: Интерактивный объект запроса разрешения на вызов не может быть отредактирован бизнес-пользователями. Настраивать можно только текст сообщения.
ЗапросТело синтаксиспараметры
ПОЧТА
<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/сообщения<PHONE_NUMBER_ID>кЦелое число
Необходимый
Он
+18274459827Запрос
тело
{"messaging_product":"WhatsApp","recipient_type":"индивидуальный","к":"<PHONE_NUMBER_ID> или<WHATSAPP_ID> ","тип":"интерактивный","интерактивный":{"тип":"call_permission_request","действие":{"имя":"call_permission_request"},"тело":{"текст":«Мы хотели бы связаться с вами, чтобы получить помощь в решении вашего вопроса по заказу № ON-12853»}}}Параметры тела
| +17863476655 |
типНить
Необходимый
В данном случае вы отправляете запрос
на разрешение вызова (call_permission_request ).“call_permission_request”действиеНить
Необходимый
Должно быть
call_permission_request .“call_permission_request”телоНить
Необязательный
Хотя это поле необязательно, настоятельно рекомендуется указывать контекст для пользователя WhatsApp при запросе разрешения на звонок.
«Позвольте нам перезвонить вам, чтобы мы могли помочь вам с вашим заказом»Ответ об успехе
{
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
номер телефонаОшибки доступа/авторизацииДостигнут лимит скоростиОтправка этого сообщения пользователям более старых версий приложения приведет к ошибке веб-перехватчика с кодом ошибки 131026Функция звонков отключенаОшибки ограничения вызовов
Создавайте и отправляйте шаблонные сообщения с запросами на разрешение вызова
Сообщения с запросом разрешения на вызов подлежат оплате за отправку.
Используйте эти конечные точки для создания и отправки шаблона сообщения запроса на разрешение вызова.
После создания шаблона сообщения для запроса разрешения ваша компания может отправить это сообщение пользователю в качестве запроса на разрешение на звонок вне окна обслуживания клиентов.
Создать шаблон сообщения
Используйте этот конечный пункт для создания шаблона сообщения запроса на разрешение вызова.
Запрос
синтаксис
ПОЧТА/<Идентификатор бизнес-аккаунта WhatsApp>/шаблоны сообщений | |
Текст запроса
{ "name": "sample_cpr_template", "language": "en", "category": "[MARKETING|UTILITY]", "components": [ { "type": "HEADER", "text": "Поддержка заказа №: {{1}}", "example": { "body_text": [ [ "ON-12345" ] ] } }, { "type": "BODY", "text": "Мы хотели бы позвонить вам, чтобы помочь с вашим запросом по заказу №: {{1}} на товар {{2}}."", "example": { "body_text": [ [ "ON-12345", "Авокадо" ] ] } }, { "type": "FOOTER", "text": "До скорой связи!" }, { "type": "call_permission_request" } ] }
Параметры тела
Создание и управление шаблонами сообщений можно осуществлять как через Cloud API, так и через интерфейс WhatsApp Business Manager.
При создании шаблона запроса на разрешение вызова убедитесь, что вы указали
тип как call_permission_request .типНить
Необходимый
В данном случае вы создаете запрос
на разрешение вызова (call_permission_request ).“call_permission_request”Ответ о статусе шаблона
{"идентификатор":"<ID> ",«статус»:"<STATUS> ","категория":"<CATEGORY> "}Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
Отправлять
шаблон сообщения
Синтаксис запроса
ПОЧТА/<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/сообщения | |
Текст запроса
{"messaging_product":"WhatsApp","recipient_type":"индивидуальный","к":"+13287759822",// Пользователь WhatsApp, который получит сообщение из шаблона"тип":"шаблон","шаблон":{"имя":"sample_cpr_template",// Название шаблона запроса разрешения на вызов"язык":{"код":"ен"},«компоненты»:[// Параметры основного текста, такие как имя клиента и номер заказа{"тип":"тело","параметры":[{"тип":"текст","текст":«Джон Смит»},{"тип":"текст","текст":"заказ № 1522"}]}]}}Получить текущее состояние разрешения на вызов
Используйте этот конечный пункт, чтобы получить состояние разрешений на вызов для корпоративного телефонного номера, к которому привязан один номер телефона пользователя WhatsApp.
Запрос
синтаксис
ПОЛУЧАТЬ /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/call_permissions?user_wa_id=<Идентификатор потребителя в WhatsApp>Параметры запроса
<PHONE_NUMBER_ID>Нить
Необходимый
+18762639988<CONSUMER_WHATSAPP_ID>Целое число
Необходимый
+13057765456Ответ
тело
{"messaging_product":"WhatsApp","разрешение":{«статус»:"временный","expiration_time":1745343479},«действия»:[{"action_name":"send_call_permission_request","can_perform_action":истинный,«пределы»:[{"период_времени":"PT24H","max_allowed":1,"current_usage":0,},{"период_времени":"P7D","max_allowed":2,"current_usage":1,}]},{"action_name":"start_call","can_perform_action":ЛОЖЬ,«пределы»:[{"период_времени":"PT24H","max_allowed":5,"current_usage":5,"limit_expiration_time":1745622600,}]}}}Параметры отклика
|
| |
|---|---|
| |
| |
| |
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
номер телефонаЕсли номер телефона потребителя недоступен для звонка, API ответит сообщением no_permission .Ошибки доступа/авторизации.Достигнут лимит запросов. Максимально 100 запросов к API в течение 1 секунды.Для корпоративного телефонного номера функция звонков отключена.
Пользователь вызывает веб-перехватчик для ответа на запрос разрешения
Этот веб-хук отправляется всякий раз, когда пользователь выбирает или обновляет свои права на совершение звонков. Это может быть ответом на запрос на разрешение звонков, отправленный компанией, или же пользователь может принять решение самостоятельно.
Значения полей веб-перехватчика изменяются в зависимости от обстоятельств принятия решения о предоставлении пользователем разрешения:
Наконец, пользователь может предоставить компании постоянное разрешение на вызов, которое отображается в
is_permanent .При истечении срока действия временного разрешения веб-хук не отправляется.
expiration_timestamp, включенное в веб-хук принятого разрешения, указывает время истечения срока действия этого разрешения. В качестве альтернативы, текущее состояние разрешения можно запросить через получения текущего состояния разрешения на вызов .Пример веб-хука
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"{timestamp}",«контекст»:{"от":"{customer_phone_number}","идентификатор":"wamid.gBGGFlaCmZ9plHrf2Mh-o"},"интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"принимать","is_permanent":ЛОЖЬ,"expiration_timestamp":"{timestamp}","response_source":"user_action"}}],...}Значения веб-перехватчика
номер_телефона_клиентаНить
Номер телефона клиента
контекст.idНить
Может принимать одно из двух значений
ответНить
Ответ пользователя WhatsApp на сообщение с запросом разрешения на звонок
Может быть
принято или отклонено.is_permanentЛогический
Указывает, является ли разрешение постоянным или нет. Для временного разрешения это значение всегда будет false.
expiration_timestampЦелое число
Время в секундах, по истечении которого истекает срок действия разрешения на звонок, если пользователь WhatsApp его одобрил
источник ответаНить
Источник этого разрешения
Возможные значения для разрешений на совершение вызовов:
user_action : Пользователь одобрил или отклонил разрешениеавтоматический : Автоматическое подтверждение разрешения в связи с тем, что звонок инициирован пользователем WhatsApp.Примеры сценариев использования веб-хуков
Пользователь WhatsApp подтверждает временное разрешение на вызов на основании сообщения с запросом на разрешение вызова
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000",«контекст»:{"от":"{customer_phone_number}","идентификатор":"wamid.gBGGFlaCmZ9plHrf2Mh-o"},"интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"принимать","is_permanent":ЛОЖЬ,"expiration_timestamp":"1768550400","response_source":"user_action"}}],...}Пользователи WhatsApp подтверждают разрешение на постоянный звонок посредством сообщения с запросом на разрешение звонка
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000",«контекст»:{"от":"{customer_phone_number}","идентификатор":"wamid.gBGGFlaCmZ9plHrf2Mh-o"},"интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"принимать","is_permanent":истинный,"response_source":"user_action"}}],...}Пользователи WhatsApp подтверждают разрешение на постоянный звонок из своего бизнес-профиля
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000","интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"принимать","is_permanent":истинный,"response_source":"user_action"}}],...}Пользователи WhatsApp отклоняют запрос на разрешение вызова после получения соответствующего сообщения
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000",«контекст»:{"от":"{customer_phone_number}","идентификатор":"wamid.gBGGFlaCmZ9plHrf2Mh-o"},"интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"отклонять","response_source":"user_action"}}],...}Когда пользователь WhatsApp звонит в компанию, ей автоматически предоставляется временное разрешение на обратный звонок
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000",«контекст»:{"от":"{customer_phone_number}","идентификатор":"wacid.gBGGF4lasdnlasdHrf2Mh-o"},"интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"принимать","is_permanent":ЛОЖЬ,"expiration_timestamp":"1768550400","response_source":"автоматический"}}],...}Разрешение на звонок автоматически отзывается, если компания совершает 4 последовательных безответных звонка пользователю WhatsApp
{..."сообщения":[{"от":"{customer_phone_number}","идентификатор":"wamid.sH0kFlaCGg0xcvZbgmg90lHrg2dL","временная метка":"1767168000","интерактивный":{"тип":"call_permission_reply","call_permission_reply":{"ответ":"отклонять","response_source":"автоматический"}}],...}