Open in
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 opkaldetsexternal_call_id;User-to-User, hex-kodet, for eksempelbusiness_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ærdiBearer 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 viaexternal_call_idmed interaktions-id'et. - Rout efter
handoff.intent, og vishandoff.summarytil 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}.