ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Contact centers

Свързване от Genesys Cloud

Изпращайте обаждания от Genesys Cloud към агент на ThunderPhone през BYOC Cloud trunk с идентификатора на разговора и UUI и ги връщайте обратно с прехвърлянето в UUI.

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

Преди да започнете

  • Агент на ThunderPhone и организационен API ключ.
  • Genesys Cloud с BYOC Cloud и външен trunk (тип BYOC Carrier или PBX) със включени следните настройки (настройки на външен trunk):
    • Заглавки на разговорите, за да изпраща 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 от отговора веднага; той се показва само веднъж. В trunk-а:

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

Добавете trunk-а към изходящ маршрут на вашия сайт, чийто план за номера покрива адреса, който потокът набира.

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}}.

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

3. Приемете обаждането обратно

Агентът прехвърля с REFER към адрес в Genesys, като идентификаторът на предаването е в hex 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 приема обаждането обратно от trunk-а и го маршрутизира към този адрес. 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 се съкращава, за да се побере. Идентификаторът за прехвърляне винаги се побира.