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

Contact centers

Connetti da Genesys Cloud

Invia le chiamate Genesys Cloud a un agente ThunderPhone tramite un trunk BYOC Cloud con l

Il flusso Architect invia il chiamante all'agente tramite un trunk BYOC Cloud, con l'id della conversazione e qualsiasi UUI impostata. Quando il chiamante ha bisogno di una persona, l'agente invia un REFER SIP, Genesys riprende la chiamata e l'id di passaggio arriva nell'UUI della chiamata.

Prima di iniziare

  • Un agente ThunderPhone e una chiave API dell'organizzazione.
  • Genesys Cloud con BYOC Cloud e un trunk esterno (tipo BYOC Carrier o PBX) con queste impostazioni attivate (impostazioni del trunk esterno):
    • Intestazioni conversazione, affinché Genesys invii il proprio id della conversazione in x-inin-cnv. Per impostazione predefinita è disattivato.
    • Passaggio UUI, con tipo di intestazione User-To-User e codifica Hex.
    • Riprendi e trasferisci, affinché Genesys accetti il REFER dell'agente.

1. Crea l'endpoint SIP

Genesys risponde a una richiesta digest, quindi utilizza un endpoint standard:

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": "Genesys Cloud"}'

Salva subito la password della risposta; viene mostrata una sola volta. Sul trunk:

ImpostazioneValore
Server SIPsip.thunderphone.com, porta 5061
ProtocolloTLS
Autenticazione digestusername e password dell'endpoint
CodecPCMU, PCMA o G.722

Inserisci il trunk in una route in uscita del tuo sito il cui piano di numerazione copra l'indirizzo composto dal flusso.

2. Invia chiamate con contesto

Nel tuo flusso Architect:

  1. Facoltativamente, aggiungi un'azione Imposta dati UUI con il contesto per l'agente, ad esempio account=12345. Genesys consiglia 128 caratteri o meno.
  2. Aggiungi un'azione Trasferisci a numero con il sip_uri dell'endpoint, ad esempio sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys invia l'id della conversazione in x-inin-cnv. ThunderPhone lo archivia come external_call_id della chiamata. L'UUI raggiunge il prompt decodificato, come {{sip_uui}}.

Le intestazioni personalizzate del trunk sono statiche in Genesys, quindi inserisci i valori per chiamata nell'UUI. Genesys riserva a sé i prefissi delle intestazioni x-inin, x-genesys, x-pcv e x-gcv.

3. Riprendi la chiamata

L'agente trasferisce con un REFER a un indirizzo su Genesys, con l'id di passaggio come UUI esadecimale all'interno di quell'indirizzo. Aggiungi questo numero di trasferimento (vedi Aggiungi il numero di trasferimento e Intestazioni all'interno dell'indirizzo di trasferimento):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Sostituisci l'indirizzo con uno che instradi di nuovo alla coda o al flusso che deve ricevere il chiamante; confermane il formato con Genesys. Il REFER è simile a questo:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Con Riprendi e trasferisci attivato, Genesys riprende la chiamata dal trunk e la instrada a quell'indirizzo. Genesys documenta che l'UUI in arrivo viene inserito in Call.UUIData; non lo documenta per una ripresa, quindi verifica con Genesys, oppure con una chiamata di prova, che il flusso che riceve il chiamante trovi l'id di passaggio lì. Per ottenere il riepilogo e l'intento, richiama la ricerca del passaggio con un'Azione dati di chiamata in un'integrazione Web Services Data Actions:

  • Richiesta: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= seguito dall'id di Call.UUIData.
  • Credenziali: la tua chiave API, inviata come Authorization: Bearer sk_live_….
  • Output: mappa handoff.summary e handoff.intent alle variabili del flusso.

Vedi Cerca una chiamata passata.

Provalo

Chiama un numero che raggiunge il flusso, chiedi all'agente una persona e verifica che Genesys instradi la chiamata all'indirizzo impostato. In quel flusso, verifica che Call.UUIData contenga l'ID di hand-off come testo (se mostra cifre esadecimali, verifica che la codifica UUI del trunk sia Hex). Poi apri la chiamata con GET /v1/calls/{call_id}: external_call_id dovrebbe essere l'ID della conversazione.

Limiti

  • L'azione Ottieni intestazioni SIP legge solo l'INVITE iniziale, quindi non può leggere nulla dal REFER dell'agente. L'hand-off raggiunge Genesys solo tramite UUI.
  • Genesys elimina tutti gli UUI quando una chiamata contiene più di un'intestazione UUI.
  • L'indirizzo di trasferimento è limitato a 254 caratteri, quindi un UUI lungo viene troncato per rientrare. Un ID di hand-off rientra sempre.