Open in
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-Usere codifica Hex. - Riprendi e trasferisci, affinché Genesys accetti il
REFERdell'agente.
- Intestazioni conversazione, affinché Genesys invii il proprio id della conversazione in
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:
| Impostazione | Valore |
|---|---|
| Server SIP | sip.thunderphone.com, porta 5061 |
| Protocollo | TLS |
| Autenticazione digest | username e password dell'endpoint |
| Codec | PCMU, 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:
- Facoltativamente, aggiungi un'azione Imposta dati UUI con il contesto per l'agente, ad
esempio
account=12345. Genesys consiglia 128 caratteri o meno. - Aggiungi un'azione Trasferisci a numero con il
sip_uridell'endpoint, ad esempiosip: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 diCall.UUIData. - Credenziali: la tua chiave API, inviata come
Authorization: Bearer sk_live_…. - Output: mappa
handoff.summaryehandoff.intentalle 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'
INVITEiniziale, quindi non può leggere nulla dalREFERdell'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.