ThunderPhone 2.0 on nüüd saadaval.Iseteenindusena alates 2 senti/min.Loe uudist
Alusta

Contact centers

View as Markdown
Open in
ClaudeChatGPTCursor

Ühenda Talkdeskist

Suuna Talkdeski kõned funktsiooniga Connect to Autopilot Voice ThunderPhone

Sinu Talkdesk Studio voog suunab helistaja häälagendi juurde koos interaktsiooni ID ja UUI-ga. Kui helistaja vajab inimest, eskaleerib häälagent SIP-i REFER-iga Talkdeski ning üleandmise ID jõuab Studio muutujasse.

Enne alustamist

  • ThunderPhone'i häälagent ja organisatsiooni API-võti.
  • Talkdeski Vestluse orkestreerija litsents, mis hõlmab Studio komponenti Ühenda Autopilot Voice'iga režiimis Väline häälvoog (Talkdeski artikkel). Talkdesk esitab selle eest arve minuti kaupa, kuni häälagent kõnet hoiab.

1. Loo SIP-lõpp-punkt

Talkdesk dokumenteerib ainult IP-lubatud loendi, seega loo lõpp-punkt, mis võtab kõnesid vastu lähteaadressi alusel:

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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Talkdeski artiklis on kirjas, et see saadab heli SRTP kaudu, ning "srtp": "optional" vastab SRTP-ga, kui Talkdesk seda pakub. Artikkel ei ütle, kas Talkdesk nõuab SRTP-d; kui Talkdesk ütleb, et nõuab, määra srtp väärtuseks required, mis keeldub ilma selleta kõnedest.

Hangi Talkdeski SIP-signalisatsiooni vahemikud Talkdeskilt. Igaüks peab olema avalik IPv4 vahemik /16 või kitsam (IPv6 /48 või kitsam). Vaata Platvormid, mis autentivad lähte-IP alusel. Talkdesk saadab SIP-i Twilio võrgust, mille aadresse jagab iga Twilio klient, seega hoiab teised helistajad eemal lõpp-punkti aadress: ära seda avalda. Säilita vastuse sip_uri, näiteks sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Saada kõned koos kontekstiga

Lisa oma Studio voogu Ühenda Autopilot Voice'iga režiimis Väline häälvoog ja määra selle sihtmärgiks lõpp-punkti sip_uri, millele on lisatud ;transport=tls, näiteks sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Lõpp-punkt keeldub UDP kaudu tulevatest kõnedest, mida Twilio SIP kasutab, kui ei ole teisiti määratud.

Talkdesk saadab:

  • X-Talkdesk-Interaction-Id, mis salvestatakse kõne external_call_id-na;
  • User-to-User, kuueteistkümnendsüsteemis kodeerituna, näiteks business_hours=open. See jõuab viipesse dekodeeritult kui {{sip_uui}}.

Komponendi versioon 2.1 saab saata ka Määratletud päiseid. Talkdeski eelistuste leht kirjeldab neid JSON-ina, mis saadetakse WebSocketi kaudu, seega kinnita Talkdeskiga, kas need jõuavad SIP-päistena enne, kui neile tuginema hakkad.

3. Too kõne tagasi

Agent eskaleerib REFER-iga Talkdeski eskaleerimisaadressile, kus üleandmise ID on selles aadressis kuueteistkümnendsüsteemi UUI-na — see on ainus koht, kust Talkdesk seda loeb. Lisa see edastusnumber (vaata Edastusnumbri lisamine ja Päised edastusaadressis):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Aadress on sama, mis Talkdeski artiklis. Komponendi versioon 2.1 loeb autopilot_result=; versioon 1.7 loeb escalate_to=, seega kasuta versioonis 1.7 seda võtit. REFER näeb välja järgmine:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk salvestab väärtuse Studio muutujasse. Kokkuvõtte ja kavatsuse saamiseks lisa Connectionsiga loodud kohandatud integratsiooni juurde samm Käivita toiming:

  • Autentimise tüüp API-võti, päise nimi Authorization, väärtus Bearer sk_live_….
  • Päring: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=, millele järgneb muutuja ID. Kõne saad otsida ka external_call_id järgi, kasutades interaktsiooni ID-d.
  • Suuna vastavalt väärtusele handoff.intent ja kuva handoff.summary kõne vastu võtvale inimesele.

Vaata Üle antud kõne otsimine.

Testi seda

Alusta kõnet Studio voo kaudu, palu agendilt inimest ja kontrolli, et voog jätkub komponendist edasi ning selle muutujas on üleandmise ID. Seejärel ava kõne päringuga GET /v1/calls/{call_id}: external_call_id peab olema Talkdeski interaktsiooni ID.

Piirangud

  • Talkdesk loeb kuni 256 baiti UUI-d ega luba väärtusi, mis on eraldatud märkidega | või ;, seega saada üks väärtus. Üleandmise ID mahub ära.
  • Talkdeski API-d ei saa lugeda agendi transkriptsiooni. Kasuta selle asemel üle antud kõne otsingut või GET /v1/calls/{call_id}.