Open in
Yhdistä Five9:stä
Lähetä Five9-puhelut ThunderPhone-agentille SIP:n kautta AI Agent Connectilla ja palauta ne reititysotsakkeilla, joita IVR-skriptisi lukee.
Five9:n IVR-komentosarja ohjaa soittajan agentille Five9:n puhelutietojen kanssa. Kun agentti on valmis, se katkaisee puhelun SIP-BYE-viestin reititysotsakkeilla, jotka komentosarja lukee puhelumuuttujiin soittajan reitittämistä varten.
Ennen kuin aloitat
- ThunderPhone-agentti ja organisaation API-avain.
- Five9:n AI Agent Connect -lisäosa. Five9 rajoittaa sen tekoälypalveluntarjoajiin, jotka se on hyväksynyt, ja Five9:n käyttöönottotiimi määrittää sen: se tuo palveluntarjoajan IVR-komentosarjamallin, luo puhelumuuttujat ja ohjaa komentosarjan Kolmannen osapuolen siirto -moduulin palveluntarjoajalle. ThunderPhone ei ole vielä Five9:n hyväksyttyjen palveluntarjoajien luettelossa: kysy Five9-asiakastiimiltäsi tai ThunderPhone-tuesta ennen kuin suunnittelet sen varaan.
1. Luo SIP-päätepiste
Five9:n Kolmannen osapuolen siirto -moduuli soittaa puhelinnumeroon, ei SIP-osoitteeseen, ja muiden palveluntarjoajien Five9-integraatiot todentavat Five9:n lähdeosoitteen eikä salasanan perusteella. Luo siis ip_allowlist-päätepiste ja määritä numero, johon Five9 soittaa, sisääntulonumeroksi (katso
Alustat, jotka soittavat puhelinnumeroon):
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: Five9:ltä saadut Five9-datakeskustesi SIP-signalointialueet. Jokaisen on oltava julkinen IPv4-alue, jonka maski on/16tai tarkempi (IPv6:/48tai tarkempi).dial_in_numbers: numero, johon Five9:n komentosarja soittaa, Five9:n lähettämässä muodossa. Sen ei tarvitse olla oikea puhelinnumero. Se ei voi olla jo käytössä ThunderPhonessa puhelinnumerona tai toisessa päätepisteessä: tällöin palautetaan409.
Five9:n osoitteet ovat kaikkien sen asiakkaiden yhteiskäytössä, joten kuka tahansa muu Five9-asiakas, joka soittaa numeroon, pääsee agentillesi. Kun valitset numeron, valitse pitkä numero, jota kukaan ei arvaisi (enintään 15 numeroa), varmista, että Five9 lähettää sen ThunderPhonelle eikä puhelinverkkoon, äläkä julkaise sitä.
2. Lähetä puhelut kontekstin kanssa
Pyydä Five9:n käyttöönottotiimiä:
- Lähettämään puhelu Kolmannen osapuolen siirto -moduulista osoitteeseen
sip:+14155550188@sip.thunderphone.comsiten, että numero on sekä pyyntö-URI:ssa ettäTo-otsakkeessa. Moduuli ottaa numeron vastaan palveluntarjoajan SIP-verkkotunnuksen ollessa otsakkeessa. - Lähettämään se TLS:n (portti 5061) tai TCP:n (portti 5060) kautta. Päätepiste hylkää UDP:n, eikä Five9 julkaise käyttämäänsä siirtotapaa, joten varmista, ettei se ole UDP.
- Ottamaan käyttöön Palaa kolmannen osapuolen puhelun jälkeen, jotta komentosarja jatkuu, kun agentti katkaisee puhelun (Five9 sallii kolmannen osapuolen puhelulle enintään 3 600 sekuntia).
Five9:n ohjeessa luetellaan sen lähettämät arvot (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name ja muut), mutta ei niiden
otsakenimiä. Muiden tekoälypalveluntarjoajien Five9-integraatioissa ne on dokumentoitu siirrettäviksi muodossa
X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
ja X-AgentID; tarkista ne ensimmäisessä testipuhelussasi. Kukin välittyy kehotteeseen muuttujana, kuten
{{sip_x_callcampaign}}. X-CallID tallennetaan puhelun
external_call_id-tunnukseksi.
3. Palauta puhelu
Agentti palauttaa puhelun: se sanoo hyvästit ja katkaisee puhelun, ja BYE sisältää
neljä otsaketta, jotka Five9:n skripti lukee. Lisää tämä siirtonumero (katso
Lisää siirtonumero):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypejaX-RouteValuekertovat skriptille, minne soittaja ohjataan, tässä tapauksessa Support-taitoon. Muut palveluntarjoajat dokumentoivatX-RouteType-arvolle esimerkiksiSkillTransfer,PhoneTransfer,HangupjaDispositionOnly; sovi arvoista skriptiä ylläpitävän henkilön kanssa. Jos kohteita on useita, lisää yksi palautus kohdetta kohden eri nimellä jaX-RouteValue-arvolla.X-RouteReasonsisältää agentin tarkoitustunnisteen, kutenbilling_dispute.X-CustomMetaDatasisältää luovutuksen tunnuksen.BYEsisältää sen myös muodossaX-TP-Handoff-Id, jota Five9 ei lue.
Five9:n skripti yhdistää neljä otsaketta puhelumuuttujiin. Agentin
yhteenvedon hakemista varten määritä skripti kutsumaan luovutushakua IVR:n Kysely-moduulilla:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ja sen perään
call.call_id, sekä Authorization Profile -profiililla, joka lähettää
Authorization: Bearer-otsakkeen ja API-avaimesi. Katso
Hae luovutettu puhelu.
Testaa
Soita IVR-skriptiin, pyydä agentilta henkilöä ja tarkista, että skripti
reitittää soittajan täytetyillä puhelumuuttujilla. Jos puhelu ei koskaan saavu
agentille, tarkista, että pyyntö-URI:n ja To-otsakkeen numero vastaa
soittonumeroa, että Five9:n lähdeosoite on allowed_source_cidrs-asetuksessa ja
että puhelu saapui TCP:n tai TLS:n kautta. Avaa sitten puhelu kutsulla
GET /v1/calls/{call_id}: sip_headers-kohdassa pitäisi näkyä x-callid, ja
external_call_id-arvon pitäisi vastata Five9:n call.call_id-arvoa.
Rajoitukset
- Five9:n ohje dokumentoi reititystiedot
BYE-viestissä eikä mainitseREFER-viestin hyväksymistä, joten palautus on skriptin tekemä kylmä siirto. - Five9 lukee
X-RouteType,X-RouteValue,X-RouteReasonjaX-CustomMetaData-otsakkeet, eiUser-to-User-otsaketta. ThunderPhone lähettää kunkin otsakearvon enintään 256 tavun pituisena. - Five9 suosittelee pitämään mukautettujen otsakkeiden määrän noin kymmenessä pakettien pirstoutumisen välttämiseksi.