ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

Yhdistä Five9:stä

Lähetä Five9-puhelut ThunderPhone-agentille SIP:n kautta AI Agent Connectilla ja palauta ne reititysotsakkeilla, joita IVR-skriptisi lukee.

Five9:n IVR-komentosarja ohjaa soittajan agentille Five9:n puhelutietojen kanssa. Kun agentti on valmis, se katkaisee puhelun SIP-BYE-viestin reititysotsakkeilla, jotka komentosarja lukee puhelumuuttujiin soittajan reitittämistä varten.

Ennen kuin aloitat

  • ThunderPhone-agentti ja organisaation API-avain.
  • Five9:n AI Agent Connect -lisäosa. Five9 rajoittaa sen tekoälypalveluntarjoajiin, jotka se on hyväksynyt, ja Five9:n käyttöönottotiimi määrittää sen: se tuo palveluntarjoajan IVR-komentosarjamallin, luo puhelumuuttujat ja ohjaa komentosarjan Kolmannen osapuolen siirto -moduulin palveluntarjoajalle. ThunderPhone ei ole vielä Five9:n hyväksyttyjen palveluntarjoajien luettelossa: kysy Five9-asiakastiimiltäsi tai ThunderPhone-tuesta ennen kuin suunnittelet sen varaan.

1. Luo SIP-päätepiste

Five9:n Kolmannen osapuolen siirto -moduuli soittaa puhelinnumeroon, ei SIP-osoitteeseen, ja muiden palveluntarjoajien Five9-integraatiot todentavat Five9:n lähdeosoitteen eikä salasanan perusteella. Luo siis ip_allowlist-päätepiste ja määritä numero, johon Five9 soittaa, sisääntulonumeroksi (katso Alustat, jotka soittavat puhelinnumeroon):

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: Five9:ltä saadut Five9-datakeskustesi SIP-signalointialueet. Jokaisen on oltava julkinen IPv4-alue, jonka maski on /16 tai tarkempi (IPv6: /48 tai tarkempi).
  • dial_in_numbers: numero, johon Five9:n komentosarja soittaa, Five9:n lähettämässä muodossa. Sen ei tarvitse olla oikea puhelinnumero. Se ei voi olla jo käytössä ThunderPhonessa puhelinnumerona tai toisessa päätepisteessä: tällöin palautetaan 409.

Five9:n osoitteet ovat kaikkien sen asiakkaiden yhteiskäytössä, joten kuka tahansa muu Five9-asiakas, joka soittaa numeroon, pääsee agentillesi. Kun valitset numeron, valitse pitkä numero, jota kukaan ei arvaisi (enintään 15 numeroa), varmista, että Five9 lähettää sen ThunderPhonelle eikä puhelinverkkoon, äläkä julkaise sitä.

2. Lähetä puhelut kontekstin kanssa

Pyydä Five9:n käyttöönottotiimiä:

  • Lähettämään puhelu Kolmannen osapuolen siirto -moduulista osoitteeseen sip:+14155550188@sip.thunderphone.com siten, että numero on sekä pyyntö-URI:ssa että To-otsakkeessa. Moduuli ottaa numeron vastaan palveluntarjoajan SIP-verkkotunnuksen ollessa otsakkeessa.
  • Lähettämään se TLS:n (portti 5061) tai TCP:n (portti 5060) kautta. Päätepiste hylkää UDP:n, eikä Five9 julkaise käyttämäänsä siirtotapaa, joten varmista, ettei se ole UDP.
  • Ottamaan käyttöön Palaa kolmannen osapuolen puhelun jälkeen, jotta komentosarja jatkuu, kun agentti katkaisee puhelun (Five9 sallii kolmannen osapuolen puhelulle enintään 3 600 sekuntia).

Five9:n ohjeessa luetellaan sen lähettämät arvot (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name ja muut), mutta ei niiden otsakenimiä. Muiden tekoälypalveluntarjoajien Five9-integraatioissa ne on dokumentoitu siirrettäviksi muodossa X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign ja X-AgentID; tarkista ne ensimmäisessä testipuhelussasi. Kukin välittyy kehotteeseen muuttujana, kuten {{sip_x_callcampaign}}. X-CallID tallennetaan puhelun external_call_id-tunnukseksi.

3. Palauta puhelu

Agentti palauttaa puhelun: se sanoo hyvästit ja katkaisee puhelun, ja BYE sisältää neljä otsaketta, jotka Five9:n skripti lukee. Lisää tämä siirtonumero (katso Lisää siirtonumero):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType ja X-RouteValue kertovat skriptille, minne soittaja ohjataan, tässä tapauksessa Support-taitoon. Muut palveluntarjoajat dokumentoivat X-RouteType-arvolle esimerkiksi SkillTransfer, PhoneTransfer, Hangup ja DispositionOnly; sovi arvoista skriptiä ylläpitävän henkilön kanssa. Jos kohteita on useita, lisää yksi palautus kohdetta kohden eri nimellä ja X-RouteValue-arvolla.
  • X-RouteReason sisältää agentin tarkoitustunnisteen, kuten billing_dispute.
  • X-CustomMetaData sisältää luovutuksen tunnuksen. BYE sisältää sen myös muodossa X-TP-Handoff-Id, jota Five9 ei lue.

Five9:n skripti yhdistää neljä otsaketta puhelumuuttujiin. Agentin yhteenvedon hakemista varten määritä skripti kutsumaan luovutushakua IVR:n Kysely-moduulilla: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ja sen perään call.call_id, sekä Authorization Profile -profiililla, joka lähettää Authorization: Bearer-otsakkeen ja API-avaimesi. Katso Hae luovutettu puhelu.

Testaa

Soita IVR-skriptiin, pyydä agentilta henkilöä ja tarkista, että skripti reitittää soittajan täytetyillä puhelumuuttujilla. Jos puhelu ei koskaan saavu agentille, tarkista, että pyyntö-URI:n ja To-otsakkeen numero vastaa soittonumeroa, että Five9:n lähdeosoite on allowed_source_cidrs-asetuksessa ja että puhelu saapui TCP:n tai TLS:n kautta. Avaa sitten puhelu kutsulla GET /v1/calls/{call_id}: sip_headers-kohdassa pitäisi näkyä x-callid, ja external_call_id-arvon pitäisi vastata Five9:n call.call_id-arvoa.

Rajoitukset

  • Five9:n ohje dokumentoi reititystiedot BYE-viestissä eikä mainitse REFER-viestin hyväksymistä, joten palautus on skriptin tekemä kylmä siirto.
  • Five9 lukee X-RouteType, X-RouteValue, X-RouteReason ja X-CustomMetaData -otsakkeet, ei User-to-User-otsaketta. ThunderPhone lähettää kunkin otsakearvon enintään 256 tavun pituisena.
  • Five9 suosittelee pitämään mukautettujen otsakkeiden määrän noin kymmenessä pakettien pirstoutumisen välttämiseksi.