Open in
Свързване от 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от агента.
- Заглавки на разговорите, за да изпраща 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 от отговора веднага; той се показва само веднъж. В trunk-а:
| Настройка | Стойност |
|---|---|
| SIP сървър | sip.thunderphone.com, порт 5061 |
| Протокол | TLS |
| Digest удостоверяване | username и password на крайната точка |
| Кодеци | PCMU, PCMA или G.722 |
Добавете trunk-а към изходящ маршрут на вашия сайт, чийто план за номера покрива адреса, който потокът набира.
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}}.
Персонализираните заглавки на 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 се съкращава, за да се побере. Идентификаторът за прехвърляне винаги се побира.