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

Contact centers

Подключение из Genesys Cloud

Направляйте звонки Genesys Cloud агенту ThunderPhone через транк BYOC Cloud с идентификатором разговора и UUI, а затем возвращайте их обратно с передачей в UUI.

Ваш сценарий Architect направляет звонящего к агенту через транк BYOC Cloud вместе с идентификатором разговора и любыми заданными данными UUI. Когда звонящему нужен человек, агент отправляет SIP REFER, Genesys возвращает вызов, а идентификатор передачи поступает в UUI вызова.

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

  • Агент ThunderPhone и ключ API организации.
  • Genesys Cloud с BYOC Cloud и внешним транком (типа BYOC Carrier или PBX) со следующими включёнными настройками (настройки внешнего транка):
    • Заголовки разговора, чтобы Genesys отправлял идентификатор разговора в x-inin-cnv. По умолчанию эта настройка выключена.
    • Передача UUI, с типом заголовка User-To-User и кодировкой Hex.
    • Возврат и перевод, чтобы Genesys принимал REFER агента.

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

Genesys отвечает на digest-запрос, поэтому используйте стандартную конечную точку:

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": "Genesys Cloud"}'

Сразу сохраните password из ответа: он отображается только один раз. На транке:

НастройкаЗначение
SIP-серверsip.thunderphone.com, порт 5061
ПротоколTLS
Digest-аутентификацияusername и password конечной точки
КодекиPCMU, PCMA или G.722

Добавьте транк в исходящий маршрут вашего сайта, план нумерации которого охватывает адрес, на который выполняет набор сценарий.

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

В сценарии Architect:

  1. При необходимости добавьте действие Задать данные UUI с контекстом для агента, например account=12345. Genesys рекомендует использовать не более 128 символов.
  2. Добавьте действие Перевести на номер с sip_uri конечной точки, например sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys отправляет идентификатор разговора в x-inin-cnv. ThunderPhone сохраняет его как external_call_id вызова. UUI поступает в промпт в декодированном виде как {{sip_uui}}.

Пользовательские заголовки транка статичны в Genesys, поэтому передавайте значения для каждого вызова в UUI. Genesys резервирует для себя префиксы заголовков x-inin, x-genesys, x-pcv и x-gcv.

3. Верните вызов

Агент выполняет перевод с помощью REFER на адрес в Genesys, содержащий идентификатор передачи в виде шестнадцатеричного UUI. Добавьте этот номер перевода (см. Добавление номера перевода и Заголовки в адресе перевода):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Замените адрес на тот, который направляет вызов обратно в очередь или сценарий, принимающий звонящего; уточните его формат в Genesys. REFER выглядит так:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

При включённой настройке Возврат и перевод Genesys возвращает вызов с транка и направляет его на этот адрес. Согласно документации Genesys, входящий UUI поступает в Call.UUIData; для возврата вызова это не задокументировано, поэтому уточните в Genesys или проверьте тестовым вызовом, что сценарий, принимающий звонящего, находит там идентификатор передачи. Чтобы получить сводку и намерение, вызовите поиск передачи с помощью Действия с данными вызова в интеграции Web Services Data Actions:

  • Запрос: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= с последующим идентификатором из Call.UUIData.
  • Учётные данные: ваш ключ API, передаваемый как Authorization: Bearer sk_live_….
  • Вывод: сопоставьте handoff.summary и handoff.intent с переменными сценария.

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

Проверьте

Позвоните на номер, ведущий к сценарию, попросите агента соединить с человеком и проверьте, что Genesys направляет вызов на указанный вами адрес. В этом сценарии проверьте, что Call.UUIData содержит идентификатор передачи как текст (если отображаются шестнадцатеричные цифры, проверьте, что кодировка UUI транка установлена в Hex). Затем откройте вызов с помощью GET /v1/calls/{call_id}: external_call_id должен содержать идентификатор разговора.

Ограничения

  • Действие Получить SIP-заголовки считывает только исходный INVITE, поэтому оно не может считывать данные из REFER агента. Передача достигает Genesys только через UUI.
  • Genesys отбрасывает все UUI, если вызов содержит более одного заголовка UUI.
  • Адрес передачи ограничен 254 символами, поэтому длинный UUI обрезается до допустимой длины. Идентификатор передачи всегда помещается.