Настройка параметров вызовов | Документация для разработчиков
Настройка параметров вызовов
Обновлено: 23 марта 2026 г
Функция звонков по умолчанию отключена для корпоративного телефонного номера
Используйте
POST / /settings для включения функций Calling API для корпоративного телефонного номера.Право на совершение звонков
Для использования функций Calling API ваша компания должна установить лимит на количество инициированных компанией разговоров не менее 2000 в течение 24 часов.
При тестировании интеграции звонков WhatsApp с использованием общедоступных тестовых номеров (PTN) и тестовых учетных записей ограничения API звонков снимаются.
Обзор
Используйте эти конечные точки для просмотра и настройки параметров вызовов для API бизнес-звонков WhatsApp.
Также можно настроить протокол инициации сессии (SIP) для сигнализации вызовов вместо использования вызовов конечных точек Graph API и веб-хуков.
Настройка/обновление параметров звонков по корпоративному телефонному номеру
Используйте этот конечный пункт для обновления настроек вызовов для отдельного корпоративного телефонного номера.
Клиенты WhatsApp отображают последние настройки вызовов
После обновления настроек звонков пользователям WhatsApp может потребоваться до 7 дней, чтобы изменения вступили в силу. Большинство пользователей обновляют настройки гораздо быстрее. Вы можете принудительно обновить настройки в WhatsApp, открыв окно чата в режиме «Бизнес» и перейдя на страницу информации о чате. Независимо от поведения клиента WhatsApp, семантика настроек по-прежнему учитывается на стороне сервера.
Запрос
синтаксис
ПОЧТА /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/настройкиПараметры конечной точки
<PHONE_NUMBER_ID>Целое число
Необходимый
106540352242922Запрос
тело
{"звонок": {«статус»:"ВКЛЮЧЕНО","call_icon_visibility":"ПО УМОЛЧАНИЮ","call_icons": {"restrict_to_user_countries": ["НАС","БР"]},"call_hours": {«статус»:"ВКЛЮЧЕНО","timezone_id":"Америка/Манаус","еженедельные_часы_работы": [{"день_недели":"ПОНЕДЕЛЬНИК","open_time":"0400","close_time":"1020"},{"день_недели":"ВТОРНИК","open_time":"0108","close_time":"1020"}],"расписание_праздников": [{"дата":"2026-01-01","start_time":"0000","end_time":"2359"}]},"callback_permission_status":"ВКЛЮЧЕНО","глоток": {«статус»:"ВКЛЮЧЕНО | ВЫКЛЮЧЕНО (по умолчанию)","серверы": [{"имя хоста": SIP_SERVER_HOSTNAME,"порт": SIP_SERVER_PORT,"request_uri_user_params": {"KEY1":"VALUE1","KEY2":"VALUE2"}}]},"аудио": {"additional_codecs": ["PCMA","PCMU"]}}}
Параметры тела
| | |
| ||
| ||
| | |
| | |
| ||
|
|
Статус вызова
Если
статуса установлен в значение «ВКЛЮЧЕНО» , функции вызова для рабочего номера телефона становятся доступны. Приложения WhatsApp будут отображать значок кнопки вызова как в рабочем чате, так и в профиле рабочего чата.Если
статуса присвоено значение «ОТКЛЮЧЕНО» , функции вызова отключаются значок кнопки вызова не отображается ни в деловом чате, ни в профиле делового чата Обновление
статуса будет обновлять значок кнопки вызова в существующих деловых чатах практически в режиме реального времени, если номер телефона компании есть в контактах пользователя WhatsApp.В противном случае обновления предоставляются в режиме реального времени ограниченному числу пользователей, ведущих диалог с компанией, и становятся доступными для остальных участников диалога.
Если для номера компании включены функции Calling API, вы все равно можете выбрать, отображать ли значок кнопки вызова или нет, используя
call_icon_visibility . Примечание: отключение видимости значка кнопки вызова не отключает возможность пользователя WhatsApp совершать незапрошенные звонки в вашу компанию.Для поддерживаемых опций поведение следующее:
ПО УМОЛЧАНИЮЗначок кнопки «Вызов» будет отображаться в строке меню чата и на странице информации о компании, что позволит пользователям WhatsApp совершать незапрошенные звонки в компанию.

