ThunderPhone v3 je venku.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Contact centers

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 /16 nebo menší (IPv6 /48 nebo 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í se 409.

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čce To. 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-RouteType a X-RouteValue určují skriptu, kam má volajícího odeslat, zde na dovednost Support. Mezi hodnoty pro X-RouteType, které dokumentují jiní poskytovatelé, patří SkillTransfer, PhoneTransfer, Hangup a DispositionOnly; 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 a X-RouteValue.
  • X-RouteReason obsahuje štítek záměru agenta, například billing_dispute.
  • X-CustomMetaData obsahuje ID předání. Zpráva BYE jej také obsahuje jako X-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 BYE a 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-RouteReason a X-CustomMetaData, nikoli User-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ů.