Open in
Opret forbindelse fra Five9
Send Five9-opkald til en ThunderPhone-agent via SIP med AI Agent Connect, og få dem tilbage med routing-headere, som dit IVR-script læser.
Dit Five9-IVR-script sender opkalderen til agenten med Five9s
opkaldsoplysninger. Når agenten er færdig, afslutter den opkaldet med routingheadere i SIP
BYE, som scriptet læser ind i opkaldsvariabler for at dirigere opkalderen.
Før du starter
- En ThunderPhone-agent og en organisatorisk API-nøgle.
- Five9s tilføjelse AI Agent Connect. Five9 begrænser den til AI-udbydere, som de har godkendt, og Five9s implementeringsteam konfigurerer den: Det importerer udbyderens IVR-scriptsskabelon, opretter opkaldsvariablerne og peger scriptets Tredjepartsoverførsel-modul på udbyderen. ThunderPhone er endnu ikke på Five9s liste over godkendte udbydere: Spørg dit Five9-kontoteam eller ThunderPhone support, før du planlægger ud fra det.
1. Opret SIP-slutpunktet
Five9s Tredjepartsoverførsel-modul ringer et telefonnummer op, ikke en SIP-adresse,
og andre udbyderes Five9-integrationer autentificerer Five9 efter kildeadresse
frem for en adgangskode. Opret derfor et ip_allowlist-slutpunkt med det nummer,
Five9 vil ringe op til, som et indringningsnummer (se
Platforme, der ringer et telefonnummer op):
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-signaleringsintervallerne for dine Five9-datacentre, fra Five9. Hvert interval skal være et offentligt IPv4-interval på/16eller smallere (IPv6/48eller smallere).dial_in_numbers: nummeret, som Five9s script vil ringe op til, skrevet på den måde, Five9 sender det på. Det behøver ikke være et rigtigt telefonnummer. Det må ikke allerede være i brug på ThunderPhone, hverken som telefonnummer eller på et andet slutpunkt: Det giver409.
Five9s adresser deles af alle deres kunder, så enhver anden Five9-kunde, der ringer nummeret op, når din agent. Når du vælger nummeret, skal du vælge et langt nummer, som ingen ville gætte (op til 15 cifre), sikre, at Five9 sender det til ThunderPhone i stedet for ud til telefonnettet, og ikke offentliggøre det.
2. Send opkald med kontekst
Bed Five9s implementeringsteam om at:
- Sende opkaldet fra modulet Tredjepartsoverførsel til
sip:+14155550188@sip.thunderphone.commed nummeret i både anmodnings-URI'en ogTo-headeren. Modulet tager nummeret med udbyderens SIP-domæne i en header. - Sende det via TLS (port 5061) eller TCP (port 5060). Slutpunktet afviser UDP, og Five9 oplyser ikke, hvilken transport det bruger, så sørg for, at det ikke er UDP.
- Slå Returner efter tredjepartskald til, så scriptet fortsætter, når agenten afslutter opkaldet (Five9 tillader op til 3.600 sekunder for tredjepartskaldet).
Five9s vejledning angiver de værdier, den sender (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name og andre), men ikke deres
headernavne. Andre AI-udbyderes Five9-integrationer dokumenterer dem på netværket
som X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
og X-AgentID; kontrollér dem ved dit første testopkald. Hver værdi når prompten som en variabel, f.eks.
{{sip_x_callcampaign}}. X-CallID gemmes som opkaldets
external_call_id.
3. Få opkaldet tilbage
Agenten returnerer opkaldet: Den siger farvel og lægger på, og BYE indeholder
de fire headers, som Five9-scriptet læser. Tilføj dette overførselsnummer (se
Tilføj overførselsnummeret):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeogX-RouteValuefortæller scriptet, hvor opkalderen skal sendes hen, her Support-færdigheden. Værdier, som andre udbydere dokumenterer forX-RouteType, omfatterSkillTransfer,PhoneTransfer,HangupogDispositionOnly; aftal værdierne med den, der vedligeholder scriptet. For flere destinationer skal du tilføje én returnering pr. destination med et andet navn og en andenX-RouteValue.X-RouteReasonindeholder agentens intent-label, f.eks.billing_dispute.X-CustomMetaDataindeholder overdragelses-id'et.BYEindeholder det også somX-TP-Handoff-Id, hvilket Five9 ikke læser.
Five9-scriptet mapper de fire headers til opkaldsvariabler. For agentens
opsummering skal scriptet kalde opslaget for overdragelser med et IVR-modul af typen Forespørgsel:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= efterfulgt af
call.call_id, med en autoriseringsprofil, der sender
Authorization: Bearer og din API-nøgle. Se
Slå et overdraget opkald op.
Test det
Ring ind til IVR-scriptet, bed agenten om en person, og kontrollér, at scriptet
ruter opkalderen med de udfyldte opkaldsvariabler. Hvis opkaldet aldrig når
agenten, skal du kontrollere, at nummeret i anmodnings-URI'en og To-headeren matcher
indringningsnummeret, at Five9's kildeadresse findes i allowed_source_cidrs, og
at opkaldet kom over TCP eller TLS. Åbn derefter opkaldet med
GET /v1/calls/{call_id}: sip_headers skal indeholde x-callid, og
external_call_id skal matche call.call_id i Five9.
Begrænsninger
- Five9's vejledning dokumenterer routingdata i
BYEog nævner ikke accept af enREFER, så tilbageleveringen er en kold viderestilling udført af scriptet. - Five9 læser
X-RouteType,X-RouteValue,X-RouteReasonogX-CustomMetaData, ikkeUser-to-User. ThunderPhone sender hver headerværdi med en maksimal længde på 256 byte. - Five9 anbefaler at holde antallet af brugerdefinerede headers på omkring ti for at undgå pakkefragmentering.