Open in
Подключение из 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. Отправляйте вызовы с контекстом
- Выберите на SBC номер телефона для агента, например
+14155550188. - На SBC направьте вызовы на этот номер к
sip_uriконечной точки, напримерsip:agent-12-jhxmginwjx@sip.thunderphone.com, по TLS на порту5061. ThunderPhone находит конечную точку по пользовательской части (agent-12-jhxmginwjx), которая должна быть указана и в URI запроса, и в заголовкеTo. Передавайте X-заголовки без изменений. - В 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, поэтому данные передачи можно получить только через поиск.