Open in
Připojení z Five9
Odesílejte hovory z Five9 hlasovému agentovi ThunderPhone přes SIP pomocí AI Agent Connect a získávejte je zpět se směrovacími hlavičkami, které čte váš skript IVR.
Váš skript IVR ve Five9 předá volajícího hlasovému agentovi spolu s podrobnostmi hovoru z Five9. Když hlasový agent skončí, zavěsí s hlavičkami směrování v SIP
BYE, které skript načte do proměnných hovoru pro směrování volajícího.
Než začnete
- Agent ThunderPhone a klíč API organizace.
- Doplněk Five9 Připojení AI agenta. Five9 jej omezuje na poskytovatele AI, které akreditoval, a jeho implementační tým jej nastavuje: importuje šablonu skriptu IVR poskytovatele, vytvoří proměnné hovoru a nasměruje modul skriptu Přenos třetí straně na poskytovatele. ThunderPhone zatím není na seznamu akreditovaných poskytovatelů Five9: než s tím začnete počítat, obraťte se na svůj tým pro účet Five9 nebo podporu ThunderPhone.
1. Vytvořte koncový bod SIP
Modul Five9 pro přenos třetí straně vytáčí telefonní číslo, nikoli adresu SIP,
a integrace Five9 jiných poskytovatelů ověřují Five9 podle zdrojové adresy
namísto hesla. Vytvořte proto koncový bod ip_allowlist s číslem, které bude
Five9 vytáčet, jako číslem pro příchozí volání (viz
Platformy, které vytáčejí telefonní čí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 signalizace SIP datových center Five9, které získáte od Five9. Každý musí být veřejný rozsah IPv4 o velikosti/16nebo menší (IPv6/48nebo menší).dial_in_numbers: číslo, které bude vytáčet skript Five9, zapsané způsobem, jakým jej Five9 odesílá. Nemusí jít o skutečné telefonní číslo. Nesmí být již používáno v ThunderPhone, ani jako telefonní číslo, ani na jiném koncovém bodu: vrátí se409.
Adresy Five9 sdílejí všichni jeho zákazníci, takže jakýkoli jiný zákazník Five9, který toto číslo vytočí, se spojí s vaším hlasovým agentem. Při volbě čísla zvolte dlouhé číslo, které nikdo neuhodne (až 15 číslic), zajistěte, aby ho Five9 odesílal do ThunderPhone místo do telefonní sítě, a nezveřejňujte ho.
2. Odesílejte hovory s kontextem
Požádejte implementační tým Five9, aby:
- Odesílal hovor z modulu Přenos třetí straně na
sip:+14155550188@sip.thunderphone.com, přičemž číslo uvede v URI požadavku i v hlavičceTo. Modul používá číslo s doménou SIP poskytovatele v hlavičce. - Odesílal jej přes TLS (port 5061) nebo TCP (port 5060). Koncový bod odmítá UDP a Five9 neuvádí, jaký transport používá, proto ověřte, že nejde o UDP.
- Zapnul Návrat po volání třetí strany, aby skript pokračoval po zavěšení hlasového agenta (Five9 umožňuje u hovoru třetí strany až 3 600 sekund).
Průvodce Five9 uvádí hodnoty, které odesílá (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name a další), nikoli názvy
jejich hlaviček. Integrace Five9 jiných poskytovatelů AI je v signalizaci
dokumentují jako X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID,
X-CallCampaign a X-AgentID; ověřte je při prvním testovacím hovoru. Každá
se do promptu dostane jako proměnná, například
{{sip_x_callcampaign}}. X-CallID se ukládá jako
external_call_id hovoru.
3. Vraťte hovor zpět
Agent hovor vrátí: rozloučí se a zavěsí, přičemž zpráva BYE obsahuje čtyři hlavičky, které skript Five9 čte. Přidejte toto číslo pro přesměrování (viz Přidání čísla pro přesměrování):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeaX-RouteValueurčují skriptu, kam má volajícího odeslat, zde na dovednost Support. Mezi hodnoty proX-RouteType, které dokumentují jiní poskytovatelé, patříSkillTransfer,PhoneTransfer,HangupaDispositionOnly; hodnoty si odsouhlaste s osobou, která skript spravuje. Pro několik cílů přidejte pro každý cíl jedno vrácení s jiným názvem aX-RouteValue.X-RouteReasonobsahuje štítek záměru agenta, napříkladbilling_dispute.X-CustomMetaDataobsahuje ID předání. ZprávaBYEjej také obsahuje jakoX-TP-Handoff-Id, které Five9 nečte.
Skript Five9 namapuje čtyři hlavičky do proměnných hovoru. Pro shrnutí agenta nechte skript zavolat vyhledání předání pomocí modulu IVR Dotaz:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= následovaného
call.call_id, s profilem autorizace, který odesílá
Authorization: Bearer a váš klíč API. Viz
Vyhledání předaného hovoru.
Otestujte to
Zavolejte do skriptu IVR, požádejte agenta o spojení s osobou a ověřte, že skript směruje volajícího s vyplněnými proměnnými hovoru. Pokud hovor nikdy nedorazí k agentovi, ověřte, že číslo v URI požadavku a hlavičce To odpovídá číslu pro příchozí hovory, že zdrojová adresa Five9 je v allowed_source_cidrs a že hovor přišel přes TCP nebo TLS. Poté otevřete hovor pomocí
GET /v1/calls/{call_id}: sip_headers by mělo uvádět x-callid a
external_call_id by mělo odpovídat call.call_id ve Five9.
Omezení
- Průvodce Five9 dokumentuje data směrování v
BYEa nezmiňuje přijímáníREFER, takže zpětné předání je studený přenos provedený skriptem. - Five9 čte
X-RouteType,X-RouteValue,X-RouteReasonaX-CustomMetaData, nikoliUser-to-User. ThunderPhone odesílá každou hodnotu hlavičky v délce maximálně 256 bajtů. - Five9 doporučuje ponechat počet vlastních hlaviček přibližně na deseti, aby nedošlo k fragmentaci paketů.