Получение разрешений на вызов пользователем | Документация для разработчиков

Получение разрешений пользователя на вызов

Обновлено: 13 ноября 2025 г

С 3 ноября 2025 года стало доступно постоянное разрешение на звонки. Пользователи могут предоставлять компании постоянное разрешение на звонки. Пользователи могут в любое время просмотреть и изменить разрешение на звонки для компании в своем профиле.

Функции, связанные с разрешением на совершение звонков, доступны только в регионах, где разрешены звонки, инициированные компанией .

Обзор

Чтобы позвонить пользователю WhatsApp, вашей компании сначала необходимо получить разрешение пользователя. Разрешение на звонок, предоставленное пользователем WhatsApp, может быть временным или постоянным.

Компания не контролирует это разрешение, поскольку оно предоставляется только пользователем и может быть отозвано только пользователем в любое время. Данные о постоянном разрешении будут храниться до тех пор, пока оно не будет отозвано.

Получить разрешение на звонок от пользователя WhatsApp можно одним из следующих способов:

Отправить пользователю запрос на разрешение на звонок — отправить пользователю сообщение в свободной форме или по шаблону с запросом на разрешение на звонок. Пользователь может выбрать временный или постоянный режим.Разрешение на обратный звонок предоставляется пользователем WhatsApp — пользователь WhatsApp автоматически предоставляет временное разрешение на звонок, совершив звонок в компанию. Функция обратного звонка должна быть включена для номера телефона компании.Пользователь WhatsApp предоставляет компании разрешение на звонки через свой бизнес-профиль — пользователь WhatsApp предоставляет компании разрешение на звонки через свой бизнес-профиль.

Ограничения (на пару «компания + пользователь WhatsApp»)

Временные разрешения выдаются на 7 календарных дней (168 часов).

Рассчитывается как количество секунд в сутки, умноженное на 7, с момента подтверждения пользователем.Постоянные разрешения не истекают, но к ним применяется тот же лимит подключенных звонков.Ваша компания может совершать максимум 100 подключенных звонков каждые 24 часа.Эти ограничения распространяются на рабочий телефонный номер.

Эти ограничения введены для защиты пользователей WhatsApp от нежелательных звонков.

При тестировании интеграции звонков WhatsApp с использованием общедоступных тестовых номеров (PTN) и тестовых учетных записей ограничения API звонков снимаются.

Узнайте больше о тестировании интеграции API звонков WhatsApp

Основные принципы запроса разрешения на вызов

Вы можете запросить разрешение на звонок у пользователя WhatsApp, отправив запрос на разрешение одним из следующих способов:

Интерактивное сообщение в свободной формеШаблон сообщения

Пользователь WhatsApp может одобрить (временно или навсегда), отклонить или просто не отвечать на запрос о разрешении на звонок.

Благодаря настройкам разрешений пользователь WhatsApp контролирует ситуацию. Даже если пользователь предоставляет разрешение на звонки, он может отозвать этот запрос в любое время. И наоборот, если пользователь отклоняет запрос на разрешение, он все равно может предоставить разрешение на звонки, пока срок действия запроса не истечет.

Запрос на разрешение вызова истекает при наступлении любого из следующих событий:

Пользователь WhatsApp взаимодействует с последующим запросом на разрешение на новый звонок от компаниичерез 7 дней после того, как потребитель принял или отклонил разрешениеЕсли потребитель не ответит на запрос, то в течение 7 дней после предоставления разрешения

Просмотрите поведение пользовательского интерфейса клиента при запросах на получение разрешений с истекшим сроком действия

Для обеспечения оптимального пользовательского опыта при совершении деловых звонков действуют следующие ограничения:

При отправке сообщения с запросом разрешения на вызов

Максимум 1 запрос на разрешение в течение 24 часовМаксимум 2 запроса на разрешение в течение 7 дней.

Эти ограничения сбрасываются при каждом установленном звонке (инициированном компанией/пользователем) между компанией и пользователем WhatsApp.Эти ограничения распространяются на запросы на предоставление разрешений, отправленные как в свободной форме, так и в виде шаблонных сообщений.Когда звонки, инициированные компанией, остаются без ответа или отклоняются

Два последовательных неотвеченных звонка приводят к появлению системного сообщения о необходимости пересмотреть утвержденное разрешениеЧетыре последовательных неотвеченных звонка приводят к автоматическому аннулированию утвержденного разрешения. Пользователь может повторно изменить его при желании.

Просмотрите поведение пользовательского интерфейса клиента при последовательных неотвеченных звонках

Свободная форма против шаблона: запрос разрешения на вызов сообщения

Сообщения с запросом разрешения на вызов подлежат оплате за отправку.

Запрос на разрешение вызова может быть отправлен пользователям одним из следующих способов:

Отправьте сообщение в свободной форме

Находясь в окне обслуживания клиента и общаясь с пользователем WhatsApp, вы можете отправить сообщение в свободной форме с запросом на разрешение на звонок.Хотя текстовое содержимое сообщения необязательно, его следует отправлять для создания контекста взаимодействия с пользователем. В случае запросов на разрешение в свободной форме разделы заголовка и нижнего колонтитула не поддерживаются.Поскольку окно службы поддержки клиентов открыто, нет необходимости создавать окно для диалога.

