Модели интеграции
Обновлено: 25 февраля 2026 г
Возможные подходы высокого уровня
|
Подход
|
Настройка номеров
|
Обязанности поставщика бизнес-решений
|
Обязанности поставщика услуг телефонной связи
|
Завершение выполнения деловых обязанностей
|
|---|
BSP сообщений, способный вызывать | Существующий номер для сообщений продлен для звонков или присвоения нового номера | BSP-система обмена сообщениями повторно использует свое приложение и подписывает его на веб-хуки вызовов. Создание нового приложения, предназначенного специально для вызовов, также работает, но не рекомендуется.Обработка веб-хуков и координация действий с инфраструктурой обработки медиаконтента в режиме реального времениВыполняйте звонки, связанные с вызовами Graph API, аналогично вызовам Graph API для обмена сообщениями | Неприменимо, поскольку в деле участвует только один партнер. | Включить и использовать вызовыПродолжайте оплачивать счета от BSP, в которых теперь есть пункты, связанные с использованием звонков |
| Единый номер, управляемый независимо как системой обмена сообщениями (BSP), так и системой связи (BSP/TP) для вызывающих абонентов | BSP в обмене сообщениями не вносит никаких изменений | Обращение к хостам BSP/TP через их собственный веб-сайт, указывающее на их собственное приложениеОбеспечивает прохождение конечного бизнеса через их ES | Посадка осуществляется с использованием системы ES партнера по вызовуОплачивайте счета Messaging BSP как и раньшеДля операций, связанных с партнером по вызову, оплачивайте счет партнеру по вызову, если он является BSP, или Meta, если он не является BSP |
Эксклюзивный звонок от независимого поставщика программного обеспечения | | Неприменимо, поскольку отсутствует BSP для обмена сообщениями | Обращаясь к хостингам независимых поставщиков программного обеспечения (ISV), они размещают встроенную форму регистрации (Embedded Signup, ES) на своих веб-сайтах, указывая на собственное приложениеОбеспечивает прохождение конечного бизнеса через их ESЕсли независимый поставщик программного обеспечения (ISV) является технологическим провайдером или партнером, Meta выставляет счета конечным компаниям напрямую. ISV и конечные компании самостоятельно определяют порядок выставления счетовЕсли поставщик программного обеспечения является поставщиком баз данных, он может предоставить свою кредитную линию конечным потребителям | На борту используется ES на TPЕсли независимый поставщик программного обеспечения (ISV) является поставщиком технологий или партнером, оплачивайте Meta напрямую
Для этого конечным клиентам необходимо иметь прямые платежные отношения с Meta. Установление таких отношений может занять несколько недельЕсли ISV является BSP, оплатите счет через BSP |
| Новый номер, предназначенный исключительно для звонков, обслуживается ( только ) компанией Calling TP. | BSP и TP совместно разрабатывают и утверждают многопартнерское решение. У BSP и TP есть собственные приложенияРазработка системы обмена сообщениями BSP <> Звонки ISV коммерческие отношенияПредоставить кредитную линию для завершения бизнесаМожно получать сообщения или звонки, но нельзя отправлять сообщения или звонки, поскольку в многоплатформенном решении для отправки сообщений/звонков можно выбрать только одного из двух партнеров | BSP и TP совместно разрабатывают и утверждают многопартнерское решение. У BSP и TP есть собственные приложенияРазработка системы обмена сообщениями BSP <> Звонки ISV коммерческие отношенияПодключение конечных клиентов с использованием ES, указывающих на созданное решениеОтправка/получение сообщений или звонков | На борту используется ES на TPКомпания Biz проинформирована о TP в ESОплатите счет через Центральный банк Филиппин (BSP) |
Многовариантные диалоги (MSC)
Функция многоканальных диалогов позволяет использовать несколько решений на одном телефонном номере, локализуя обмен сообщениями и звонки в рамках одного чата.
Интеграция с использованием стороннего поставщика услуг связи: детальный дизайн
Следующая логическая архитектура иллюстрирует, как интегрировать функцию звонков WhatsApp Business с использованием стороннего поставщика услуг звонков (3P).
В этом сценарии вы будете использовать стороннего поставщика в фоновом режиме, и этот сторонний поставщик будет невидим для Meta. Эта схема аналогична любой другой SaaS-службе, которую вы можете использовать.
На диаграмме также показано, как эту архитектуру можно дополнительно расширить для интеграции с SIP-инфраструктурой на вашей стороне.
В соответствии с нашими условиями, использование телефонной сети общего пользования (PSTN) запрещено на любом этапе разговора через WhatsApp.
Даже если вы подключаете звонки WA к сети SIP, необходимо убедиться, что они по-прежнему осуществляются исключительно через VoIP и никогда не затрагивают телефонную сеть общего пользования (PSTN). Использование SIP-транка само по себе не запрещено, поскольку технически SIP-транк можно использовать вообще без подключения к PSTN.
(
Щелкните правой кнопкой мыши по изображению и выберите «Открыть в новой вкладке», чтобы увеличить его)
Одно приложение против нескольких приложений
В этом разделе рассматриваются рекомендации и соображения относительно повторного использования существующего приложения для обмена сообщениями для совершения звонков по сравнению с созданием нового приложения специально для функций API звонков.
Для интеграции с API звонков WhatsApp необходимо вызывать
конечные точки Graph API и обрабатывать веб-хуки из Meta. Для этого
требуется приложение , и почти всегда у вас уже должно быть приложение, используемое для обмена сообщениями.
Короче говоря, вы можете повторно использовать существующее приложение, которое применяется для
встроенной регистрации и для обмена сообщениями.
В этой конфигурации URI обратного вызова веб-хука одинаков как для веб-хуков, связанных с сообщениями, так и для веб-хуков, связанных с вызовами, но полезная нагрузка веб-хука может использоваться для различения двух категорий функций (отправка сообщений и вызовы). Таким образом, вы по-прежнему можете перенаправлять веб-хуки, специфичные для API вызовов, в компонент, связанный с вызовами, из основной бизнес-логики вашего веб-хука.
Повторное использование одного и того же приложения дает следующие преимущества:
Снижение операционных издержек (например, проверка приложений, текущее техническое обслуживание)Упрощенный размер страниц на MetaСовпадение характеристик приложения, используемого для встроенной регистрации, и приложения, используемого для вызова Graph API и получения веб-хуковПовторное использование этого приложения для звонков никак не повлияет на существующую функциональность. Вам просто нужно убедиться, что сервер веб-хуков способен корректно обрабатывать веб-хуки, связанные с «звонками».Стек VoIP-звонков WhatsApp Business Calling разработан для совместимости с WebRTC. Однако для обеспечения бесперебойной интеграции с протоколом WhatsApp компания Meta ограничивает поддерживаемые функции. В результате применяются следующие требования и рекомендации.
Если какое-либо из обязательных требований не будет выполнено, вызов завершится неудачей. Эта неудача может произойти либо на этапе сигнализации вызова, что приведет к отклонению вызова, либо на этапе декодирования медиапакетов.
Используйте только аудиокодек Opus.Установите тактовую частоту мультимедиа на 48 кГц.Установите частоту тактирования DTMF на 8 кГц.Используйте значение ptime равный 20 мс.Для передачи аудиоданных необходимо использовать один SSRC. Сервер ретрансляции Meta перезаписывает SSRC всех бизнес-аудиопакетов на фиксированный SSRC до того, как эти пакеты достигнут клиента WA. Клиенты WA обрабатывают только один источник звука от своих партнеров. Использование нескольких SSRC приводит к неопределенному поведению. Это включает в себя серьезное повреждение медиафайлов, сбои звука и, вероятно, полный отказ передачи медиафайлов.Хотя перечисленные ниже аспекты не являются обязательными, их рекомендуется соблюдать для обеспечения высокого качества и надежности связи.
Процесс ICEНаш стек VoIP — ICE-LITE, поэтому рекомендуется, чтобы стек VoIP поставщиков услуг связи (BSP) был ICE-FULL. ( RFC 5245, раздел 2.7 )Стек VoIP поставщиков баз данных должен инициировать процесс ICE, отправляя проверки подключения STUN.VoIP-стек BSP должен взять на себя роль ICE CONTROLLING, поскольку Meta будет брать на себя только роль CONTROLLED. выдвижение кандидатов вместо агрессивного. ( RFC 5245 Раздел 8.1.1.2 )Дождитесь завершения процесса ICE, прежде чем выдвигать кандидатуру и запускать DTLS.Не меняйте кандидата в середине разговора.ДТЛСДля предотвращения фрагментации пакетов во время передачи используйте ключи ECDH для сертификатов DTLS.BSP должен выступать в качестве DTLS-клиента. ( RFC 6347, раздел 4.2 )Решение проблемы искажения звукаЗадержите воспроизведение звука с SIP-соединения до тех пор, пока не будет установлено медиасоединение с Meta.Интеграция с API предварительного подтверждения поможет уменьшить искажения звука в звонках, инициированных пользователем.
Комментарии отсутствуют
Комментарии отсутствуют