ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Contact centers

Подключение из Microsoft Dynamics 365

Направляйте звонки Dynamics 365 Contact Center и Copilot Studio агенту ThunderPhone через ваш SBC с X-заголовками и запрашивайте передачу звонка агентом по HTTP.

Dynamics 365 Contact Center направляет звонящего к агенту через ваш контроллер границы сеанса (SBC), передавая до пяти X-заголовков, включая идентификатор диалога. Когда агент завершает звонок, ваш SBC возвращает звонящего в Dynamics 365, а узел HTTP-запроса получает данные передачи.

Перед началом работы

  • Агент ThunderPhone и ключ API организации.
  • Голосовой канал Dynamics 365 Contact Center, подключенный через Azure Communication Services прямую маршрутизацию к управляемому вами SBC (требования к SBC): поддерживаемый SBC с общедоступным сертификатом, TLS 1.2 на порту 5061 и SRTP в направлении Microsoft.
  • Поддержка SIP X-заголовков в узле Передача беседы (Copilot Studio). Убедитесь, что она доступна в вашей среде.

Dynamics 365 передает вызовы только на номер телефона, а Microsoft проверяет подлинность для прямой маршрутизации по сертификату, а не по паролю. Ваш SBC располагается между Microsoft и ThunderPhone и преобразует этот номер в SIP-адрес агента.

1. Создайте SIP-конечную точку

Вызов поступает в ThunderPhone с вашего SBC, поэтому создайте обычную конечную точку для использования SBC:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Dynamics 365 SBC"}'

Сразу сохраните password из ответа: он отображается один раз, и ваш SBC отвечает им на запрос проверки ThunderPhone. Если ваш SBC не поддерживает дайджест-аутентификацию, вместо этого создайте конечную точку с auth, установленным в ip_allowlist, и общедоступным адресом вашего SBC; см. Платформы, выполняющие аутентификацию по исходному IP-адресу.

2. Отправляйте вызовы с контекстом

  1. Выберите на SBC номер телефона для агента, например +14155550188.
  2. На SBC направьте вызовы на этот номер к sip_uri конечной точки, например sip:agent-12-jhxmginwjx@sip.thunderphone.com, по TLS на порту 5061. ThunderPhone находит конечную точку по пользовательской части (agent-12-jhxmginwjx), которая должна быть указана и в URI запроса, и в заголовке To. Передавайте X-заголовки без изменений.
  3. В Copilot Studio добавьте узел Передача беседы с параметром Перенаправление на внешний номер телефона на этот номер и добавьте X-заголовки:
    • X-Call-ID: идентификатор диалога Dynamics 365. Ни один заголовок Microsoft его не содержит, поэтому добавьте его здесь; ThunderPhone сохраняет его как external_call_id вызова. Уточните в Copilot Studio, какая переменная содержит идентификатор диалога.
    • До четырех дополнительных заголовков, например X-Customer-Tier.

Microsoft отправляет не более пяти X-заголовков с именами длиной до 64 символов и значениями длиной до 256 символов, используя буквы, цифры и = ; . ! % * _ + ~ -. Префикс записывается в нижнем регистре как x-; ThunderPhone сопоставляет имена заголовков без учета регистра, поэтому x-customer-tier попадает в промпт как {{sip_x_customer_tier}}.

Если вместо этого вы создаете вызов с помощью Azure Communication Services Call Automation, AddSipX по умолчанию записывает имена X-MS-Custom-. Передайте SipHeaderPrefix.X, чтобы X-Call-ID сохранил свое имя (пользовательский контекст).

3. Верните звонящего

Агент возвращает звонящего: прощается и завершает вызов. Добавьте этот номер перевода (см. Добавление номера перевода):

{"name": "Dynamics 365", "action": "return"}

Возврат звонящего в Dynamics 365 — задача вашего SBC. Microsoft документирует один способ входящего вызова с контекстом: новый вызов через SBC на номер, зарегистрированный в Dynamics 365, с UUI, ключи которого соответствуют переменным контекста, настроенным в разделе Рабочие потоки → Расширенные настройки (перевод через стороннюю IVR). Согласуйте с поставщиком SBC, как звонящий попадёт на этот номер после того, как ThunderPhone завершит вызов, и передавайте идентификатор беседы, который вы отправили в X-Call-ID, чтобы поток мог найти вызов.

Затем получите данные передачи с помощью узла Copilot Studio HTTP-запрос:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= с идентификатором беседы после знака равенства.
  • Заголовок Authorization: Bearer sk_live_….
  • Разберите ответ в переменную и используйте handoff.summary и handoff.intent.

См. Поиск переданного вызова.

Проверьте работу

Позвоните на номер Dynamics 365, который ведёт к узлу перевода, попросите агента соединить с человеком и убедитесь, что звонящий возвращается в Dynamics 365. Затем откройте вызов с помощью GET /v1/calls/{call_id}: в sip_headers должен быть указан x-call-id, а external_call_id должен содержать идентификатор беседы. Если вызов не доходит до агента и в журналах SBC есть SIP 404, URI запроса или заголовок To не содержит пользовательскую часть конечной точки.

Ограничения

  • Требуется SBC. Microsoft не может набрать SIP-адрес или ответить на digest challenge.
  • Microsoft отправляет не более пяти X-заголовков и сохраняет только первые пять во входящем вызове. Dynamics 365 принимает не более 128 символов UUI.
  • Microsoft не документирует чтение заголовков при BYE, поэтому данные передачи можно получить только через поиск.