Создайте и отправьте шаблонное сообщение

Отправка шаблонного сообщения позволяет инициировать диалог с пользователем, запросив разрешение на совершение звонка.Контекст (то есть, текст сообщения) необходим при отправке шаблонного сообщения с запросом на разрешение вызова.С помощью шаблонов сообщений вы можете дополнительно настроить запрос на разрешение, добавив заголовок и нижний колонтитул сообщения.

Критерии отправки сообщений с запросом разрешения на вызов

Пользовательский интерфейс клиентского приложения

Схема запроса разрешения на вызов и примеры сообщений

Разрешить звонки

Временно разрешить звонки

Шаблон сообщения

С заголовком, нижним колонтитулом и основным текстом

Только с телом Сообщение в свободной форме, содержащее только текст

Без основного текста Сообщение в свободной форме, без основного текста

Типы сообщений в свободной форме

Без основного текста Шаблон сообщения без основного текста

Только основной текст

Обновление разрешений на звонки в профиле компании

Пользователи всегда могут изменить права доступа, используя новую опцию в профиле компании.

Обновите права доступа к звонкам в профиле компании

Последовательные звонки без ответа

Последовательные звонки без ответа
2 последовательных неотвеченных звонка — Системное сообщение пользователю с просьбой обновить разрешения
4 последовательных неотвеченных звонка — Права доступа автоматически отозваны

Сценарии истечения срока действия запроса на разрешение вызова

Запрос на разрешение истекает через 7 дней — пользователь взаимодействует с запросом

Запрос на разрешение истекает через 7 дней — пользователь не взаимодействует

Предыдущий запрос на разрешение истекает немедленно — Пользователь не взаимодействует / Получен новый запрос на разрешение вызова

Предыдущий запрос на разрешение немедленно истекает — Пользователь разрешает новый запрос / Взаимодействует с ним

Отправить сообщение с запросом на разрешение на звонок в свободной форме

Сообщения с запросом разрешения на вызов подлежат оплате за отправку.

Используйте этот конечный пункт для отправки интерактивного сообщения в свободной форме с запросом разрешения на звонок во время работы службы поддержки клиентов В ответ на отправку этого сообщения будет отправлен стандартный веб-перехватчик статуса сообщения

Примечание: Интерактивный объект запроса разрешения на вызов не может быть отредактирован бизнес-пользователями. Настраивать можно только текст сообщения.

Посмотрите, как это сообщение отображается в клиенте WhatsApp

Параметры тела

Параметр	Описание	Пример значения
`к` Целое число	Необходимый Номер телефона пользователя WhatsApp, которому вы отправляете сообщение Узнайте больше о форматировании телефонных номеров в Cloud API	`+17863476655`
`тип` Нить	Необходимый Тип интерактивного сообщения, которое вы отправляете. В данном случае вы отправляете запрос `на разрешение вызова (call_permission_request` ). Узнайте больше об интерактивных сообщениях	`“call_permission_request”`
`действие` Нить	Необходимый Действие вашего интерактивного сообщения. Должно быть `call_permission_request` .	`“call_permission_request”`
`тело` Нить	Необязательный Основная часть вашего сообщения. Хотя это поле необязательно, настоятельно рекомендуется указывать контекст для пользователя WhatsApp при запросе разрешения на звонок.	`«Позвольте нам перезвонить вам, чтобы мы могли помочь вам с вашим заказом»`

Ответ об успехе

Узнайте больше об успешности ответов на сообщения

Ответ с ошибкой

Возможные ошибки, которые могут возникнуть:

Неверный номер телефонаОшибки доступа/авторизацииДостигнут лимит скоростиОтправка этого сообщения пользователям более старых версий приложения приведет к ошибке веб-перехватчика с кодом ошибки 131026Функция звонков отключенаОшибки ограничения вызовов

Общие коды ошибок Cloud API можно посмотреть здесь

Создавайте и отправляйте шаблонные сообщения с запросами на разрешение вызова

Сообщения с запросом разрешения на вызов подлежат оплате за отправку.

Используйте эти конечные точки для создания и отправки шаблона сообщения запроса на разрешение вызова.

После создания шаблона сообщения для запроса разрешения ваша компания может отправить это сообщение пользователю в качестве запроса на разрешение на звонок вне окна обслуживания клиентов.

Узнайте больше о создании и управлении шаблонами сообщений

Создать шаблон сообщения

Используйте этот конечный пункт для создания шаблона сообщения запроса на разрешение вызова.

Параметры тела

Создание и управление шаблонами сообщений можно осуществлять как через Cloud API, так и через интерфейс WhatsApp Business Manager.

При создании шаблона запроса на разрешение вызова убедитесь, что вы указали тип как call_permission_request .

Узнайте больше о создании и управлении шаблонами сообщений

