ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

Povežite se iz Five9

Šaljite Five9 pozive glasovnom agentu ThunderPhone putem SIP-a uz AI Agent Connect i primajte ih natrag sa zaglavljima za usmjeravanje koja čita vaša IVR skripta.

Vaša Five9 IVR skripta šalje pozivatelja glasovnom agentu zajedno s Five9 detaljima poziva. Kada glasovni agent završi, prekida poziv sa zaglavljima za usmjeravanje u SIP poruci BYE, koja skripta čita u varijable poziva radi usmjeravanja pozivatelja.

Prije početka

  • ThunderPhone glasovni agent i organizacijski API ključ.
  • Five9 dodatak AI Agent Connect. Five9 ga ograničava na akreditirane pružatelje AI usluga, a Five9 implementacijski tim ga postavlja: uvozi predložak IVR skripte pružatelja, stvara varijable poziva i usmjerava modul skripte Prijenos trećoj strani na pružatelja. ThunderPhone još nije na Five9 popisu akreditiranih pružatelja: obratite se svojem Five9 timskom računu ili ThunderPhone podršci prije nego što ga uključite u svoje planove.

1. Izradite SIP krajnju točku

Five9 modul za prijenos trećoj strani bira telefonski broj, a ne SIP adresu, a Five9 integracije drugih pružatelja provjeravaju autentičnost Five9 prema izvornoj adresi, a ne lozinkom. Zato izradite krajnju točku ip_allowlist s brojem koji će Five9 birati kao brojem za dolazne pozive (pogledajte Platforme koje biraju telefonski broj):

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: rasponi SIP signalizacije vaših Five9 podatkovnih centara, koje dobivate od Five9. Svaki mora biti javni IPv4 raspon /16 ili uži (IPv6 /48 ili uži).
  • dial_in_numbers: broj koji će Five9 skripta birati, zapisan onako kako ga Five9 šalje. Ne mora biti stvarni telefonski broj. Ne smije se već koristiti u ThunderPhoneu, kao telefonski broj ili na drugoj krajnjoj točki: u tom se slučaju vraća 409.

Five9 adrese zajedničke su svim njegovim korisnicima, pa svaki drugi Five9 korisnik koji bira taj broj dolazi do vašeg glasovnog agenta. Kada birate broj, odaberite dugačak broj koji nitko ne bi pogodio (do 15 znamenki), provjerite šalje li ga Five9 u ThunderPhone, a ne u telefonsku mrežu, i nemojte ga objavljivati.

2. Šaljite pozive s kontekstom

Zatražite od Five9 implementacijskog tima da:

  • Pošalje poziv iz modula Prijenos trećoj strani na sip:+14155550188@sip.thunderphone.com, s brojem i u URI-ju zahtjeva i u zaglavlju To. Modul preuzima broj, dok se SIP domena pružatelja nalazi u zaglavlju.
  • Pošalje ga putem TLS-a (priključak 5061) ili TCP-a (priključak 5060). Krajnja točka odbija UDP, a Five9 ne objavljuje koji prijenos koristi, pa provjerite da nije UDP.
  • Uključi Povratak nakon poziva trećoj strani, kako bi se skripta nastavila kada glasovni agent prekine poziv (Five9 dopušta do 3.600 sekundi za poziv trećoj strani).

Five9 vodič navodi vrijednosti koje šalje (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name i druge), ali ne i nazive njihovih zaglavlja. Five9 integracije drugih pružatelja AI usluga ih u SIP prometu dokumentiraju kao X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign i X-AgentID; provjerite ih pri prvom testnom pozivu. Svaka dolazi do prompta kao varijabla, primjerice {{sip_x_callcampaign}}. X-CallID se pohranjuje kao external_call_id poziva.

3. Vratite poziv

Agent vraća poziv: pozdravlja se i prekida vezu, a BYE sadrži četiri zaglavlja koja čita skripta Five9. Dodajte ovaj broj za preusmjeravanje (pogledajte Dodajte broj za preusmjeravanje):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType i X-RouteValue skripti određuju kamo usmjeriti pozivatelja, u ovom slučaju na vještinu Support. Vrijednosti za X-RouteType koje dokumentiraju drugi pružatelji uključuju SkillTransfer, PhoneTransfer, Hangup i DispositionOnly; dogovorite vrijednosti s osobom koja održava skriptu. Za više odredišta dodajte po jedan povratni prijenos za svako odredište s drugim nazivom i X-RouteValue.
  • X-RouteReason sadrži oznaku namjere agenta, kao što je billing_dispute.
  • X-CustomMetaData sadrži ID predaje. BYE ga također sadrži kao X-TP-Handoff-Id, koji Five9 ne čita.

Skripta Five9 preslikava četiri zaglavlja u varijable poziva. Za sažetak agenta neka skripta pozove dohvat podataka o predaji pomoću modula IVR Upit: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= nakon čega slijedi call.call_id, s profilom autorizacije koji šalje Authorization: Bearer i vaš API ključ. Pogledajte Dohvat predanog poziva.

Testirajte

Nazovite IVR skriptu, zatražite od agenta razgovor s osobom i provjerite usmjerava li skripta pozivatelja s popunjenim varijablama poziva. Ako poziv nikada ne stigne do agenta, provjerite odgovara li broj u URI-ju zahtjeva i zaglavlju To broju za biranje, nalazi li se izvorna adresa Five9 u allowed_source_cidrs i je li poziv stigao putem TCP-a ili TLS-a. Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: sip_headers trebao bi navesti x-callid, a external_call_id trebao bi odgovarati vrijednosti call.call_id u Five9.

Ograničenja

  • Vodič za Five9 dokumentira podatke o usmjeravanju u poruci BYE i ne spominje prihvaćanje poruke REFER, pa je povratni prijenos hladno preusmjeravanje koje izvršava skripta.
  • Five9 čita X-RouteType, X-RouteValue, X-RouteReason i X-CustomMetaData, a ne User-to-User. ThunderPhone šalje svaku vrijednost zaglavlja duljine najviše 256 bajtova.
  • Five9 preporučuje zadržati broj prilagođenih zaglavlja na otprilike deset kako bi se izbjegla fragmentacija paketa.