Open in
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/16alebo dlhším (IPv6/48alebo 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áti409.
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.coms číslom v URI požiadavky aj v hlavičkeTo. 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-RouteTypeaX-RouteValueskriptu určujú, kam má volajúceho odoslať, v tomto prípade do zručnosti Support. Medzi hodnoty preX-RouteType, ktoré dokumentujú iní poskytovatelia, patriaSkillTransfer,PhoneTransfer,HangupaDispositionOnly; dohodnite hodnoty s osobou, ktorá spravuje skript. Pre viacero cieľov pridajte jedno vrátenie pre každý cieľ s iným názvom aX-RouteValue.X-RouteReasonobsahuje štítok zámeru agenta, napríkladbilling_dispute.X-CustomMetaDataobsahuje identifikátor odovzdania.BYEho obsahuje aj akoX-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
BYEa nespomína prijatie správyREFER, takže spätné odovzdanie je studené presmerovanie vykonané skriptom. - Five9 číta
X-RouteType,X-RouteValue,X-RouteReasonaX-CustomMetaData, nieUser-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.