Open in
Подключение из 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агента.
- Заголовки разговора, чтобы Genesys отправлял идентификатор разговора в
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:
- При необходимости добавьте действие Задать данные UUI с контекстом для агента,
например
account=12345. Genesys рекомендует использовать не более 128 символов. - Добавьте действие Перевести на номер с
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 обрезается до допустимой длины. Идентификатор передачи всегда помещается.