ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

Forbind fra Talkdesk

Send Talkdesk-opkald til en ThunderPhone-agent med Connect to Autopilot Voice, og eskaler dem tilbage med overdragelses-id

Dit Talkdesk Studio-flow sender opkalderen til agenten med interaktions-id'et og UUI. Når opkalderen har brug for en person, eskalerer agenten med en SIP- REFER til Talkdesk, og overdragelses-id'et ender i en Studio-variabel.

Før du starter

  • En ThunderPhone-agent og en organisations-API-nøgle.
  • En Talkdesk-licens til Samtaleorkestrering, som dækker Studio- komponenten Forbind til Autopilot Voice i tilstanden Ekstern stemmestrøm (Talkdesks artikel). Talkdesk fakturerer pr. minut, mens agenten har opkaldet.

1. Opret SIP-slutpunktet

Talkdesk angiver kun en IP-tilladelsesliste, så opret et slutpunkt, der accepterer opkald efter kildeadresse:

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"
  }'

Talkdesks artikel angiver, at den sender lyd over SRTP, og "srtp": "optional" bruger SRTP, når Talkdesk tilbyder det. Artiklen angiver ikke, om Talkdesk kræver SRTP. Hvis Talkdesk oplyser, at det gør, skal du sætte srtp til required, hvilket afviser opkald uden det.

Få Talkdesks SIP-signalområder fra Talkdesk. Hvert område skal være et offentligt IPv4- område på /16 eller smallere (IPv6 /48 eller smallere). Se Platforme, der godkender efter kilde-IP. Talkdesk sender SIP fra Twilios netværk, hvis adresser deles af alle Twilio-kunder, så slutpunktets adresse er det, der holder andre opkaldere ude: publicer den ikke. Gem svarets sip_uri, for eksempel sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Send opkald med kontekst

Tilføj Forbind til Autopilot Voice i tilstanden Ekstern stemmestrøm i dit Studio-flow, og sæt målet til slutpunktets sip_uri med ;transport=tls tilføjet, for eksempel sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Slutpunktet afviser opkald via UDP, som Twilios SIP bruger, medmindre andet angives.

Talkdesk sender:

  • X-Talkdesk-Interaction-Id, som gemmes som opkaldets external_call_id;
  • User-to-User, hex-kodet, for eksempel business_hours=open. Det når prompten afkodet som {{sip_uui}}.

Version 2.1 af komponenten kan også sende Definerede headere. Talkdesks indstillingsside beskriver dem som JSON sendt over en WebSocket, så bekræft med Talkdesk, om de ankommer som SIP-headere, før du er afhængig af dem.

3. Få opkaldet tilbage

Agenten eskalerer med en REFER til Talkdesks eskaleringsadresse med overdragelses-id'et som hex-UUI i adressen, det eneste sted Talkdesk læser det. Tilføj dette overførselsnummer (se Tilføj overførselsnummeret og Headers i overførselsadressen):

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

Adressen er den, der bruges i Talkdesks artikel. Version 2.1 af komponenten læser autopilot_result=; version 1.7 læser escalate_to=, så brug den nøgle i 1.7. REFER ser sådan ud:

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

Talkdesk placerer værdien i en Studio-variabel. For at hente resuméet og hensigten skal du tilføje et trin med Udfør handling i en brugerdefineret integration bygget med Connections:

  • Godkendelsestype API-nøgle, headernavn Authorization, værdi Bearer sk_live_….
  • Anmodning: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= efterfulgt af id'et fra variablen. Du kan også slå opkaldet op via external_call_id med interaktions-id'et.
  • Rout efter handoff.intent, og vis handoff.summary til den person, der overtager opkaldet.

Se Slå et overdraget opkald op.

Test det

Start et opkald gennem Studio-flowet, bed agenten om en person, og kontrollér, at flowet fortsætter forbi komponenten med overdragelses-id'et i variablen. Åbn derefter opkaldet med GET /v1/calls/{call_id}: external_call_id skal være Talkdesk-interaktions-id'et.

Begrænsninger

  • Talkdesk læser højst 256 byte UUI og tillader ikke værdier adskilt med | eller ;, så send én enkelt værdi. Overdragelses-id'et passer.
  • Talkdesks API'er kan ikke læse agentens transskription. Brug i stedet opslaget af overdragelsen eller GET /v1/calls/{call_id}.