Open in
Connetti da Talkdesk
Invia le chiamate Talkdesk a un agente ThunderPhone con Connect to Autopilot Voice e ritrasferiscile con l
Il flusso Talkdesk Studio invia il chiamante all'agente con l'ID di interazione
e l'UUI. Quando il chiamante necessita di una persona, l'agente effettua
l'escalation con un REFER SIP a Talkdesk e l'ID di trasferimento viene salvato in una variabile di Studio.
Prima di iniziare
- Un agente ThunderPhone e una chiave API dell'organizzazione.
- Una licenza Talkdesk Conversation Orchestrator, che include il componente Connetti a voce Autopilot di Studio in modalità Flusso vocale esterno (articolo di Talkdesk). Talkdesk addebita il costo al minuto mentre l'agente mantiene la chiamata.
1. Crea l'endpoint SIP
Talkdesk documenta solo un elenco di autorizzazione IP, quindi crea un endpoint che accetti le chiamate in base all'indirizzo sorgente:
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"
}'L'articolo di Talkdesk afferma che l'audio viene inviato tramite SRTP e "srtp": "optional"
risponde con SRTP quando Talkdesk lo propone. L'articolo non specifica se Talkdesk
richiede SRTP; se Talkdesk ti comunica che lo richiede, imposta srtp su required, che
rifiuta le chiamate senza SRTP.
Richiedi a Talkdesk gli intervalli di segnalazione SIP di Talkdesk. Ciascuno deve essere un intervallo
IPv4 pubblico di /16 o più ristretto (IPv6 /48 o più ristretto). Consulta
Piattaforme che eseguono l'autenticazione tramite IP sorgente.
Talkdesk invia SIP dalla rete di Twilio, i cui indirizzi sono condivisi da ogni cliente Twilio,
quindi l'indirizzo dell'endpoint è ciò che impedisce l'accesso agli altri chiamanti: non
pubblicarlo.
Conserva il sip_uri della risposta, ad esempio
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Invia le chiamate con contesto
Nel flusso Studio, aggiungi Connetti a voce Autopilot in modalità Flusso vocale
esterno e imposta come destinazione il sip_uri dell'endpoint con ;transport=tls aggiunto, ad
esempio sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. L'endpoint
rifiuta le chiamate tramite UDP, che il SIP di Twilio usa se non diversamente specificato.
Talkdesk invia:
X-Talkdesk-Interaction-Id, salvato comeexternal_call_iddella chiamata;User-to-User, codificato in esadecimale, ad esempiobusiness_hours=open. Raggiunge il prompt decodificato, come{{sip_uui}}.
La versione 2.1 del componente può anche inviare Intestazioni definite. La pagina delle preferenze di Talkdesk le descrive come JSON inviato tramite WebSocket, quindi verifica con Talkdesk se arrivano come intestazioni SIP prima di farvi affidamento.
3. Ricevi nuovamente la chiamata
L'agente effettua l'escalation con un REFER all'indirizzo di escalation di Talkdesk, con l'ID di hand-off come UUI esadecimale all'interno di quell'indirizzo, l'unico punto in cui Talkdesk lo legge.
Aggiungi questo numero di trasferimento (consulta
Aggiungi il numero di trasferimento
e Intestazioni all'interno dell'indirizzo di trasferimento):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}L'indirizzo è quello indicato nell'articolo di Talkdesk. La versione 2.1 del componente
legge autopilot_result=; la versione 1.7 legge escalate_to=, quindi usa quella chiave
nella versione 1.7. Il REFER è così:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk inserisce il valore in una variabile Studio. Per ottenere il riepilogo e l'intento, aggiungi un passaggio Esegui azione a un'integrazione personalizzata creata con Connections:
- Tipo di autenticazione Chiave API, nome dell'intestazione
Authorization, valoreBearer sk_live_…. - Richiesta:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=seguito dall'ID della variabile. Puoi anche cercare la chiamata tramiteexternal_call_idusando l'ID dell'interazione. - Instrada in base a
handoff.intente mostrahandoff.summaryalla persona che prende la chiamata.
Consulta Cerca una chiamata trasferita.
Testalo
Avvia una chiamata tramite il flusso Studio, chiedi all'agente di parlare con una persona e verifica
che il flusso prosegua oltre il componente con l'ID di hand-off nella relativa
variabile. Quindi apri la chiamata con GET /v1/calls/{call_id}:
external_call_id dovrebbe essere l'ID dell'interazione Talkdesk.
Limiti
- Talkdesk legge al massimo 256 byte di UUI e non consente valori separati da
|o;, quindi invia un singolo valore. L'ID di hand-off è compatibile. - Le API di Talkdesk non possono leggere la trascrizione dell'agente. Usa invece la ricerca dell'hand-off o
GET /v1/calls/{call_id}.