Вызов облачных API | Документация для разработчиков
Вызов облачного API
Обновлено: 10 марта 2026 г
Обзор
API для бизнес-звонков WhatsApp позволяет инициировать и принимать звонки от пользователей WhatsApp с использованием протокола VoIP (Voice over Internet Protocol).
Ценностное предложение (вкратце)
WhatsApp Business Calling: надежная, многофункциональная, многофункциональная глобальная связь.
| Ценить | Описание |
|---|---|
Единая коммуникация | Один номер. Сообщение и звонок. По всему миру. |
Брендинг и доверие | Брендинг, который прочно закрепился на рынке, вызывает доверие и является глобальным. |
Взаимоотношения с клиентами | Усильте привязанность. Углубите личный контакт. |
Продажи и поддержка | Объедините маркетинг и поддержку. Раскройте потенциал дополнительных продаж. |
Богатый функционал | Видеосвязь , демонстрация экрана и полная настройка параметров звонка. |
Переадресация звонков | Звонки через WhatsApp. Повышение коэффициента переадресации звонков. |
Удобство для клиентов | Бесплатный универсальный доступ для ваших клиентов. |
Ведение учета | Одна нить повествования. Централизованная, долгосрочная запись. |
Преимущества для конечных пользователей
| Ценить | Описание |
|---|---|
Универсальный доступ | Простое, бесплатное и привычное глобальное соединение. |
Повышенная безопасность | Более безопасная платформа благодаря встроенной системе доверия/проверки. |
Централизованная история | Единая нить для всей истории голосовых и текстовых сообщений. |
Интегрированная голосовая почта | Голосовое сообщение*, воспроизводимое в контексте чата. |
Примечание: * Функция запланирована или находится в разработке. Для получения более подробной информации обратитесь к своему партнеру или в компанию Meta
Ценностное предложение (подробно)
API для бизнес-звонков WhatsApp позволяет компаниям интегрировать голосовые и видеозвонки* непосредственно в свою стратегию взаимодействия с клиентами, предлагая надежный, унифицированный и многофункциональный канал связи.
| Особенность | Выгода для вашего бизнеса |
|---|---|
Единая коммуникация | Один номер. Вся коммуникация. Многоканальный. Используйте один подтвержденный номер WhatsApp для всех сообщений и звонков (входящих и исходящих), что обеспечивает бесперебойный переход между чатом и звонком, и даже позволяет общаться во время разговора. |
Брендинг и доверие | Брендинг, который заложен изначально, внушает доверие и является глобальным. WhatsApp имеет встроенную поддержку фирменной идентичности с обеспечением безопасности и верификации, что обеспечивает мгновенное доверие во всем мире и устраняет необходимость в региональных сторонних поставщиках услуг доверия. |
Взаимоотношения с клиентами | Увеличьте лояльность клиентов. Укрепите личный контакт. Единая точка контакта для входящей и исходящей коммуникации усиливает личный контакт, повышает лояльность клиентов и обеспечивает долгосрочную приверженность компании. |
Продажи и поддержка | Объедините маркетинг и поддержку. Раскройте потенциал дополнительных продаж. Централизуйте управление потенциальными клиентами, объединив каналы поддержки и маркетинга, что оптимизирует операции и открывает возможности для дополнительных и перекрестных продаж продукта. |
Богатый функционал | Больше, чем просто звонок. Видеозвонки , демонстрация экрана и расширенные возможности управления. Помимо голосовой связи, компании могут взаимодействовать с клиентами с помощью видеозвонков и демонстрации экрана для более качественной и детальной поддержки и обслуживания. Компании также могут контролировать процесс звонков, настраивая время звонков, управляя видимостью значков вызовов, отправляя кнопки вызова с истечением срока действия и используя диплинки для звонков. |
Переадресация звонков | Звонки через WhatsApp. Повышение коэффициента переадресации звонков. Переведя звонки в WhatsApp, компании могут беспрепятственно направлять клиентов к более удобному общению в чате, используя интерактивные шаблоны сообщений для повышения коэффициента переадресации звонков и снижения затрат на поддержку только по телефону. |
Удобство для клиентов | Всегда бесплатно, всегда универсальный доступ. Предложите своим клиентам удобный и доступный по всему миру способ связи, который будет для них бесплатным. |
Ведение учета | Единая цепочка. Централизованная, долгосрочная запись. Поддерживайте единую, постоянную цепочку всех текстовых и голосовых сообщений с клиентом, которая будет служить централизованной, долгосрочной записью для справки. |
Примечание: * Функция запланирована или находится в разработке. Для получения более подробной информации обратитесь к своему партнеру или в компанию Meta
Архитектура
(Щелкните правой кнопкой мыши по изображению и выберите «Открыть в новой вкладке», чтобы увеличить его)Возможные конфигурации сигнализации и передачи данных
| Конфигурация по умолчанию после включения вызова | SIP с WebRTC | SIP с медиафайлами SDES | |
|---|---|---|---|
Протокол сигнализации | Graph API + веб-хуки | SIP (требуется явное включение ) | SIP (требуется явное включение ) |
Транспортировка сигналов | HTTPS | ТЛС | ТЛС |
Медиапротокол | WebRTC (ICE + DTLS 1 + SRTP) | WebRTC (ICE + DTLS + SRTP) | |
Аудиокодек2 | ОПУС | ОПУС | ОПУС |
Примечания
Начать
Шаг 1: Предварительные условия
Прежде чем начать работу с вызовом API, убедитесь в следующем:
вызовов (если вы не планируете использовать SIP ).Это же приложение необходимо также подписать на бизнес-аккаунт WhatsApp , привязанный к вашему рабочему номеру телефона.Это приложение должно иметь права на отправку сообщений ( whatsapp_business_messaging ) для рабочего номера.Для компании необходимо установить ежедневный лимит на количество уникальных получателей сообщений не менее 2000. Подробнее о масштабировании возможностей вашей учетной записи см . Включите функцию звонков для вашего рабочего телефонного номераШаг 2: Настройка дополнительных функций вызова
API для бизнес-звонков WhatsApp предлагает ряд функций, которые влияют на то, когда и как функции звонков отображаются пользователям в вашем профиле WhatsApp
Шаг 3: Совершайте и принимайте звонки
Вы можете протестировать интеграцию звонков WhatsApp, используя общедоступные тестовые номера и тестовый бизнес-аккаунт WhatsApp.
Функция Cloud API Calling предлагает два пути инициирования вызовов:
Тестовые и песочничные аккаунты
Доступ к тестовым учетным записям (Sandbox accounts) предоставляется только технологическим партнерам.
Тестовые учетные записи и общедоступные тестовые номера позволяют тестировать интеграцию WhatsApp Calling API с ослабленными ограничениями на звонки. В частности, для тестовых учетных записей и общедоступных тестовых номеров ослаблены ограничения на звонки, инициированные бизнесом, что облегчает интеграцию и тестирование.
Ограничения (на пару «компания + пользователь WhatsApp»)
процедуры "Начало работы" вы получите общедоступный тестовый номер
Для тестирования функций Calling API с использованием общедоступных тестовых номеров и учетных записей Sandbox вашей компании не обязательно устанавливать ежедневный лимит
Функция звонков по умолчанию отключена для тестовых номеров. Перед использованием API звонков на тестовом номере настроить функции звонков в параметрах вызовов
Доступность
Вызов, инициированный пользователем
Возможность совершения звонков по инициативе пользователя доступна во всех местах. Доступен облачный API .
Звонок, инициированный бизнесом
В настоящее время звонки по инициативе компании доступны во , кроме следующих: Cloud API доступен во всех
Примечание: код страны для корпоративного номера телефона должен быть в этом списке поддерживаемых стран. Номер телефона потребителя может быть из любой страны, где доступен Cloud API.
Следующие шаги
Воспользуйтесь приведенными ниже инструкциями, чтобы интегрировать функции вызова в ваше приложение:
Список изменений
Используйте эту таблицу как централизованное место для отслеживания обновлений функций, связанных с API бизнес-звонков WhatsApp
| Дата | Заголовок | Описание |
|---|---|---|
23 марта 2026 г | Поддержка аудиокодека G.711 (PCMA, PCMU) | В настройках вызовов появился новый раздел для конфигурации аудиокодека G.711 (PCMA/PCMU), включающий рекомендации по транскодированию, качеству звука и учету полосы пропускания. Узнайте больше о настройках аудиокодека . |
27 января 2026 г | Введены ограничения на звонки, основанные на отзывах пользователей | Узнайте больше об ограничениях на звонки, основанных на отзывах пользователей . |
19 декабря 2025 г | Обновление лимита звонков, инициированных компанией | Количество инициированных компанией звонков на одного пользователя увеличено со 10 до 100 в день. |
10 декабря 2025 г | Введена опция restrict_to_user_countries для настроек значка вызова. | Теперь вы можете управлять тем, в каких странах должен отображаться значок вызова. Узнайте больше о настройках страны для значка вызова . |
13 октября 2025 г | Количество инициированных компанией звонков на одного пользователя увеличено с 5 до 10 в день. В документацию добавлены учетные записи для тестирования и песочницы. | |
29 сентября 2025 г | Руководство по интеграции с Asterisk | Новое руководство по интеграции с Asterisk. |
24 сентября 2025 г | Распространение контекста от кнопок вызова и прямых ссылок | Укажите непрозрачную строку в кнопках вызова или прямых ссылках вызова, чтобы отслеживать источник вызовов, инициированных пользователем. Подробнее |
8 сентября 2025 г | Обновление вызова API состояния здоровья | API Health Status теперь расширен и включает новое can_receive_call_sip , которое поможет вам самостоятельно диагностировать проблемы, связанные с настройкой SIP. |
5 сентября 2025 г | Введены новые ограничения на количество звонков с возможностью перехвата вызова | Введены ограничения на низкий процент ответов на звонки. Подробнее см. в разделе « Ограничения на звонки с низким процентом ответов на звонки». |
21 июля 2025 г | веб-хуки обновления настроек учетной записи | Получайте веб-хуки при обновлении настроек. Подробнее . |
Комментарии отсутствуют
Комментарии отсутствуют