ThunderPhone 2.0 on nüüd saadaval.Iseteenindusena alates 2 senti/min.Loe uudist
Alusta

Contact centers

View as Markdown
Open in
ClaudeChatGPTCursor

Ühenda Zoom Contact Centerist

Suunake Zoom Contact Centeri kõned kolmanda osapoole häälroboti konnektori abil ThunderPhone

Zoom Contact Centeri voo Boti vidin saadab helistaja agendile koos Zoomi kõne SID-ga. Kui helistaja vajab inimest, saadab agent Zoomi inimagendi aadressile SIP-i REFER-i ning sinu voog hangib üleandmise kõne SID järgi.

Enne alustamist

  • ThunderPhone'i agent ja organisatsiooni API-võti.
  • Zoom Marketplace'i üldrakendus, mida haldab sinu administraator ja mis on Contact Centerile kättesaadavaks tehtud, koos Boti vidina konnektoriga (Zoomi kolmanda osapoole häälboti juhend).
  • Zoomist botiteenuse pakkujani ulatuv SIP-trunk. Zoomi ISV-tiim loob selle etappide kaupa (vajaduste kaardistamine, testimistrunk ja seejärel tootmine) ning rakenduse ettevõtte nimi peab trunk'i kirjele täpselt vastama. Seda seadistust alustatakse ThunderPhone'i toe ja Zoomiga, mitte ainult sinu Zoomi kontol.

1. Loo SIP-lõpp-punkt

Zoomi konnektor valib SIP-aadressi asemel 15-kohalise numbri, mis algab 999-ga. Konnektori salvestamine genereerib selle numbri. Zoomi trunk kasutab heliks TLS 1.2 pordil 5061 koos SRTP-ga ning sellele antakse juurdepääs Zoomi alamvõrkude, mitte parooli alusel. Seega loo ip_allowlist-lõpp-punkt, millel on konnektori number sissehelistamisnumbrina ja nõutud SRTP (vt platvormid, mis valivad telefoninumbri):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: Zoomi SIP-signaalimise alamvõrgud, mille saad Zoomilt. Igaüks peab olema avalik IPv4-vahemik suurusega /16 või kitsam (IPv6 puhul /48 või kitsam).
  • dial_in_numbers: konnektori number täpselt sellisel kujul, nagu Zoom selle saadab, ilma +-ita.
  • srtp: required, kuna Zoomi trunk kasutab alati SRTP-d.

Zoomi aadressid on ühised kõigile selle klientidele, seega jõuab iga teine Zoomi klient, kes sellele numbrile helistab, sinu agendini. Zoom määrab numbri; ära seda avalda.

2. Saada kõned koos kontekstiga

Lisa oma voogu Boti vidin ja seo see konnektoriga. Palu Zoomi ISV-tiimil suunata trunk aadressile sip.thunderphone.com, kasutades TLS-i pordil 5061 ning konnektori numbrit nii päringu URI-s kui ka päises To. Lõpp-punkt keeldub UDP-st, seega veendu, et trunk ei lähe sellele tagasi.

Zoom saadab:

  • X-ZOOM-Call-Sid, mis salvestatakse kõne external_call_id-na. Zoomi enda andmete vastendamise lehel seda ei ole; seda dokumenteerib teise AI-pakkuja Zoomi integratsioon, seega kontrolli seda oma esimesel testkõnel.
  • X-ZOOM-DNIS, helistaja valitud numbri, kujul {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, konnektori staatilise URL-i.

3. Saa kõne tagasi

Agent saadab Zoomi SBC-s oleva inimagendi aadressile REFER-i. Lisa see edastusnumber (vt Lisa edastusnumber), kasutades Zoomi antud SBC-aadressi:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Zoomi juhend kirjeldab kahte viisi, kuidas bot konteksti edastab: POST konnektori staatilisele URL-ile enne REFER-i (voicebot_metadata ja sarnased sündmused) ning SIP-päised, mis on vastendatud jaotises Botilt sissetulev. ThunderPhone ei saada staatilisele URL-ile päringuid. Zoomi juhend ei ütle, kas see loeb REFER-ist vastendatud päiseid; kui soovid seda proovida, lisa kirjele headers, näiteks "X-Handoff-Id": "{{handoff_id}}", ja kontrolli seda testkõnega. Kinnita Zoomiga ka, et see aktsepteerib REFER-i, millele ei eelne metaandmete POST.

Edastuse saamiseks ilma kummalegi neist tuginemata lase oma voolul see pärast Boti vidinat otsida, kasutades vidinat HTTP-kõne või Skript:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= millele järgneb kõne sid.
  • Päis Authorization: Bearer sk_live_….
  • Kasuta handoff.summary ja handoff.intent, et suunata helistaja ning anda kõne vastuvõtjale lühike ülevaade.

Zoom ei avalda nende vidinate jaoks väljade tasemel dokumentatsiooni, seega kontrolli oma kontol, kas vidin saab saata päist Authorization. Vt Otsi edastatud kõne üles.

Testi seda

Helista numbrile, mis jõuab Boti vidinani, palu agendilt inimest ja kontrolli, et helistaja jõuab inimagendini ning vidin tagastab edastuse. Seejärel ava kõne päringuga GET /v1/calls/{call_id}: sip_headers peaks sisaldama x-zoom-call-sid ning external_call_id peaks ühtima sid-ga, mida sinu voog kasutab.

Piirangud

  • ThunderPhone ei saada konnektori staatilisele URL-ile päringuid, seega saab Zoom edastuse otsingu kaudu või vastendatud päiste kaudu, kui sinu test näitab, et Zoom loeb neid REFER-ist.
  • Magistraali loob Zoomi ISV-meeskond, seega ei saa sa seda ise seadistada ega testida.