ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

Pripojenie z Five9

Odosielajte hovory z Five9 hlasovému agentovi ThunderPhone cez SIP pomocou AI Agent Connect a získajte ich späť so smerovacími hlavičkami, ktoré číta váš IVR skript.

Skript IVR vo Five9 odošle volajúceho k agentovi s údajmi o hovore z Five9. Keď hlasový agent skončí, ukončí hovor so smerovacími hlavičkami v SIP BYE, ktoré skript načíta do premenných hovoru na presmerovanie volajúceho.

Skôr než začnete

  • Agent ThunderPhone a kľúč API organizácie.
  • Doplnok Five9 Pripojenie AI agenta. Five9 ho obmedzuje na poskytovateľov AI, ktorých schválil, a implementačný tím Five9 ho nastavuje: importuje šablónu skriptu IVR poskytovateľa, vytvorí premenné hovoru a nasmeruje modul skriptu Prenos tretej strany na poskytovateľa. ThunderPhone zatiaľ nie je na zozname schválených poskytovateľov Five9: pred plánovaním tejto integrácie sa obráťte na svoj tím pre účet Five9 alebo podporu ThunderPhone.

1. Vytvorte koncový bod SIP

Modul Five9 Prenos tretej strany vytáča telefónne číslo, nie adresu SIP, a integrácie Five9 iných poskytovateľov overujú Five9 podľa zdrojovej adresy namiesto hesla. Preto vytvorte koncový bod ip_allowlist s číslom, ktoré bude Five9 vytáčať, ako číslom pre prichádzajúce hovory (pozrite si Platformy, ktoré vytáčajú telefónne číslo):

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: rozsahy signalizácie SIP vašich dátových centier Five9, ktoré poskytne Five9. Každý musí byť verejný rozsah IPv4 s prefixom /16 alebo dlhším (IPv6 /48 alebo dlhším).
  • dial_in_numbers: číslo, ktoré bude skript Five9 vytáčať, zapísané v podobe, v akej ho Five9 odosiela. Nemusí ísť o skutočné telefónne číslo. Nesmie sa už používať v ThunderPhone ako telefónne číslo ani v inom koncovom bode: v takom prípade sa vráti 409.

Adresy Five9 zdieľajú všetci jeho zákazníci, takže každý iný zákazník Five9, ktorý vytočí toto číslo, sa dovolá vášmu agentovi. Pri výbere čísla zvoľte dlhé číslo, ktoré nikto neuhádne (až 15 číslic), uistite sa, že ho Five9 odosiela do ThunderPhone a nie do telefónnej siete, a nezverejňujte ho.

2. Odosielajte hovory s kontextom

Požiadajte implementačný tím Five9, aby:

  • Odosielal hovor z modulu Prenos tretej strany na sip:+14155550188@sip.thunderphone.com s číslom v URI požiadavky aj v hlavičke To. Modul používa číslo s doménou SIP poskytovateľa v hlavičke.
  • Odosielal ho cez TLS (port 5061) alebo TCP (port 5060). Koncový bod odmieta UDP a Five9 nezverejňuje, ktorý prenos používa, preto sa uistite, že nejde o UDP.
  • Zapol Návrat po volaní tretej strany, aby skript pokračoval, keď agent ukončí hovor (Five9 povoľuje pri hovore tretej strany až 3 600 sekúnd).

Sprievodca Five9 uvádza hodnoty, ktoré odosiela (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name a ďalšie), nie názvy ich hlavičiek. Integrácie Five9 iných poskytovateľov AI ich v prenose dokumentujú ako X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign a X-AgentID; overte ich pri prvom testovacom hovore. Každá sa v prompte zobrazí ako premenná, napríklad {{sip_x_callcampaign}}. X-CallID sa uloží ako external_call_id hovoru.

3. Vráťte hovor

Agent hovor vráti: rozlúči sa a zavesí a BYE obsahuje štyri hlavičky, ktoré skript Five9 číta. Pridajte toto číslo na presmerovanie (pozrite si Pridanie čísla na presmerovanie):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType a X-RouteValue skriptu určujú, kam má volajúceho odoslať, v tomto prípade do zručnosti Support. Medzi hodnoty pre X-RouteType, ktoré dokumentujú iní poskytovatelia, patria SkillTransfer, PhoneTransfer, Hangup a DispositionOnly; dohodnite hodnoty s osobou, ktorá spravuje skript. Pre viacero cieľov pridajte jedno vrátenie pre každý cieľ s iným názvom a X-RouteValue.
  • X-RouteReason obsahuje štítok zámeru agenta, napríklad billing_dispute.
  • X-CustomMetaData obsahuje identifikátor odovzdania. BYE ho obsahuje aj ako X-TP-Handoff-Id, ktorý Five9 nečíta.

Skript Five9 mapuje štyri hlavičky do premenných hovoru. Pre súhrn od agenta nechajte skript zavolať vyhľadanie odovzdania pomocou modulu IVR Dopyt: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= nasledovaného call.call_id, s profilom autorizácie, ktorý odosiela Authorization: Bearer a váš kľúč API. Pozrite si Vyhľadanie odovzdaného hovoru.

Otestujte to

Zavolajte do skriptu IVR, požiadajte agenta o spojenie s osobou a overte, že skript smeruje volajúceho s vyplnenými premennými hovoru. Ak hovor nikdy nedorazí k agentovi, overte, že číslo v identifikátore URI požiadavky a hlavičke To zodpovedá číslu na vytáčanie, že zdrojová adresa Five9 je v allowed_source_cidrs a že hovor prišiel cez TCP alebo TLS. Potom otvorte hovor pomocou GET /v1/calls/{call_id}: sip_headers by mali obsahovať x-callid a external_call_id by mal zodpovedať call.call_id vo Five9.

Obmedzenia

  • Príručka Five9 dokumentuje údaje o smerovaní v správe BYE a nespomína prijatie správy REFER, takže spätné odovzdanie je studené presmerovanie vykonané skriptom.
  • Five9 číta X-RouteType, X-RouteValue, X-RouteReason a X-CustomMetaData, nie User-to-User. ThunderPhone odosiela každú hodnotu hlavičky s dĺžkou najviac 256 bajtov.
  • Five9 odporúča ponechať počet vlastných hlavičiek približne na desiatich, aby sa predišlo fragmentácii paketov.