ОТКЛЮЧИТЬ ВСЕЗначок кнопки вызова скрыт в строке меню чата и на странице информации о компании, а все остальные точки входа вне чата также отключены. Потребители не могут совершать незапрошенные звонки в компанию.
Ваша компания по-прежнему может отправлять интерактивные сообщения или шаблонные сообщения с помощью кнопки призыва к действию (CTA) через Calling API.

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

Значки вызова
С помощью
call_icons вы можете указать страны, в которых должны отображаться эти значки."call_icons": {"restrict_to_user_countries": ["НАС","БР"]}
|
|
|
часы работы службы поддержки
часы звонковcallback_permission_statusВКЛЮЧЕНО
"call_hours": {«статус»:"ВКЛЮЧЕНО","timezone_id":"Америка/Манаус","еженедельные_часы_работы": [{"день_недели":"ПОНЕДЕЛЬНИК","open_time":"0400","close_time":"1020"},{"день_недели":"ВТОРНИК","open_time":"0108","close_time":"1020"}],"расписание_праздников": [{"дата":"2026-01-01","start_time":"0000","end_time":"2359"}]}
| | |||
| | |||
|
|
| ||
|
|
|
Аудиокодек
Opus — это аудиокодек по умолчанию для всех звонков в WhatsApp. Вы можете включить кодеки G.711 (PCMA/PCMU) для обеспечения совместимости с устаревшими телефонными системами или шлюзами PSTN.
Рекомендации и соображения
"аудио": {"additional_codecs": ["PCMA","PCMU"]}
|
| ||
|---|---|---|
| |
|
Ответ об успехе
{
"success"
: true }
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
call_hours праздника, указанная в call_hours, уже прошла. параметре call_hours указан недопустимый часовой пояс Параметр weekly_operating_hours в call_hours не может быть пустым.Формат даты в holiday_schedule для call_hours недопустим. графике работы службы поддержки (call_hours) не допускается более 2 записей.Перекрывающиеся графики в call_hours не допускаются.
Получить настройки звонков по номеру телефона
Используйте эту конечную точку для проверки конфигурации настроек функции вызова API.
Этот конечный пункт может возвращать информацию о других настройках функций Cloud API.
Запрос
синтаксис
ПОЛУЧАТЬ /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/настройкиПараметры конечной точки
<PHONE_NUMBER_ID>Целое число
Необходимый
106540352242922Требуются разрешения приложения
whatsapp_business_management : Для использования API конечными бизнес-клиентами требуется расширенный доступ.Ответ
тело
{"звонок": {«статус»:"ВКЛЮЧЕНО","call_icon_visibility":"ПО УМОЛЧАНИЮ","callback_permission_status":"ВКЛЮЧЕНО","call_hours": {«статус»:"ВКЛЮЧЕНО","timezone_id":«[УДАЛЕНО]»,"еженедельные_часы_работы": [{"день_недели":"ПОНЕДЕЛЬНИК","open_time":"0400","close_time":"1020"},{"день_недели":"ВТОРНИК","open_time":"0108","close_time":"1020"}],"расписание_праздников": [{"дата":"2026-01-01","start_time":"0000","end_time":"2359"}]},"глоток": {«статус»:"ВКЛЮЧЕНО","серверы": [{"имя хоста":«[УДАЛЕНО]»,"sip_user_password":«[УДАЛЕНО]»}]},"аудио": {"additional_codecs": ["PCMA","PCMU"]}},<Other non-звонокНастройка функций...>}
В ответ необходимо включить пароль пользователя SIP
ПОЛУЧАТЬ /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/настройки?include_sip_credentials=истинный{"звонок": {... // другие настройки API для вызова"глоток": {«статус»:"ВКЛЮЧЕНО","серверы": [{"имя хоста":"sip.example.com","sip_user_password":"{SIP_USER_PASSWOR}"}]}}}
Подробности ответа
ПОЛУЧАТЬ /<PHONE_NUMBER_ID> /настройкиОтвет с ограничениями на звонки
{"звонок": {... // другие настройки API для вызова"ограничения": {"restrictions_list": [{"тип":"[RESTRICTED_BUSINESS_INITIATED_CALLING|RESTRICTED[ЗВОНОК, ИНИЦИИРОВАННЫЙ ПОЛЬЗОВАТЕЛЕМ],"причина":«Возможность совершения звонков по инициативе пользователя в рамках бизнеса былаТелефонный номер временно отключен из-зак большому количеству негативных отзывов от пользователей.","срок действия":1754072386}]}}}
| |
Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
Настройки звонков в WhatsApp Manager
Вы также можете управлять настройками звонков через WhatsApp Manager .
Чтобы получить доступ к элементам управления вызовами в WhatsApp Manager:

Настройка и использование сигнализации вызовов через протокол инициации сеанса (SIP)
Протокол инициации сеанса (SIP) — это протокол сигнализации, используемый для инициирования, поддержания, изменения и завершения сеансов связи в реальном времени между двумя или более конечными точками. Вы можете отправлять и получать сигналы вызова, используя SIP вместо конечных точек Graph API.
Настройки
обновить веб-хуки
account_settings_updateШаги для начала работы
account_settings_updatewhatsapp_business_managementПолезная нагрузка веб-перехватчика
{"объект":"whatsapp_business_account","вход":[{"идентификатор":"whatsapp-business-account-id","изменения":[{"ценить":{"messaging_product":"WhatsApp","временная метка":"1671644824","тип":"[настройки_номера_телефона]","настройки_номера_телефона":{"идентификатор_номера_телефона":"идентификатор-номер-телефона","звонок":{«статус»:"ВКЛЮЧЕНО","call_icon_visibility":"ПО УМОЛЧАНИЮ","callback_permission_status":"ВКЛЮЧЕНО","call_hours":{«статус»:"ВКЛЮЧЕНО","timezone_id":«[УДАЛЕНО]»,"еженедельные_часы_работы":[{"день_недели":"ПОНЕДЕЛЬНИК","open_time":"0400","close_time":"1020"},{"день_недели":"ВТОРНИК","open_time":"0108","close_time":"1020"}],"расписание_праздников":[{"дата":"2026-01-01","start_time":"0000","end_time":"2359"}]},"глоток":{«статус»:"ВКЛЮЧЕНО","серверы":[{"имя хоста":«[УДАЛЕНО]»,"порт": SIP_SERVER_PORT
}]}}}},"поле":"account_settings_update"}]}]}Значения веб-перехватчика
| |
| |
| |
| |
| |
| |
Ограничения на звонки для обратной связи с пользователями
Если ваши звонки получают много негативных отзывов от пользователей, таких как блокировки и жалобы, то функции совершения звонков по инициативе компании, звонков по инициативе пользователя или обе функции одновременно на вашем телефонном номере могут быть ограничены.
Раннее предупреждение
Вы получите уведомление о приближении блокировки рабочего телефонного номера в качестве предупреждения. Уведомления о приближении блокировки будут передаваться по указанным ниже каналам
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Вебхук
account_update{"объект":"whatsapp_business_account","вход": [{"идентификатор":"0","время":1623862418,"изменения": [{"поле":"account_update","ценить": {"номер телефона":"PN","событие":"НАРУШЕНИЕ УЧЕТНОЙ ЗАПИСИ","violation_info": {"violation_type":«Низкое качество звонков, инициированных бизнесом | Низкое количество пользователей»[КАЧЕСТВО ИНИЦИИРОВАННОГО ЗВОНКА]",}}}]}]}
Функция паузы при вызове
Как только количество негативных отзывов пользователей достигнет определенного порога, Cloud API автоматически ограничит возможность совершения звонков на ваш номер телефона на 7 дней. В течение этого периода номер телефона, на который будет произведен звонок, будет недоступен
После блокировки вашего номера телефона уведомления будут отправляться по указанным ниже каналам.
Примечание: Любые разрешения на совершение звонков, одобренные или отклоненные пользователями во время паузы, остаются в силе.
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Вебхук
account_update{"объект":"whatsapp_business_account","вход": [{"идентификатор":"0","время":1641848059,"изменения": [{"поле":"account_update","ценить": {"номер телефона":"PN","событие":"ОГРАНИЧЕНИЕ_УЧЕТНОЙ_УЧЕТНОЙ ЗАПИСИ","restriction_info": [{"restriction_type":"ОГРАНИЧЕННЫЕ ДЕЛОВЫЕ ЗВОНКИ","срок действия":1641848057}]}}]}]}
Приостановка функции вызова, инициированного пользователем
Как только количество негативных отзывов пользователей достигнет определенного порога, Cloud API автоматически ограничит возможность совершения звонков с вашего номера телефона на 7 дней. В период паузы звонки с этого номера будут невозможны
После блокировки вашего номера телефона уведомления будут отправляться по указанным ниже каналам.
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Вебхук
account_update{"объект":"whatsapp_business_account","вход": [{"идентификатор":"0","время":1641848059,"изменения": [{"поле":"account_update","ценить": {"номер телефона":"PN","событие":"ОГРАНИЧЕНИЕ_УЧЕТНОЙ_УЧЕТНОЙ ЗАПИСИ","restriction_info": [{"restriction_type":"ЗВОНОК, ИНИЦИИРОВАННЫЙ ОГРАНИЧЕННЫМ ПОЛЬЗОВАТЕЛЕМ","срок действия":1641848057}]}}]}]}
Ограничения на звонки из-за низкого процента ответов на звонки
Если на вашем рабочем телефонном номере включена функция звонков, вы должны отвечать на звонки, которые вам поступают от пользователей.
Если значительное количество звонков на ваш рабочий телефонный номер с возможностью совершения звонков останется без ответа, вы получите уведомление и вам будет предложено внести изменения.
Что произойдет, если вы не будете отвечать на звонки?
Как смягчить ситуацию
Если вы получили предупреждение
Вебхуки
Предупреждение веб-перехватчика
[{"объект":"whatsapp_business_account","вход": [{"идентификатор":"0","время":1641848059,"изменения": [{"поле":"account_update","ценить": {"номер телефона":"16505552771","событие":"НАРУШЕНИЕ УЧЕТНОЙ ЗАПИСИ","violation_info": {"violation_type":"Низкий процент ответов на звонки, инициированные пользователем",«восстановление»:«Пожалуйста, выявите и устраните причину ошибки user-ini»На звонки, поступающие по ошибке, никто не отвечает, и убедитесь, что..Предприятие располагает достаточными ресурсами для выполнения ожидаемых задачОбъём звонков."}}}]}]}]
Веб-перехватчик принудительного исполнения
[{"объект":"whatsapp_business_account","вход": [{"идентификатор":"0","время":1641848059,"изменения": [{"поле":"account_update","ценить": {"номер телефона":"16505552771","событие":"ОГРАНИЧЕНИЕ_УЧЕТНОЙ_УЧЕТНОЙ ЗАПИСИ","restriction_info": [{"restriction_type":"RESTRICTED_USER_INITIATED_CALLING_CALL_BUTTON_HIDЛОДКА,«восстановление»:Кнопка вызова скрыта из-за низкой частоты ответовтарифы. Пожалуйста, определите и устраните причину вашей проблемыЗвонки, инициированные службой, не принимаются. Далее, диРасположите кнопки вызова, используя команду `y`наш партнер или перейдите в WhatsApp Manager > АккаунтИнструменты > Номера телефонов > Выберите номер телефона > Calls > включить отображение кнопок вызова}]}}]}]}]