Open in
Unganisha kutoka NICE CXone
Tuma simu za NICE CXone kwa ejenti wa ThunderPhone kutoka kwenye script ya Studio ukiwa na ContactID katika kichwa cha SIP, na utafute uhamisho wa ejenti script inapoendelea.
Script yako ya CXone Studio hupiga simu kwa ejenti ikiwa na vichwa vya SIP vinavyobeba kitambulisho cha kontakti na muktadha mwingine wowote. Ejenti inapomaliza, hukata simu, na kitendo cha REST API katika script huchukua urejeshaji.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Kundi la trunk la SIP la CXone linalokubali vichwa maalum. Mwakilishi wa akaunti yako ya NICE lazima awashe mpangilio huu kabla CXone haijavituma.
1. Unda kituo cha SIP
Placecall hupiga namba ya simu kupitia kundi la trunk la CXone, si anwani ya SIP.
NICE haiandiki kumbukumbu za vitambulisho vya SIP kwa ajili yake, na muunganisho wa CXone wa mtoa huduma mwingine wa AI hutumia TLS yenye orodha ya IP zinazoruhusiwa. Kwa hiyo, unda kituo cha ip_allowlist chenye namba ambayo script itapiga kama namba ya kupigia kuingia (tazama
Majukwaa yanayopiga namba ya simu):
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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: masafa ya uashiriaji wa SIP ya klasta yako ya CXone, kutoka NICE. Kila moja lazima liwe masafa ya umma ya IPv4 ya/16au finyu zaidi (IPv6 ya/48au finyu zaidi).dial_in_numbers: namba ambayo Placecall itapiga, iliyoandikwa jinsi CXone inavyoituma. Si lazima iwe namba halisi ya simu. Haiwezi kuwa tayari inatumika kwenye ThunderPhone, kama namba ya simu au kwenye kituo kingine: hilo hurejesha409.
Anwani za CXone zinashirikiwa na wateja wake wote, kwa hiyo mteja mwingine yeyote wa CXone anayepiga namba hiyo hufikia ejenti wako. Unapochagua namba, chagua ndefu ambayo hakuna mtu angekisia (hadi tarakimu 15), hakikisha CXone inaielekeza kwa ThunderPhone badala ya kuituma kwenye mtandao wa simu, na usiichapishe.
2. Tuma simu zenye muktadha
Katika script yako ya Studio, kabla ya Placecall:
- Ongeza kitendo cha Sipputheader chenye kichwa
X-Call-IDna thamani yaContactID. CXone haitumi kichwa chake cha call-id; ThunderPhone huhifadhi hiki kamaexternal_call_idya simu. - Ongeza kitendo cha Sipputheader kwa kila thamani nyingine ambayo ejenti anapaswa kujua, kama vile
X-Skilliliyowekwa kuwasupport. Hufika kwenye prompt kama{{sip_x_skill}}. Sipputheader hukubaliUser-to-User, kichwa chochote chaX-, na vichwa vingi vyaP-; NICE inapendekeza thamani za herufi 256 au chini yake.
Kisha Placecall kwenye namba hiyo, kupitia kundi la trunk linaloituma kwa
sip.thunderphone.com likiwa na namba katika URI ya ombi na kichwa cha To.
Kituo kinakubali TLS (port 5061) au TCP (port 5060) na hukataa UDP, na NICE haiandiki kumbukumbu za usafirishaji wa trunk, kwa hiyo hakikisha si UDP.
3. Rudisha simu
CXone husoma vichwa vya SIP kwenye INVITE pekee na jibu lake la mwisho, kwa hiyo ejenti hurudisha simu: huaga na kukata simu, kisha script yako humchukua mpigaji tena. Ongeza namba hii ya uhamisho (tazama
Ongeza namba ya uhamisho):
{"name": "NICE CXone", "action": "return"}NICE haiandiki kumbukumbu kwamba script huendelea baada ya Placecall wakati simu iliyopigwa inapoisha. Muunganisho wa CXone wa watoa huduma wengine wa AI badala yake huashiria script kupitia Signal API ya CXone (POST /interactions/{contactId}/signal) kabla hawajakataa simu; ThunderPhone haiiti. Thibitisha na NICE jinsi script yako inavyomrudisha mpigaji, kisha chukua urejeshaji kwa kitendo cha REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ikifuatiwa naContactID.- Kichwa
Authorization: Bearer sk_live_…. - Soma
handoff.summarynahandoff.intentkutoka kwenye jibu ili kuelekeza kontakti.
Tazama Tafuta simu iliyorejeshwa.
Ijaribu
Piga nambari inayotumia script, muombe ejenti akuunganishe na mtu, kisha uthibitishe kuwa
script inaendelea na kitendo cha REST API kinarejesha uhamisho. Ikiwa simu
haimfikii ejenti kamwe, angalia nambari inayotumwa na CXone, kwamba anwani yake ya chanzo
imo katika allowed_source_cidrs, na kwamba simu ilikuja kupitia TCP au TLS. Kisha fungua
simu kwa GET /v1/calls/{call_id}: sip_headers inapaswa kuorodhesha x-call-id, na
external_call_id inapaswa kuwa sawa na ContactID.
Vikomo
- CXone hutuma na kusoma vichwa kwenye
INVITEna2xxyake ya mwisho pekee, hivyo hakuna chochote kwenyeBYEya ejenti kinachofika kwenye script. - NICE haiandiki kuhusu kukubali
REFERkutoka kwa ejenti. - Kitendo cha REST API huisha muda baada ya sekunde 10 kwa chaguo-msingi (kiwango cha juu ni chini ya 90) na husoma majibu hadi 32 KB.