Часто задаваемые вопросы | Документация для разработчиков
Часто задаваемые вопросы
Обновлено: 13 ноября 2025 г
Часто задаваемые вопросы о продукте
Будут ли звонки отображаться на странице аналитики в пользовательском интерфейсе Meta WhatsApp Manager?
Аналитические данные о звонках будут доступны как в WhatsApp Manager, так и в API аналитики .
Поддерживаются ли международные звонки, как, например, звонки между пользователями WhatsApp?
Да.
Какие страны поддерживаются для звонков?
Дополнительную информацию см. в разделе «Доступность звонков»
Можно ли использовать бесплатные номера для звонков?
Да, если код страны для бесплатного номера входит в список поддерживаемых стран. Подробную информацию о регистрации бесплатных номеров в Cloud API см. «Номера 1-800 и бесплатные номера»
Каково максимальное количество одновременных вызовов, которые может принимать один телефонный номер учетной записи Cloud API?
Максимальное количество одновременных вызовов — 1000. При превышении лимита звонящий (пользователь WhatsApp) получит стандартное сообщение о невозможности совершения вызова. Сообщение не будет воспроизведено, и веб-хук не будет активирован. Ожидается, что этот лимит будет увеличен, поэтому вероятность такого события низка. Обратите внимание, что лимиты скорости для API обмена сообщениями и API создания/обновления шаблонов являются отдельными и не связаны с лимитами вызовов.
Какова роль BSP и конечного бизнеса в общем потоке звонков?
вызовы . В типичных случаях поставщик услуг связи использует собственное приложение и получает веб-хук вызова, после чего происходит установление соединения.Способ участия конечного предприятия в обсуждении определяется Центральным банком Филиппин (BSP).Одинакова ли голосовая инфраструктура/API для WhatsApp и Facebook Messenger?
API для звонков WhatsApp — это первый публичный голосовой API от Meta. Meta может использовать тот же API и модель интеграции для других продуктов Meta, если и когда они предложат голосовые решения.
Какова максимальная поддерживаемая продолжительность звонка?
Ограничений по продолжительности звонка нет.
Поддерживается ли протокол SIP?
Да, см. раздел «Настройка и использование сигнализации вызовов через протокол инициации сеанса (SIP)».
Могу ли я отправлять/получать текстовые/медийные сообщения во время телефонного разговора?
Да. Стандартный API отправки сообщений можно использовать во время выполнения вызова.
Предлагает ли Meta такие услуги, как запись голоса, расшифровка и голосовая почта?
Нет.
Могу ли я добавить метаданные (например, контекст) в процессе принятия вызова?
Да. См. поле biz_opaque_callback_data в основной спецификации API . Кроме того, существующее состояние разговора предоставляет важный контекст для оператора бизнес-процессов. Подсистема маршрутизации вызовов должна напрямую соединять звонок от пользователя WhatsApp с нужным оператором на стороне бизнеса. Это обеспечивает наилучшее качество обслуживания клиентов и позволяет избежать использования стандартной системы интерактивного голосового меню (IVR).
Как я могу повысить осведомленность пользователей WhatsApp о функции звонков?
Возможно ли, чтобы искусственный интеллект (например, голосовой бот) вел прямой разговор с клиентом через звонок в WhatsApp?
Да. Meta предоставляет только необработанный медиапоток, и способ его обработки полностью гибок. Многие компании используют автоматизированных голосовых ботов, включая ботов с искусственным интеллектом, для ответа на звонки пользователей WhatsApp. Многие продукты на основе ИИ на рынке предлагают API для RTC/речи, а некоторые даже имеют встроенную поддержку WebRTC. Подход к интеграции аналогичен интеграции WhatsApp Business Calling с колл-центрами для IVR или операторов-людей.
Ограничения на использование ИИ см . в Условиях использования решения WhatsApp Business
Почему предварительное принятие инициированного пользователем звонка запускает таймер на стороне пользователя WhatsApp?
Вероятно, это происходит потому, что медиафайлы отправляются до того, как вызов будет принят . Клиенты WhatsApp считают вызов принятым, если они получают медиапакет или сигнал подтверждения, в зависимости от того, что произойдет раньше.
Если время начала передачи мультимедиа невозможно контролировать, примите вызов напрямую и не используйте предварительное принятие . Предварительное принятие предназначено для ускорения установления соединения, но требует контроля времени передачи мультимедиа.
Существует ли страница состояния, позволяющая отслеживать общее состояние вызываемых API и просматривать информацию о любых сбоях или инцидентах в работе сервисов?
Да. См. раздел «Вызовы облачных API» по ссылкам https://metastatus.com/whatsapp-business-api и https://metastatus.com/whatsapp-business-api/history
Часто задаваемые вопросы о начале работы
Какова минимальная версия Graph API для вызова API?
Это версия 17.0. Историю версий можно посмотреть здесь.
Могу ли я использовать один и тот же токен доступа пользователя как для обмена сообщениями, так и для звонков?
Да. Всё, что работает для обмена сообщениями, должно работать и для звонков в целом.
Нужно ли WABA указывать кредитную линию для использования API-интерфейсов?
Да, для использования API вызовов требуется кредитная линия, привязанная к WABA.
Нужно ли, чтобы компания WABA была подтверждена для совершения звонков?
Нет. Подтверждение деловой активности не требуется ни для звонков, ни для обмена сообщениями.
Как использование вызовов API влияет на мои лимиты запросов?
В настоящий момент использование API для вызовов не учитывается в лимитах скорости отправки сообщений. Единственное ограничение на вызовы, действующее на данный момент, — это лимит в 1000 одновременных вызовов, но в ближайшем будущем это может измениться.
Возможно ли связать аккаунт WhatsApp Business с провайдером A для чата и с провайдером B для голосовой связи (то есть, два разных приложения, подключенных к одному и тому же аккаунту/телефону WhatsApp Business Webhook)?
Да, два партнера могут использовать один номер телефона WhatsApp Business API с двумя отдельными функциями, такими как чат и звонки.
Другой вариант — использование голосового провайдера, предоставляемого другим поставщиком баз данных. В этом случае приложение Meta или статус технологического провайдера на платформе Meta не требуются. Эта архитектура подробно описана в разделе «Интеграция с использованием стороннего голосового провайдера» .
Часто задаваемые вопросы по сигнализации вызовов Graph API
Предоставляет ли Meta какие-либо stun/turn-серверы или инфраструктуру WebRTC для использования BSP?
Нет.
Meta использует ICE-lite , и предложение Meta SDP всегда содержит один IPv4- и один IPv6-адрес для каждого компонента потока данных. Ответ SDP должен соответствовать тому же формату.
Таким образом, использование STUN/TURN для определения кандидатов на должность сотрудника иммиграционной службы не является обязательным
Рекомендует ли Meta какие-либо stun/turn-серверы или инфраструктуру WebRTC для использования BSP?
На Meta нет рекомендаций. Вот несколько идей для размышления, на случай, если они окажутся полезными.
Какую роль должен играть агент ICE со стороны бизнеса?
Всегда выбирайте роль CONTROLLING, поскольку агент ICE на стороне Meta использует ICE-lite ( RFC 8445 ) . Запуск с ролью CONTROLLED может привести к зависанию и таймауту процесса ICE. Даже если это сработает, потребуется больше времени из-за многократных обращений для разрешения конфликтов ролей.
Можно ли добавить больше кандидатов ICE в рамках сигнализации в предложении + ответе (например, с помощью ICE Trickle)?
Короткий ответ: да. Cloud API использует ICE-lite (RFC 8445) и всегда принимает на себя управляемую роль в ICE. Следовательно, нет необходимости отправлять обновленные кандидаты в Meta. Агент ICE может инициировать проверки подключения с адресов, не включенных в SDP, и агент Meta ICE будет считать неизвестный адрес допустимым кандидатом, если целостность сообщения STUN подтверждена.
Каковы рекомендации по определению кандидата, подпадающего под действие иммиграционной и таможенной службы (ICE)?
Компания Meta имеет глобальное присутствие в инфраструктуре, и Meta выберет в своей сети медиаретранслятор, расположенный ближе всего к пользователю WhatsApp, участвующему в звонке.
На стороне BSP выбор медиасервера/хоста (также известного как таргетинг) может осуществляться на основе множества параметров, включая IP-адрес, выбранный Meta, страну телефонного номера потребителя и номер телефона компании. Выбор местоположения медиасервера является важным фактором оптимизации задержки передачи медиаданных между IP-адресом BSP и IP-адресом Meta, что, в свою очередь, способствует повышению качества связи. Как минимум, местоположение хоста BSP для звонков/медиаданных должно находиться близко к стране пользователя WhatsApp, определяемой по коду страны телефонного номера пользователя.
Любая реализация таргетинга на стороне BSP должна оптимизироваться для IP-адресов кандидатов в Meta SDP, а не для источников сигнальных конечных точек.
Существует ли API для отправки предварительного ответа, эквивалентного звонку SIP 180?
В противном случае, когда устройство звонящего начнет звонить?
К моменту получения веб-хука звонящий (пользовательское приложение WhatsApp) уже будет звонить. Предварительных ответов не требуется
Как обеспечивается безопасность звонков?
Cloud API использует SRTP для шифрования медиапотоков (RTP/SAVPF) , ключами SRTP первоначально осуществляется сквозным способом с помощью DTLS-SRTP .
Может ли Meta отправлять веб-хуки вызова на другую конечную точку в зависимости от географического местоположения вызывающего абонента или других факторов, таких как задержка в сети?
URL веб-хука можно настроить. Используется HTTPS, поэтому для переадресации можно применять стандартные методы балансировки нагрузки и таргетинга. Для каждого бизнес-аккаунта WhatsApp и каждого бизнес-номера телефона хука. Веб-хук используется только для сигнализации, а серверы Meta, обращающиеся к серверу веб-хука, расположены в США. Выберите местоположение конечной точки медиа-адреса на основе кода страны пользователя WhatsApp (доступен в веб-хуках) или IP-адресов кандидатов ICE в SDP, отправленных Meta. См. приведенные выше вопросы из раздела часто задаваемых вопросов : «Как определить кандидата ICE? » и «Как уменьшить задержку медиа-сообщений при звонках?» .
Какие мета-IP-адреса будут использоваться для вызова веб-перехватчиков, SIP-серверов или медиасерверов с целью добавления их в список разрешенных адресов брандмауэра?
обратитесь к документации WhatsApp Webhooks . При сворачивании списка IPv4-адресов получается около 23 префиксов. Ниже приведен пример команды и вывода, выполненных по состоянию на 11 декабря 2024 года.
$ src % whois -h whois.radb.net — '-i origin AS32934' | grep ^route | awk '{print $2}' | grep -iv ':' | cidrmerge 31.13.24.0/21 31.13.64.0/18 45.64.40.0/22 57.141.0.0/21 57.141.8.0/22 57.141.12.0/23 57.144.0.0/14 66.220.144.0/20 69.63.176.0/20 69.171.224.0/19 74.119.76.0/22 102.132.96.0/20 103.4.96.0/22 129.134.0.0/16 147.75.208.0/20 157.240.0.0/16 163.70.128.0/17 163.77.128.0/17 173.252.64.0/18 179.60.192.0/22 185.60.216.0/22 185.89.216.0/22 204.15.20.0/22
Возможно ли уменьшить количество IP-адресов Meta, которые будут обращаться к серверам веб-хуков, хотя бы для целей разработки и тестирования?
Нет. Но посмотрите раздел часто задаваемых вопросов выше, где указано около 23 префиксов IPv4, чтобы полностью охватить все адресное пространство Meta для v4.
Какова политика повторных попыток при вызове связанных веб-хуков?
В этом отношении не следует ничего предполагать. Сервер веб-хуков должен определять устаревшие веб-хуки на основе значения временной метки и избегать вызова Graph API для их дальнейшей обработки. Существующие веб-хуки, связанные с обменом сообщениями, будут повторно обрабатываться в течение 7 дней .
Для веб-хуков, связанных со звонками, вероятно, будет действовать более короткий срок повторных попыток, но устаревшие веб-хуки все равно могут быть доставлены, поскольку это может быть полезной информацией для бизнеса, позволяющей понять, что некоторые клиенты пытались с ними связаться.
Гарантирует ли Meta ровно одну доставку веб-хуков?
Нет. Будьте готовы к обработке дубликатов веб-хуков.
Из-за распределенной архитектуры Meta гарантировать доставку данных ровно один раз для любых веб-хуков, включая даже веб-хуки, связанные с обменом сообщениями, невозможно. Ниже приведены некоторые известные сценарии, в которых сегодня могут возникать дубликаты.
Вы гарантируете обработку веб-хуков для конкретного вызова?
Нет. Гарантированное сохранение порядка выполнения запросов не предусмотрено из-за распределенной архитектуры Meta и повторных попыток.
Например, веб-хук завершения вызова может прийти раньше веб-хука подключения, если пользователь WhatsApp завершает звонок сразу после его начала. Ниже приведены другие известные примеры.
Предпринимается попытка подключения через веб-перехватчик, которая завершается ошибкой по истечении времени ожидания примерно через 20 секунд. Затем отправляется сообщение «Завершить веб-перехватчик». Повторная попытка подключения через веб-перехватчик происходит после отправки сообщения «Завершить веб-перехватчик». В случае истечения времени ожидания сервер веб-перехватчиков считает, что ошибки нет, но это рассматривается как ошибка, требующая повторной попытки.
Можно ли настроить несколько серверов веб-перехватчиков для вызовов и иметь представление об основном и резервном серверах для обеспечения высокой доступности?
Аналогично обмену сообщениями, можно настроить несколько подписок с различными приложениями, связанными с различными URL-адресами обратного вызова. Meta будет направлять все вызывающие веб-хуки на все настроенные URL-адреса обратного вызова. Все URL-адреса рассматриваются как равноправные, и нет понятия основного/дополнительного URL-адреса
Можно ли настроить разные URL-адреса для веб-хуков, связанных с отправкой сообщений и звонками?
Да, это можно сделать, используя два разных приложения Meta — одно для обмена сообщениями, другое для звонков.
Подпишите приложение для обмена сообщениями только на поля подписки веб-перехватчика, связанные с сообщениями, а приложение для звонков — на поля подписки, связанные с звонками. URL-адрес обратного вызова можно переопределить для каждого из этих приложений на уровне WABA или номера телефона, чтобы иметь разные URL-адреса для сообщений и звонков.
Однако одно приложение может подписаться как на
сообщения , так и на звонки через поля подписки веб-хука. В этой конфигурации URI обратного вызова одинаков для обоих типов веб-хуков, но полезная нагрузка веб-хука может использоваться для различения этих двух категорий.В целом, рекомендуется использовать одно приложение.
Пожалуйста, ознакомьтесь с разделом «Пример запроса CURL» в справочнике API.
Как следует сериализовать параметры SDP с переносом строки и символом возврата каретки?
Параметр session требует, чтобы SDP был задан в виде строки в соответствии со RFC-8866 , которая требует использования CRLF для завершения записи. Сам параметр SDP является строкой, поэтому его не следует дополнительно сериализовать. Однако устаревший параметр connection требовал, RFC-8866 , находилась в структуре JSON, и, следовательно, требовал дополнительной сериализации.
Короче говоря, используйте «\r\n» для параметра session->SDP. Не используйте устаревший параметр connection->WebRTC->SDP.
Как исправить ошибку «Отпечаток пальца не найден в SDP»?
В протоколе SDP должна присутствовать
a=fingerprint при использовании DTLS в качестве ключами SRTP . Обязательно добавьте эту строку или настройте номер телефона компании для использования SDES . См. все возможные конфигурации сигнализации и мультимедиа .Часто задаваемые вопросы о WebRTC и медиаконтенте
Соединение между физическими лицами осуществляется от Meta к BSP или от конечного бизнес-подразделения?
Как правило, это BSP (базовый поставщик услуг), но в зависимости от предлагаемого продукта и архитектуры это может быть и конечный бизнес.
Если речь идёт о конечном потребителе услуг, то BSP потребуется программно взаимодействовать с ним, чтобы получить ICE-кандидаты, включённые в вызов Graph API, для принятия входящего вызова.
Что произойдет, если передача медиаконтента прекратится с одного конца из-за проблем с подключением?
Простой пример: если точка завершения вызова выходит из строя, но при этом бизнес-сторона прекращает отправку медиафайлов.
Это приведет к нехватке RTCP-пакетов, что помогает обнаружить неактивный агент WebRTC, и вызов будет разорван, после чего будет отправлен веб-перехватчик завершения .
Всегда ли используется кодек opus/48000?
Мы также поддерживаем G.711 (PCMA и PCMU). Для Opus частота тактирования RTP установлена на уровне 48000 в SDP в соответствии с RFC 7587. Мобильные приложения WhatsApp поддерживают Opus только изначально, поэтому Metamedia Infra преобразует Opus в другие кодеки при необходимости.
Какие ещё кодеки поддерживаются?
Поддерживаемые аудиокодеки: OPUS, PCMA, PCMU (также известный как G.711)
Поддерживается ли DTMF?
Да. Подробности см. в разделе DTMF . Большинство реализаций SIP должны поддерживать обработку DTMF, поступающих через поток данных RTP ( . ссылку ).
Сколько потоков поддерживается в SDP?
В SDP Offer/Answer поддерживается только один поток данных.
Сколько дорожек поддерживается в каждом потоке SDP?
В потоке SDP поддерживается только одна звуковая дорожка.
Может ли мобильное приложение WhatsApp работать с рекламным предложением SDP, сгенерированным в браузере бизнес-агента, при совершении звонка между частным лицом и компанией?
В этом случае агент WebRTC в браузере должен генерировать ответ SDP, а не предложение.
Этот ответ SDP следует отправить обратно в Meta, используя конечную точку вызова accept . Meta не может работать ни с каким другим предложением SDP, кроме того, которое было сгенерировано и предоставлено через веб-хук.
Какой алгоритм сертификации рекомендуется для DTLS?
, поскольку они обеспечивают более быструю генерацию сертификатов и более короткие рукопожатия DTLS благодаря отсутствию фрагментации .
Кто инициирует вызовы после принятия вызова, инициированного пользователем — BSP или Meta?
Центральный банк Филиппин должен инициировать проверку соединения ICE, как только примет решение о принятии вызова.
Это можно сделать даже до вызова API accept, но процесс ICE завершится только после того, как Meta обработает ответ SDP, из-за необходимости получения отпечатка сертификата DTLS.
Какие номера портов используются кандидатами ICE в SDP Meta для включения в список разрешенных на межсетевых экранах?
Номера портов могут быть любыми из следующих:
40012 , 3482 , 3484 , 3478 , 3480. Эти номера могут изменяться.Как сгенерировать SDP-пакет WebRTC Accept?
Ознакомьтесь с документацией библиотеки WebRTC или инструмента, который планируется использовать.
Обработка SDP-предложения для генерации SDP-ответа является основной функцией любого стека технологий VoIP.
Как уменьшить задержку передачи данных при звонках?
Алгоритмы таргетинга Meta выберут ретранслятор Meta, который принимает медиаданные от BSP, расположенный ближе всего к местоположению пользователя WhatsApp. Этот медиаретранслятор является кандидатом на получение ICE-пакетов, который Meta передаст в SDP. Любой таргетинг со стороны BSP должен размещать медиасерверы BSP в том же регионе, что и пользователь. Это, очевидно, минимизирует задержку для звонков внутри одного региона, но также минимизирует маршруты медиапакетов в общедоступном интернете для международных звонков.
Существует ли процедура восстановления соединения в случае временного обрыва связи на любом из концов медиаканала?
Пользовательские приложения WhatsApp попытаются восстановить соединение и автоматически возобновят этот участок звонка после восстановления сетевого подключения.
Что касается бизнес-части, ожидается относительно более стабильная сетевая обстановка. В настоящее время отсутствует поддержка повторного установления соединения или повторного согласования SDP. В любом случае, вызов может завершиться после определенного периода бездействия, после чего отправляется веб-хук завершения.
Какой объем пропускной способности потребуется колл-центру для обработки заданного количества одновременных звонков?
Для каждого звонка требуется примерно 40 кбит/с на кодек + 20 кбит/с накладных расходов
Кодек Opus обладает способностью динамически изменять потребляемую полосу пропускания в зависимости от состояния сети. В целом, он может обеспечить лучшее качество звука при меньшем потреблении полосы пропускания по сравнению с кодеком G711.
Для сравнения, кодеку G711 требуется 64 кбит/с на кодек + 20 кбит/с накладных расходов = 84 кбит/с на один звонок.
Умножьте приведенные выше числа на ожидаемое количество одновременных вызовов, чтобы рассчитать необходимую суммарную пропускную способность. Пример: пропускная способность 1 Мбит/с примерно позволяет обрабатывать 15 одновременных вызовов в сети Opus (1000/64) по сравнению с 12 одновременными вызовами в сети G711 (1000/84).
Для расчета общего объема использованных данных необходимо умножить пропускную способность на продолжительность разговора в секундах. Для Opus ситуация несколько сложнее, поскольку пропускная способность у него переменная и зависит от многих факторов, включая доступную пропускную способность, оцениваемую с помощью метода оценки пропускной способности, говорит ли собеседник или молчит, и так далее. В целом, 1-минутный разговор на Opus потребляет 3,75 МБ данных, тогда как на G711 — 4,9 МБ
Возможно ли перевести звонок от одного оператора к другому во время активного сеанса связи? По сути, клиент разговаривает с оператором А, и его нужно перевести к оператору Б?
Meta не имеет встроенной поддержки.
Meta не знает о наличии разных агентов на стороне бизнеса/партнера, поэтому эта операция может быть выполнена исключительно на стороне партнера. Например, поток мультимедиа может быть следующим: медиасервер Meta — медиасервер партнера — агент A. При передаче поток становится следующим: медиасервер Meta — медиасервер партнера — агент B. Таким образом, в обоих случаях отрезок от медиасервера Meta к медиасерверу партнера остается неизменным.
Часто задаваемые вопросы о пользовательском приложении WhatsApp
Когда в пользовательских версиях WhatsApp отображается значок вызова в строке заголовка чата?
Это становится видимым, когда выполняются все следующие условия:
ВКЛЮЧЕН .Значение параметра call_icon_visibility для номера телефона компании не равно HIDE_IN_CHAT и не равно DISABLE_ALL.Функция отображения значка вызова поддерживается в мобильных версиях WhatsApp 2.24.10.8 и выше на устройствах Android и iOS.Версия WhatsApp для пользователей — 2.23.14 или выше. Предполагается, что все пользователи используют именно эту версию или выше.Почему значок вызова в приложении WhatsApp для пользователей не отображает текущие настройки вызова?
После обновления настроек звонков пользователям WhatsApp может потребоваться до 7 дней, чтобы изменения вступили в силу, хотя большинство пользователей обновляют настройки гораздо быстрее. Немедленное обновление в WhatsApp можно принудительно запустить, открыв окно чата с представителем компании и страницу информации о чате. Независимо от поведения клиента WhatsApp, семантика настроек по-прежнему учитывается на стороне сервера.
Для устранения неполадки, связанной с отсутствием значка вызова, выполните следующие действия:
Сколько времени требуется клиентам WhatsApp для отображения изменений в настройках вызовов?
На это может уйти до 7 дней, хотя большинство пользователей WhatsApp должны увидеть изменения гораздо раньше.
Один бизнес-аккаунт WhatsApp может вести чаты с любым количеством пользователей WhatsApp, превышающим 3 миллиарда. Обновления настроек звонков отправляют уведомления об изменениях всем пользователям, у которых в почтовом ящике WhatsApp отображается чат с этим бизнес-аккаунтом. Однако доставка уведомлений осуществляется по мере возможности, поэтому не все пользователи могут их получить.
Все клиенты WhatsApp обновляют информацию о компании (включая настройки звонков) каждые 7 дней, независимо от получения уведомлений об изменениях.
В любом случае (с помощью уведомлений или с обновлением через 7 дней) после обновления локального состояния в клиенте WhatsApp оно отображается в пользовательском интерфейсе только при следующем открытии экрана чата или экрана информации о чате.
Нужно ли мне создавать список разрешенных номеров абонентов для звонков на работу?
Нет.
Можно ли ограничить доступ к звонкам только для конкретных пользователей WhatsApp, а не для всех?
Пример: квалифицированный потенциальный клиент или клиент, находящийся в премиум-сегменте
Нет. Нет возможности контролировать видимость или доступ к звонкам для каждого отдельного пользователя WhatsApp. Однако API настроек звонков позволяет установить
параметр call_icon_visibility в значение DISABLE_ALL , что скроет значки звонков для всех пользователей WhatsApp. Для определенных пользователей WhatsApp можно отправить сообщение с кнопкой призыва к действию (CTA), чтобы только они могли позвонить в компанию, нажав на кнопку в сообщении.Для реализации подобной функции Meta потребуется хранить конфигурацию для каждого пользователя WhatsApp, что сопряжено с более высоким риском нарушения конфиденциальности. Кроме того, это повлечет за собой дополнительные операционные затраты на поддержание больших списков разрешенных пользователей WhatsApp на постоянной основе.
Если значок вызова скрыт с помощью API настроек вызовов, смогут ли потребители по-прежнему звонить в компанию?
Да.
Пользователь по-прежнему может позвонить в компанию с других точек доступа, на которые API настроек звонков , например:
Поэтому рекомендуется рассматривать
DISABLE_ALL только как общий фильтр первого уровня и убедиться, что веб-хуки выполняют любую дополнительную фильтрацию на основе конкретной бизнес-логики.Как пользователи WhatsApp будут вводить цифры для DTMF-сигнала?
В пользовательском приложении WhatsApp появилась поддержка новой клавиатуры для деловых звонков.
Какая минимальная версия мобильного приложения WhatsApp поддерживает кнопку голосового вызова?
Каков опыт пользователей WhatsApp на различных этапах процесса установления соединения?
Когда пользователь WhatsApp звонит в компанию, местный сигнал вызова включается немедленно, если устройство пользователя WhatsApp подключено к интернету.
В пользовательском интерфейсе вызова отображается «Звонит BUSINESS_NAME». Когда Cloud API получает запрос на звонок от клиента и предварительно принимает его, пользовательский интерфейс вызова меняется на «Звонит BUSINESS_NAME». После выполнения запроса на принятие вызова через Graph API пользовательский интерфейс вызова меняется на активное окно вызова, отображающее таймер, показывающий продолжительность звонка.
Поддерживаются ли звонки для конечных пользователей из веб-версии WhatsApp или настольного приложения WhatsApp?
Нет. WhatsApp Web не поддерживает звонки между абонентами или деловые звонки. На данный момент настольные приложения поддерживают только звонки между абонентами.
Часто задаваемые вопросы о звонках, инициированных бизнесом
Какие версии WhatsApp и клиентские платформы поддерживают функцию совершения звонков по инициативе компании?
В версиях клиента WhatsApp 2.24.14.x и более поздних поддерживается запрос разрешения на совершение звонков и функция звонков, инициированных бизнес-клиентами.
Эта функция поддерживается как платформами WhatsApp для Android, так и для iOS.
Как избежать ошибки 138011 в диалогах, инициированных бизнес-процессами и пользователями, во время разработки/интеграции/тестирования?
Разговор, инициированный пользователем:
Разговор, инициированный бизнесом:
Есть ли способ сбросить лимиты запросов на разрешение вызова?
При установлении соединения лимиты разрешений на вызов будут сброшены.
Что произойдет, если пользователь WhatsApp настроил функцию "Заглушение неизвестных абонентов"?
Совершаемые по служебным причинам звонки обходят настройку «Заглушать неизвестные звонки», поскольку звонок возможен только после получения явного разрешения пользователя.
Почему мое сообщение с запросом разрешения на вызов отображается иначе?
WhatsApp отображает сообщения в неподдерживаемых версиях клиентского приложения иначе, чем в поддерживаемых.
После обновления клиентского приложения WhatsApp, оно будет отображаться корректно.
После отправки запроса на разрешение вызова я получил ошибку 138001. Что мне делать?
Истекает ли срок действия разрешения после достижения лимита в 24 часа между подключенными звонками? Я вижу ошибку 138012.
Ограничение на количество подключенных звонков в течение 24 часов — это временной лимит, действующий на протяжении определенного периода времени. Достижение этого лимита не отменяет разрешение; разрешение остается открытым в течение полных 7 дней для временно разрешенных разрешений или постоянно для разрешений, действующих постоянно. API ограничения скорости звонков предоставляет точную метку времени, когда этот лимит истекает и можно совершить следующий звонок.
Рассматривайте это как ограничение на количество звонков, инициированных компанией.
Часто задаваемые вопросы о протоколе инициации сеанса (SIP)
См. раздел «Ошибки SIP» для получения информации об ошибках, специфичных для SIP, и возможных решениях.
Почему инициированный пользователем звонок немедленно обрывается после включения SIP?
Наиболее вероятная причина — ошибка проверки сертификата: см. Как проверить наличие действительного TLS-сертификата.
Почему я не получаю SIP INVITE-сообщения при звонках от пользователей WhatsApp?
Возможные причины включают в себя:
whatsapp_business_messaging для рабочего номера телефона. Попробуйте отправить сообщение, используя тот же рабочий номер телефона, чтобы убедиться в наличии необходимых разрешений.Почему наш SIP-терминат, отправляемый в Meta, не завершается на стороне пользователя WhatsApp?
Распространенная причина — сбой рукопожатия TLS, когда SIP-сервер пытается установить TLS-сессию с Meta SIP-сервером. Для подтверждения успешного рукопожатия TLS выполните захват сетевых пакетов SIP-трафика или проверьте журналы SIP-сервера
Почему мой SIP-сервер постоянно отвечает ошибкой 401 Unauthorized на звонки, инициированные пользователем?
Meta поддерживает дайджест-аутентификацию SIP для вызовов, инициированных пользователем . Когда SIP-сервер отвечает ошибкой 401 Unauthorized (см. пример схемы ), SIP-сервер Meta повторно отправляет INVITE с соответствующим заголовком Authorization. Убедитесь, что SIP-сервер настроен с именем пользователя, равным номеру телефона компании, и паролем, равным сгенерированному Meta паролю для номера телефона компании.
В качестве альтернативы, дайджест-аутентификацию можно отключить на SIP-сервере, хотя это НЕ рекомендуется с точки зрения обеспечения безопасности.
Почему мой SIP-сервер отвечает ошибкой 488 Not Acceptable Here?
Обратитесь к документации SIP-сервера или к производителю. Вероятная причина заключается в том, что SIP-сервер не поддерживает протокол WebRTC ICE (Interactive Connectivity Establishment). Для решения этой проблемы настройте номер корпоративного телефона на использование SDES .
Обязательно ли регистрировать номер телефона компании через SIP-сервер Meta?
Нет. Не отправляйте запросы REGISTER на SIP-сервер Meta. Это приведет к излишнему потреблению ресурсов с обеих сторон. Запросы REGISTER завершатся ошибкой 403 Forbidden. Таким образом, SIP-сервер Meta владеет только доменом meta.vc, и единственными пользователями SIP в этом домене являются обычные пользователи WhatsApp. Бизнес-номера WhatsApp принадлежат SIP-домену, настроенному с помощью API настроек .
Поддерживает ли Meta повторные SIP-приглашения (reINVITE)?
Нет. Повторные приглашения (Re-INVITES) в настоящее время не поддерживаются. Сервер Meta SIP возвращает ошибку 500 Internal Server Error.
Насколько хороши звонки по протоколу SIP по сравнению с вариантом использования API/вебхука Cloud Graph? Есть ли основания выбрать один из них?
Да, между двумя вариантами существует функциональное сходство. Лучший способ определить оптимальный вариант — провести тщательную оценку и сделать выбор, исходя из потребностей.
Если для звонков используется SIP, нужны ли веб-хуки?
Протокол SIP для звонков охватывает только события, специфичные для конкретного вызова. Для обмена сообщениями или любых событий, не связанных с вызовом, по-прежнему необходимо использовать веб-хуки.
Есть ли у Meta конкретный утвержденный список поставщиков или SBC для SIP?
Нет. Любой совместимый SIP-сервер.
Комментарии отсутствуют
Комментарии отсутствуют