ThunderPhone v3 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu

Contact centers

Savienojiet no Five9

Nosūtiet Five9 zvanus uz ThunderPhone balss aģentu, izmantojot SIP un AI Agent Connect, un saņemiet tos atpakaļ ar maršrutēšanas galvenēm, ko nolasa jūsu IVR skripts.

Jūsu Five9 IVR skripts nosūta zvanītāju pie aģenta kopā ar Five9 zvana detalizēto informāciju. Kad aģents ir pabeidzis darbu, tas pārtrauc zvanu, SIP BYE iekļaujot maršrutēšanas galvenes, kuras skripts nolasa zvana mainīgajos, lai maršrutētu zvanītāju.

Pirms sākat

  • ThunderPhone aģents un organizācijas API atslēga.
  • Five9 AI aģenta savienojuma papildinājums. Five9 to ierobežo ar AI pakalpojumu sniedzējiem, kurus tas ir akreditējis, un Five9 ieviešanas komanda to iestata: tā importē pakalpojumu sniedzēja IVR skripta veidni, izveido zvana mainīgos un konfigurē skripta Trešās puses pārsūtīšanas moduli pakalpojumu sniedzējam. ThunderPhone vēl nav Five9 akreditēto pakalpojumu sniedzēju sarakstā: pirms plānojat to izmantot, jautājiet savai Five9 konta komandai vai ThunderPhone atbalsta dienestam.

1. Izveidojiet SIP galapunktu

Five9 Trešās puses pārsūtīšanas modulis izsauc tālruņa numuru, nevis SIP adresi, un citu pakalpojumu sniedzēju Five9 integrācijas autentificē Five9 pēc avota adreses, nevis paroles. Tāpēc izveidojiet ip_allowlist galapunktu ar numuru, kuru Five9 izsauks, kā iezvanes numuru (skatiet Platformas, kas izsauc tālruņa numuru):

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: jūsu Five9 datu centru SIP signalizācijas diapazoni, ko nodrošina Five9. Katram jābūt publiskam IPv4 diapazonam ar /16 vai šaurāku masku (IPv6 — /48 vai šaurāku).
  • dial_in_numbers: numurs, kuru Five9 skripts izsauks, rakstīts tā, kā to nosūta Five9. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot ThunderPhone — ne kā tālruņa numuru, ne citā galapunktā; pretējā gadījumā tiek atgriezts 409.

Five9 adreses ir kopīgas visiem tā klientiem, tāpēc jebkurš cits Five9 klients, kurš izsauc šo numuru, sasniedz jūsu aģentu. Izvēloties numuru, izvēlieties garu numuru, kuru neviens neuzminētu (līdz 15 cipariem), pārliecinieties, ka Five9 to nosūta uz ThunderPhone, nevis tālruņu tīklu, un nepublicējiet to.

2. Sūtiet zvanus ar kontekstu

Lūdziet Five9 ieviešanas komandai:

  • Sūtīt zvanu no Trešās puses pārsūtīšanas moduļa uz sip:+14155550188@sip.thunderphone.com, numuru iekļaujot gan pieprasījuma URI, gan To galvenē. Modulis izmanto numuru ar pakalpojumu sniedzēja SIP domēnu galvenē.
  • Sūtīt to, izmantojot TLS (ports 5061) vai TCP (ports 5060). Galapunkts atsaka UDP, un Five9 nepublicē, kuru transportu tas izmanto, tāpēc pārliecinieties, ka tas nav UDP.
  • Ieslēgt Atgriezties pēc trešās puses zvana, lai skripts turpinātu darbu, kad aģents pārtrauc zvanu (Five9 trešās puses zvanam atļauj līdz 3 600 sekundēm).

Five9 ceļvedī ir norādītas vērtības, ko tas nosūta (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name un citas), nevis to galveņu nosaukumi. Citu AI pakalpojumu sniedzēju Five9 integrācijas tās protokola līmenī dokumentē kā X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign un X-AgentID; pārbaudiet tās savā pirmajā testa zvanā. Katra nonāk uzvednē kā mainīgais, piemēram, {{sip_x_callcampaign}}. X-CallID tiek saglabāts kā zvana external_call_id.

3. Saņemiet zvanu atpakaļ

Aģents atdod zvanu: tas atvadās un noliek klausuli, un BYE ietver četras galvenes, ko nolasa Five9 skripts. Pievienojiet šo pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType un X-RouteValue norāda skriptam, kur nosūtīt zvanītāju — šajā gadījumā uz Support prasmi. Citu pakalpojumu sniedzēju dokumentētās X-RouteType vērtības ietver SkillTransfer, PhoneTransfer, Hangup un DispositionOnly; saskaņojiet vērtības ar personu, kas uztur skriptu. Vairākiem galamērķiem pievienojiet vienu atgriešanu katram galamērķim ar citu nosaukumu un X-RouteValue.
  • X-RouteReason ietver aģenta nodoma etiķeti, piemēram, billing_dispute.
  • X-CustomMetaData ietver nodošanas ID. BYE to ietver arī kā X-TP-Handoff-Id, ko Five9 nenolasa.

Five9 skripts kartē četras galvenes uz zvana mainīgajiem. Lai iegūtu aģenta kopsavilkumu, lieciet skriptam izsaukt nodošanas meklēšanu ar IVR Vaicājuma moduli: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= kam seko call.call_id, izmantojot autorizācijas profilu, kas nosūta Authorization: Bearer un jūsu API atslēgu. Skatiet Meklējiet nodotu zvanu.

Testējiet

Piezvaniet uz IVR skriptu, palūdziet aģentam savienot ar personu un pārbaudiet, vai skripts maršrutē zvanītāju ar aizpildītiem zvana mainīgajiem. Ja zvans nekad nenonāk pie aģenta, pārbaudiet, vai numurs pieprasījuma URI un To galvenē atbilst iezvanes numuram, vai Five9 avota adrese ir iekļauta allowed_source_cidrs un vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}: sip_headers jānorāda x-callid, un external_call_id jāatbilst Five9 call.call_id.

Ierobežojumi

  • Five9 ceļvedī ir dokumentēti maršrutēšanas dati BYE ziņojumā, bet nav minēta REFER pieņemšana, tāpēc atdošana ir skripta veikta aukstā pārsūtīšana.
  • Five9 nolasa X-RouteType, X-RouteValue, X-RouteReason un X-CustomMetaData, nevis User-to-User. ThunderPhone katras galvenes vērtību nosūta ne garāku par 256 baitiem.
  • Five9 iesaka saglabāt pielāgoto galveņu skaitu apmēram līdz desmit, lai izvairītos no pakešu fragmentācijas.