Настройка параметров вызовов | Документация для разработчиков
Настройка параметров вызовов
Обновлено: 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>Целое число |
Необходимый
Идентификатор номера корпоративного телефона, для которого вы обновляете настройки API вызовов. |
106540352242922 |
Статус вызова
Если
статуса установлен в значение «ВКЛЮЧЕНО» , функции вызова для рабочего номера телефона становятся доступны. Приложения WhatsApp будут отображать значок кнопки вызова как в рабочем чате, так и в профиле рабочего чата.Если
статуса присвоено значение «ОТКЛЮЧЕНО» , функции вызова отключаются значок кнопки вызова не отображается ни в деловом чате, ни в профиле делового чата Обновление
статуса будет обновлять значок кнопки вызова в существующих деловых чатах практически в режиме реального времени, если номер телефона компании есть в контактах пользователя WhatsApp.В противном случае обновления предоставляются в режиме реального времени ограниченному числу пользователей, ведущих диалог с компанией, и становятся доступными для остальных участников диалога.
Если для номера компании включены функции Calling API, вы все равно можете выбрать, отображать ли значок кнопки вызова или нет, используя
call_icon_visibility . Примечание: отключение видимости значка кнопки вызова не отключает возможность пользователя WhatsApp совершать незапрошенные звонки в вашу компанию.Для поддерживаемых опций поведение следующее:
ПО УМОЛЧАНИЮЗначок кнопки «Вызов» будет отображаться в строке меню чата и на странице информации о компании, что позволит пользователям WhatsApp совершать незапрошенные звонки в компанию.
ОТКЛЮЧИТЬ ВСЕЗначок кнопки вызова скрыт в строке меню чата и на странице информации о компании, а все остальные точки входа вне чата также отключены. Потребители не могут совершать незапрошенные звонки в компанию.
Ваша компания по-прежнему может отправлять интерактивные сообщения или шаблонные сообщения с помощью кнопки призыва к действию (CTA) через Calling API.
Разрешения на обратный вызов
Для звонка пользователю WhatsApp требуется явное разрешение от пользователя. Один из способов получить разрешение на звонок — запросить его у пользователя WhatsApp, когда он звонит в вашу компанию.
Вы можете настроить интерфейс разрешений на звонки таким образом, чтобы он автоматически отображался в клиентском приложении WhatsApp при звонке на номер вашей компании. Пользователь может изменить выбранные разрешения в любое время.
Значки вызова
С помощью
call_icons вы можете указать страны, в которых должны отображаться эти значки.Аудиокодек
Opus — это аудиокодек по умолчанию для всех звонков в WhatsApp. Вы можете включить кодеки G.711 (PCMA/PCMU) для обеспечения совместимости с устаревшими телефонными системами или шлюзами PSTN.
Рекомендации и соображения
Ответ об успехе
{
"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>Целое число |
Необходимый
Идентификатор номера телефона компании, для которого вы получаете настройки API вызовов. |
106540352242922 |
Требуются разрешения приложения
whatsapp_business_management : Для использования API конечными бизнес-клиентами требуется расширенный доступ.Ответ с ошибкой
Возможные ошибки, которые могут возникнуть:
Настройки звонков в WhatsApp Manager
Вы также можете управлять настройками звонков через WhatsApp Manager .
Чтобы получить доступ к элементам управления вызовами в WhatsApp Manager:
Настройка и использование сигнализации вызовов через протокол инициации сеанса (SIP)
Протокол инициации сеанса (SIP) — это протокол сигнализации, используемый для инициирования, поддержания, изменения и завершения сеансов связи в реальном времени между двумя или более конечными точками. Вы можете отправлять и получать сигналы вызова, используя SIP вместо конечных точек Graph API.
Ограничения на звонки для обратной связи с пользователями
Если ваши звонки получают много негативных отзывов от пользователей, таких как блокировки и жалобы, то функции совершения звонков по инициативе компании, звонков по инициативе пользователя или обе функции одновременно на вашем телефонном номере могут быть ограничены.
Раннее предупреждение
Вы получите уведомление о приближении блокировки рабочего телефонного номера в качестве предупреждения. Уведомления о приближении блокировки будут передаваться по указанным ниже каналам
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Функция паузы при вызове
Как только количество негативных отзывов пользователей достигнет определенного порога, Cloud API автоматически ограничит возможность совершения звонков на ваш номер телефона на 7 дней. В течение этого периода номер телефона, на который будет произведен звонок, будет недоступен
После блокировки вашего номера телефона уведомления будут отправляться по указанным ниже каналам.
Примечание: Любые разрешения на совершение звонков, одобренные или отклоненные пользователями во время паузы, остаются в силе.
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Приостановка функции вызова, инициированного пользователем
Как только количество негативных отзывов пользователей достигнет определенного порога, Cloud API автоматически ограничит возможность совершения звонков с вашего номера телефона на 7 дней. В период паузы звонки с этого номера будут невозможны
После блокировки вашего номера телефона уведомления будут отправляться по указанным ниже каналам.
Электронная почта
Уведомления о нарушениях рассылаются на электронные адреса всех пользователей и администраторов, связанных с компанией. Если вы не получили уведомление, проверьте, какой адрес электронной почты вы указали в качестве контактного для вашего приложения, и убедитесь, что он активен, может получать новые письма и не помечает их как спам.
Ограничения на звонки из-за низкого процента ответов на звонки
Если на вашем рабочем телефонном номере включена функция звонков, вы должны отвечать на звонки, которые вам поступают от пользователей.
Если значительное количество звонков на ваш рабочий телефонный номер с возможностью совершения звонков останется без ответа, вы получите уведомление и вам будет предложено внести изменения.