ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

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-User og Hex-kodning.
    • Tag tilbage og overfør, så Genesys accepterer agentens REFER.

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:

IndstillingVærdi
SIP-serversip.thunderphone.com, port 5061
ProtokolTLS
Digest-godkendelseslutpunktets username og password
CodecsPCMU, 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:

  1. Tilføj eventuelt handlingen Angiv UUI-data med kontekst til agenten, f.eks. account=12345. Genesys anbefaler 128 tegn eller færre.
  2. 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 fra Call.UUIData.
  • Legitimationsoplysninger: Din API-nøgle, sendt som Authorization: Bearer sk_live_….
  • Output: Map handoff.summary og handoff.intent til 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 agentens REFER. 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.