ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Contact centers

Повежите се из Five9

Шаљите Five9 позиве ThunderPhone агенту преко SIP-а помоћу AI Agent Connect-а и враћајте их са заглављима за усмеравање која чита ваша IVR скрипта.

Ваша Five9 IVR скрипта шаље позиваоца агенту заједно са Five9 детаљима позива. Када агент заврши, прекида везу са заглављима за рутирање у SIP BYE, која скрипта учитава у променљиве позива да би усмерила позиваоца.

Пре него што почнете

  • ThunderPhone агент и API кључ организације.
  • Five9 додатак Повезивање AI агента. Five9 га ограничава на AI добављаче које је одобрио, а Five9 тим за имплементацију га подешава: увози шаблон IVR скрипте добављача, креира променљиве позива и усмерава модул скрипте Пренос трећој страни на добављача. ThunderPhone још није на листи одобрених добављача Five9: обратите се свом Five9 тиму за налог или ThunderPhone подршци пре него што заснујете планове на томе.

1. Креирајте SIP крајњу тачку

Five9 модул за пренос трећој страни позива телефонски број, а не SIP адресу, а Five9 интеграције других добављача потврђују Five9 на основу изворне адресе уместо лозинке. Зато креирајте ip_allowlist крајњу тачку са бројем који ће Five9 позивати као бројем за позивање (погледајте Платформе које позивају телефонски број):

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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: SIP сигнализациони опсези ваших Five9 центара података, које добијате од Five9. Сваки мора бити јавни IPv4 опсег /16 или ужи (IPv6 /48 или ужи).
  • dial_in_numbers: број који ће Five9 скрипта позивати, написан онако како га Five9 шаље. Не мора бити стварни телефонски број. Не сме већ бити у употреби у ThunderPhone-у, као телефонски број или на другој крајњој тачки: то враћа 409.

Five9 адресе деле сви његови корисници, па сваки други Five9 корисник који позове тај број стиже до вашег агента. Ако Ви бирате број, изаберите дугачак број који нико не би погодио (до 15 цифара), уверите се да га Five9 шаље у ThunderPhone, а не у телефонску мрежу, и немојте га објављивати.

2. Шаљите позиве са контекстом

Затражите од Five9 тима за имплементацију да:

  • Пошаље позив из модула Пренос трећој страни на sip:+14155550188@sip.thunderphone.com, са бројем и у URI-ју захтева и у заглављу To. Модул преузима број, а SIP домен добављача ставља у заглавље.
  • Шаље преко TLS-а (порт 5061) или TCP-а (порт 5060). Крајња тачка одбија UDP, а Five9 не објављује који транспорт користи, зато се уверите да није UDP.
  • Укључи Повратак након позива трећој страни, како би скрипта наставила када агент прекине везу (Five9 дозвољава до 3,600 секунди за позив трећој страни).

Five9 водич наводи вредности које шаље (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name и друге), али не и називе њихових заглавља. Five9 интеграције других AI добављача документују их у SIP саобраћају као X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign и X-AgentID; проверите их током првог тестног позива. Свака вредност доспева у упит као променљива, на пример {{sip_x_callcampaign}}. X-CallID се чува као external_call_id позива.

3. Вратите позив

Агент враћа позив: поздравља се и прекида везу, а BYE садржи четири заглавља која Five9 скрипта чита. Додајте овај број за трансфер (погледајте Додајте број за трансфер):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType и X-RouteValue говоре скрипти где да усмери позиваоца, овде на вештину Подршка. Вредности које други добављачи документују за X-RouteType укључују SkillTransfer, PhoneTransfer, Hangup и DispositionOnly; договорите вредности са особом која одржава скрипту. За више одредишта додајте по један повратак за свако одредиште са другим називом и вредношћу X-RouteValue.
  • X-RouteReason садржи ознаку намере агента, као што је billing_dispute.
  • X-CustomMetaData садржи ид предаје. BYE га такође садржи као X-TP-Handoff-Id, који Five9 не чита.

Five9 скрипта пресликава четири заглавља у променљиве позива. За сажетак агента, нека скрипта позове претрагу предаје помоћу IVR модула Упит: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= након чега следи call.call_id, са профилом ауторизације који шаље Authorization: Bearer и Ваш API кључ. Погледајте Потражите предати позив.

Тестирајте

Позовите IVR скрипту, затражите од агента да Вас повеже са особом и проверите да ли скрипта усмерава позиваоца са попуњеним променљивама позива. Ако позив никада не стигне до агента, проверите да ли се број у URI-ју захтева и заглављу To подудара са бројем за позивање, да ли се изворна адреса Five9 налази у allowed_source_cidrs и да ли је позив стигао преко TCP-а или TLS-а. Затим отворите позив помоћу GET /v1/calls/{call_id}: sip_headers треба да садржи x-callid, а external_call_id треба да се подудара са call.call_id у Five9.

Ограничења

  • Five9 водич документује податке за усмеравање у BYE и не помиње прихватање REFER, па је повратни пренос хладан трансфер који извршава скрипта.
  • Five9 чита X-RouteType, X-RouteValue, X-RouteReason и X-CustomMetaData, а не User-to-User. ThunderPhone шаље сваку вредност заглавља дужине највише 256 бајтова.
  • Five9 препоручује да задржите око десет прилагођених заглавља како бисте избегли фрагментацију пакета.