Open in
Forbind fra Genesys Cloud
Send Genesys Cloud-opkald til en ThunderPhone-agent via en BYOC Cloud-trunk med samtale-id og UUI, og tag dem tilbage med overdragelsen i UUI.
Dit Architect-flow sender opkalderen til agenten via en BYOC Cloud-trunk sammen med
samtale-id'et og eventuel UUI, du angiver. Når opkalderen har brug for en person, sender
agenten en SIP-REFER, Genesys tager opkaldet tilbage, og overdragelses-id'et
ankommer i opkaldets UUI.
Før du starter
- En ThunderPhone-agent og en organisations-API-nøgle.
- Genesys Cloud med BYOC Cloud og en ekstern trunk (typen BYOC Carrier eller
PBX) med disse indstillinger aktiveret
(indstillinger for ekstern trunk):
- Samtaleheadere, så Genesys sender sit samtale-id i
x-inin-cnv. Denne indstilling er slået fra som standard. - UUI-gennemgang med headertypen
User-To-Userog Hex-kodning. - Tag tilbage og overfør, så Genesys accepterer agentens
REFER.
- Samtaleheadere, så Genesys sender sit samtale-id i
1. Opret SIP-slutpunktet
Genesys besvarer en digest-udfordring, så brug et standardslutpunkt:
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"}'Gem password fra svaret med det samme; det vises kun én gang. På
trunken:
| Indstilling | Værdi |
|---|---|
| SIP-server | sip.thunderphone.com, port 5061 |
| Protokol | TLS |
| Digest-godkendelse | slutpunktets username og password |
| Codecs | PCMU, PCMA eller G.722 |
Placér trunken på en udgående rute for dit site, hvis nummerplan dækker den adresse, flowet ringer til.
2. Send opkald med kontekst
I dit Architect-flow:
- Tilføj eventuelt handlingen Angiv UUI-data med kontekst til agenten,
f.eks.
account=12345. Genesys anbefaler 128 tegn eller færre. - Tilføj handlingen Overfør til nummer med slutpunktets
sip_uri, f.eks.sip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys sender samtale-id'et i x-inin-cnv. ThunderPhone gemmer det som
opkaldets external_call_id. UUI'en når frem til prompten afkodet som
{{sip_uui}}.
Brugerdefinerede trunk-headere er statiske i Genesys, så placer værdier pr.
opkald i UUI'en. Genesys reserverer headerpræfikserne x-inin, x-genesys,
x-pcv og x-gcv til sig selv.
3. Få opkaldet tilbage
Agenten overfører med en REFER til en adresse på Genesys med
overdragelses-id'et som hexadecimal UUI i adressen. Tilføj dette
overførselsnummer (se
Tilføj overførselsnummeret
og Headere i overførselsadressen):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Erstat adressen med en, der dirigerer tilbage til den kø eller det flow, som
skal modtage opkalderen; bekræft formatet med Genesys. REFER ser sådan ud:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Når Tag tilbage og overfør er aktiveret, tager Genesys opkaldet tilbage fra
trunken og dirigerer det til den adresse. Genesys dokumenterer, at indgående
UUI havner i Call.UUIData; det dokumenterer ikke dette for en tilbagetagning,
så bekræft med Genesys eller i et testopkald, at flowet, som modtager
opkalderen, finder overdragelses-id'et der. For at hente resumeet og
hensigten skal du kalde opslaget for overdragelsen med en
Opkaldsdatahandling i en integration med Web Services Data Actions:
- Anmodning:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=efterfulgt af id'et fraCall.UUIData. - Legitimationsoplysninger: Din API-nøgle, sendt som
Authorization: Bearer sk_live_…. - Output: Map
handoff.summaryoghandoff.intenttil flowvariabler.
Se Slå et overdraget opkald op.
Test det
Ring til et nummer, der når flowet, bed agenten om en person, og kontrollér, at
Genesys sender opkaldet til den adresse, du har angivet. Kontrollér i dette flow, at
Call.UUIData indeholder overdragelses-id'et som tekst (hvis det viser hex-cifre, skal du kontrollere, at
trunkens UUI-kodning er Hex). Åbn derefter opkaldet med GET /v1/calls/{call_id}:
external_call_id skal være samtale-id'et.
Begrænsninger
- Handlingen Hent SIP-headere læser kun den indledende
INVITE, så den kan ikke læse noget fra agentensREFER. Overdragelsen når kun Genesys via UUI. - Genesys fjerner al UUI, når et opkald indeholder mere end én UUI-header.
- Overførselsadressen begrænses til 254 tegn, så en lang UUI afkortes, så den passer. Et overdragelses-id passer altid.