Как настроить WhatsApp Business Calling API

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

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

Начните с проверки номера и аккаунта

В актуальном обзоре Calling API от Meta указано, что бизнес номер должен работать в Cloud API, а не только в приложении WhatsApp Business. Приложение должно быть подписано на WhatsApp Business Account и поле webhook calls, а также иметь разрешение whatsapp_business_messaging.

Звонки по умолчанию отключены. Для их включения на рабочем номере Meta также требует дневной лимит сообщений не менее 2 000 уникальных получателей. Публичные тестовые номера и подходящие sandbox аккаунты позволяют проверить звонки без этого производственного порога.

Проверьте эти условия до разработки медиаслоя. Иначе команда может долго искать ошибку в WebRTC или SIP, хотя номер просто не соответствует требованиям. Зафиксируйте бизнес портфель, WABA, ID номера, приложение, подписки, владельца разрешений и текущий лимит в одном листе настройки. Токенов доступа там быть не должно.

Сначала решите кто кому звонит

API поддерживает два разных пути. Входящий сценарий начинается, когда пользователь WhatsApp звонит компании. Исходящий начинается, когда компания звонит пользователю.

Считайте их двумя отдельными релизами. Входящий путь проверяет прием, маршрутизацию, ответ и завершение. Исходящий добавляет систему согласия. Meta требует, чтобы пользователь дал разрешение до звонка компании. Разрешение бывает временным или постоянным, и пользователь может его отозвать.

Руководство Meta по разрешениям сейчас допускает один запрос за 24 часа и два за семь дней для каждой пары компании и пользователя. После повторных непринятых или отклоненных исходящих звонков действуют дополнительные ограничения. Храните состояние и источник разрешения. Согласие на сообщения не является автоматическим согласием на звонок.

Настройте ожидания до показа кнопки

Видимая кнопка создает простое ожидание, что кто то ответит. Настройте это обещание до публикации.

Документация Meta по настройкам звонков позволяет включить функцию, управлять видимостью значка, задать рабочие часы и праздники, включить запрос обратного звонка и голосовую почту. Часы привязаны к именованному часовому поясу, что важно для нескольких рынков и перехода на летнее время.

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

Соедините сигнализацию и медиа осознанно

По умолчанию Graph API и webhooks управляют сигнализацией, а WebRTC передает медиа. Meta также описывает SIP для подключения существующей голосовой платформы. Выберите архитектуру заранее, потому что включение SIP меняет использование вызовов API и webhooks.

При входящем вызове WebRTC поле calls передает событие подключения и предложение сессии. Meta рекомендует сначала выполнить pre accept, чтобы подготовить медиасоединение до окончательного ответа и уменьшить задержку и обрезание первых слов. После этого звонок проходит явные состояния принятия, разговора и завершения.

Сохраняйте эти состояния в журнале событий. Нужны как минимум ID звонка WhatsApp, бизнес номер, идентификатор клиента из webhook, направление, разрешение для исходящего вызова, время, статус завершения и владелец. Ненулевая длительность не доказывает, что клиент получил нужный результат.

Проверьте весь путь клиента

Успешный ответ API лишь одна контрольная точка. Пройдите путь с устройства клиента до человека или системы, которая должна ответить.

Сначала используйте публичный тестовый номер Meta или подходящий sandbox. Затем проведите ограниченный тест на одном рабочем номере. Проверьте значок, часы, входящее соединение, двусторонний звук, таймаут, пропущенный звонок, запрос разрешения на обратный вызов, событие завершения и запись, которую видит команда.

Отказы проверяйте так же внимательно. Отключите медиапоток. Не отвечайте на звонок. Отклоните его. Измените праздничное расписание. Отзовите разрешение на исходящие звонки. Убедитесь, что повторы не создают дубли и не отправляют лишние запросы разрешения. Назначьте человека, который сможет отключить звонки при проблемах с качеством, маршрутизацией, приватностью или штатом.

Сохраните звонок в истории общения

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

Текущие страницы DripTell о канале WhatsApp и общем входящем ящике описывают историю сообщений, ответственность и контекст клиента. Они сами по себе не доказывают, что WhatsApp Business Calling API включен в конкретном рабочем пространстве. Отдельно подтвердите поддержку звонков и медиархитектуру, а затем решите, какие события и итоги возвращать в диалог.

Запускайте один номер для одной ответственной команды. Кнопку заметить легко. Ценность появляется только тогда, когда за ней стоит надежный путь ответа.

Часто задаваемые вопросы

Что нужно для включения WhatsApp Business Calling API

Нужны подходящий номер WhatsApp Business Platform в Cloud API, подписки приложения и webhooks, разрешение whatsapp_business_messaging, достаточный рабочий лимит, включенные настройки и исправный путь сигнализации и медиа.

Может ли компания звонить любому пользователю WhatsApp

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

Что выбрать WebRTC или SIP

WebRTC подходит, когда приложение напрямую обрабатывает сигнализацию Graph API и медиа. SIP уместен для подключения существующей голосовой платформы. Выбор влияет на эксплуатацию, webhooks и диагностику, поэтому сделайте его до реализации.

Как проверить настройку

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