ThunderPhone v3 è online.Attivazione self-service, da 2¢/min.Leggi l’annuncio

Contact centers

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 come external_call_id della chiamata;
  • User-to-User, codificato in esadecimale, ad esempio business_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, valore Bearer sk_live_….
  • Richiesta: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= seguito dall'ID della variabile. Puoi anche cercare la chiamata tramite external_call_id usando l'ID dell'interazione.
  • Instrada in base a handoff.intent e mostra handoff.summary alla 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}.