Параметр	Описание	Пример значения
`тип` Нить	Необходимый Тип создаваемого вами шаблонного сообщения. В данном случае вы создаете запрос `на разрешение вызова (call_permission_request` ).	`“call_permission_request”`

Ответ о статусе шаблона

Узнайте больше об ответе на запрос о статусе шаблона

Ответ с ошибкой

Возможные ошибки, которые могут возникнуть:

Неверный идентификатор WABAОшибки доступа/авторизацииПредупреждения о проверке структуры/компонентов шаблона

Общие коды ошибок Cloud API можно посмотреть здесь

Получить текущее состояние разрешения на вызов

Используйте этот конечный пункт, чтобы получить состояние разрешений на вызов для корпоративного телефонного номера, к которому привязан один номер телефона пользователя WhatsApp.

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

Параметр	Описание	Пример значения
`<PHONE_NUMBER_ID>` Нить	Необходимый Номер телефона компании, для которого вы запрашиваете разрешения. Узнайте больше о форматировании телефонных номеров в Cloud API	`+18762639988`
`<CONSUMER_WHATSAPP_ID>` Целое число	Необходимый Номер телефона пользователя WhatsApp, у которого вы запрашиваете разрешение на совершение звонков. Узнайте больше о форматировании телефонных номеров в Cloud API	`+13057765456`

Параметры отклика

Ответ с ошибкой

Возможные ошибки, которые могут возникнуть:

Неверный номер телефонаЕсли номер телефона потребителя недоступен для звонка, API ответит сообщением no_permission .Ошибки доступа/авторизации.Достигнут лимит запросов. Максимально 100 запросов к API в течение 1 секунды.Для корпоративного телефонного номера функция звонков отключена.

Для получения дополнительной информации ознакомьтесь с кодами ошибок и рекомендациями по устранению неполадок при вызове API

Общие коды ошибок Cloud API можно посмотреть здесь

Пользователь вызывает веб-перехватчик для ответа на запрос разрешения

Этот веб-хук отправляется всякий раз, когда пользователь выбирает или обновляет свои права на совершение звонков. Это может быть ответом на запрос на разрешение звонков, отправленный компанией, или же пользователь может принять решение самостоятельно.

Значения полей веб-перехватчика изменяются в зависимости от обстоятельств принятия решения о предоставлении пользователем разрешения:

Пользователь принимает или отклоняет запросПользователь подтверждает разрешение, ответив на запрос или позвонив в компаниюРазрешение пользователя представляет собой разрешение на автоматический обратный вызов в ответ на инициированный пользователем вызовРазрешение пользователя автоматически отзывается в ответ на 4 последовательных неотвеченных звонка, инициированных компанией

Наконец, пользователь может предоставить компании постоянное разрешение на вызов, которое отображается в is_permanent .

При истечении срока действия временного разрешения веб-хук не отправляется. expiration_timestamp, включенное в веб-хук принятого разрешения, указывает время истечения срока действия этого разрешения. В качестве альтернативы, текущее состояние разрешения можно запросить через получения текущего состояния разрешения на вызов .

Пример веб-хука

Значения веб-перехватчика

Заполнитель	Описание
`номер_телефона_клиента` Нить	Номер телефона клиента
`контекст.id` Нить	Может принимать одно из двух значений Идентификатор сообщения запроса на разрешение, отправленного компанией на номер клиента. Показывает, когда пользователь принимает решение о предоставлении разрешения в ответ на запрос на разрешение вызова.Идентификатор пропущенного звонка, совершенного компанией на номер клиента. Отображается, когда в настройках включено разрешение на обратный звонок и пользователь звонит в компанию.
`ответ` Нить	Ответ пользователя WhatsApp на сообщение с запросом разрешения на звонок Может быть `принято` или `отклонено.`
`is_permanent` Логический	Указывает, является ли разрешение постоянным или нет. Для временного разрешения это значение всегда будет false.
`expiration_timestamp` Целое число	Время в секундах, по истечении которого истекает срок действия разрешения на звонок, если пользователь WhatsApp его одобрил
`источник ответа` Нить	Источник этого разрешения Возможные значения для разрешений на совершение вызовов: `user_action` : Пользователь одобрил или отклонил разрешение`автоматический` : Автоматическое подтверждение разрешения в связи с тем, что звонок инициирован пользователем WhatsApp.

Примеры сценариев использования веб-хуков

Сценарий	Пример веб-хука
Пользователь WhatsApp подтверждает временное разрешение на вызов на основании сообщения с запросом на разрешение вызова
Пользователи WhatsApp подтверждают разрешение на постоянный звонок посредством сообщения с запросом на разрешение звонка
Пользователи WhatsApp подтверждают разрешение на постоянный звонок из своего бизнес-профиля
Пользователи WhatsApp отклоняют запрос на разрешение вызова после получения соответствующего сообщения
Когда пользователь WhatsApp звонит в компанию, ей автоматически предоставляется временное разрешение на обратный звонок
Разрешение на звонок автоматически отзывается, если компания совершает 4 последовательных безответных звонка пользователю WhatsApp