Open in
NICE CXone ਤੋਂ ਕਨੈਕਟ ਕਰੋ
Studio ਸਕ੍ਰਿਪਟ ਤੋਂ SIP ਹੈਡਰ ਵਿੱਚ ContactID ਦੇ ਨਾਲ NICE CXone ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ ਸਕ੍ਰਿਪਟ ਜਾਰੀ ਰਹਿਣ
ਤੁਹਾਡੀ CXone Studio ਸਕ੍ਰਿਪਟ SIP ਹੈਡਰਾਂ ਨਾਲ ਏਜੰਟ ਨੂੰ ਕਾਲ ਕਰਦੀ ਹੈ, ਜਿਨ੍ਹਾਂ ਵਿੱਚ ਕਾਂਟੈਕਟ ID ਅਤੇ ਹੋਰ ਸੰਦਰਭ ਹੁੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਪੂਰਾ ਹੋ ਜਾਂਦਾ ਹੈ, ਉਹ ਕਾਲ ਖਤਮ ਕਰਦਾ ਹੈ ਅਤੇ ਸਕ੍ਰਿਪਟ ਵਿੱਚ ਇੱਕ REST API ਐਕਸ਼ਨ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ
- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ ਦੀ API ਕੁੰਜੀ।
- ਇੱਕ CXone SIP ਟਰੰਕ ਗਰੁੱਪ ਜੋ ਕਸਟਮ ਹੈਡਰ ਸਵੀਕਾਰ ਕਰਦਾ ਹੋਵੇ। CXone ਵੱਲੋਂ ਇਹ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਡੇ NICE ਖਾਤਾ ਪ੍ਰਤੀਨਿਧੀ ਨੂੰ ਇਹ ਸੈਟਿੰਗ ਚਾਲੂ ਕਰਨੀ ਪਵੇਗੀ।
1. SIP ਐਂਡਪੌਇੰਟ ਬਣਾਓ
Placecall SIP ਪਤੇ ਦੀ ਬਜਾਏ CXone ਟਰੰਕ ਗਰੁੱਪ ਰਾਹੀਂ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ।
NICE ਇਸ ਲਈ SIP ਪ੍ਰਮਾਣ-ਪੱਤਰਾਂ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ ਅਤੇ ਇੱਕ ਹੋਰ AI ਪ੍ਰਦਾਤਾ ਦਾ
CXone ਇੰਟੀਗ੍ਰੇਸ਼ਨ IP ਅਲਾਊਲਿਸਟ ਨਾਲ TLS ਵਰਤਦਾ ਹੈ। ਇਸ ਲਈ ਸਕ੍ਰਿਪਟ ਜਿਸ ਨੰਬਰ ਨੂੰ ਡਾਇਲ
ਕਰੇਗੀ ਉਸਨੂੰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਵਜੋਂ ਵਰਤ ਕੇ ਇੱਕ ip_allowlist ਐਂਡਪੌਇੰਟ ਬਣਾਓ (ਵੇਖੋ
ਉਹ ਪਲੇਟਫਾਰਮ ਜੋ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦੇ ਹਨ):
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: NICE ਤੋਂ ਪ੍ਰਾਪਤ ਤੁਹਾਡੇ CXone ਕਲੱਸਟਰ ਦੀਆਂ SIP ਸਿਗਨਲਿੰਗ ਰੇਂਜਾਂ। ਹਰ ਇੱਕ/16ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਜਨਤਕ IPv4 ਰੇਂਜ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6/48ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)।dial_in_numbers: ਉਹ ਨੰਬਰ ਜਿਸਨੂੰ Placecall ਡਾਇਲ ਕਰੇਗਾ, ਉਸੇ ਰੂਪ ਵਿੱਚ ਲਿਖਿਆ ਹੋਇਆ ਜਿਸ ਰੂਪ ਵਿੱਚ CXone ਇਸਨੂੰ ਭੇਜਦਾ ਹੈ। ਇਹ ਅਸਲੀ ਫ਼ੋਨ ਨੰਬਰ ਹੋਣਾ ਜ਼ਰੂਰੀ ਨਹੀਂ ਹੈ। ਇਹ ThunderPhone 'ਤੇ ਪਹਿਲਾਂ ਤੋਂ ਵਰਤੋਂ ਵਿੱਚ ਨਹੀਂ ਹੋ ਸਕਦਾ, ਨਾ ਫ਼ੋਨ ਨੰਬਰ ਵਜੋਂ ਅਤੇ ਨਾ ਕਿਸੇ ਹੋਰ ਐਂਡਪੌਇੰਟ ਉੱਤੇ: ਅਜਿਹਾ ਕਰਨ ਨਾਲ409ਮਿਲਦਾ ਹੈ।
CXone ਦੇ ਪਤੇ ਇਸਦੇ ਸਾਰੇ ਗਾਹਕਾਂ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਇਸ ਲਈ ਕੋਈ ਹੋਰ CXone ਗਾਹਕ ਜੋ ਇਹ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ ਤੁਹਾਡੇ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚੇਗਾ। ਜਿੱਥੇ ਤੁਸੀਂ ਨੰਬਰ ਚੁਣਦੇ ਹੋ, ਉੱਥੇ ਲੰਮਾ ਨੰਬਰ ਚੁਣੋ ਜਿਸਦਾ ਕੋਈ ਅਨੁਮਾਨ ਨਾ ਲਗਾ ਸਕੇ (15 ਅੰਕਾਂ ਤੱਕ), ਯਕੀਨੀ ਬਣਾਓ ਕਿ CXone ਇਸਨੂੰ ਫ਼ੋਨ ਨੈੱਟਵਰਕ ਵੱਲ ਭੇਜਣ ਦੀ ਬਜਾਏ ThunderPhone ਨੂੰ ਭੇਜਦਾ ਹੈ, ਅਤੇ ਇਸਨੂੰ ਪ੍ਰਕਾਸ਼ਿਤ ਨਾ ਕਰੋ।
2. ਸੰਦਰਭ ਨਾਲ ਕਾਲਾਂ ਭੇਜੋ
ਆਪਣੀ Studio ਸਕ੍ਰਿਪਟ ਵਿੱਚ, Placecall ਤੋਂ ਪਹਿਲਾਂ:
X-Call-IDਹੈਡਰ ਅਤੇContactIDਦੇ ਮੁੱਲ ਨਾਲ ਇੱਕ Sipputheader ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ। CXone ਆਪਣਾ ਕੋਈ ਕਾਲ-ID ਹੈਡਰ ਨਹੀਂ ਭੇਜਦਾ; ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੀexternal_call_idਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ।- ਏਜੰਟ ਨੂੰ ਪਤਾ ਹੋਣੇ ਚਾਹੀਦੇ ਹਰ ਹੋਰ ਮੁੱਲ ਲਈ ਇੱਕ Sipputheader ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ,
ਜਿਵੇਂ
support'ਤੇ ਸੈੱਟ ਕੀਤਾX-Skill। ਇਹ prompt ਵਿੱਚ{{sip_x_skill}}ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। SipputheaderUser-to-User, ਕੋਈ ਵੀX-ਹੈਡਰ ਅਤੇ ਜ਼ਿਆਦਾਤਰP-ਹੈਡਰ ਲੈਂਦਾ ਹੈ; NICE 256 ਅੱਖਰਾਂ ਜਾਂ ਇਸ ਤੋਂ ਘੱਟ ਦੇ ਮੁੱਲਾਂ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕਰਦਾ ਹੈ।
ਫਿਰ ਉਸ ਨੰਬਰ ਉੱਤੇ Placecall ਕਰੋ, ਅਜਿਹੇ ਟਰੰਕ ਗਰੁੱਪ ਰਾਹੀਂ ਜੋ ਇਸਨੂੰ ਬੇਨਤੀ URI ਅਤੇ
To ਹੈਡਰ ਦੋਵਾਂ ਵਿੱਚ ਨੰਬਰ ਸਮੇਤ sip.thunderphone.com ਨੂੰ ਭੇਜਦਾ ਹੈ। ਐਂਡਪੌਇੰਟ TLS
(ਪੋਰਟ 5061) ਜਾਂ TCP (ਪੋਰਟ 5060) ਲੈਂਦਾ ਹੈ ਅਤੇ UDP ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ, ਅਤੇ NICE
ਟਰੰਕ ਦੇ ਟਰਾਂਸਪੋਰਟ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਇਹ UDP ਨਹੀਂ ਹੈ।
3. ਕਾਲ ਵਾਪਸ ਲਵੋ
CXone SIP ਹੈਡਰ ਸਿਰਫ਼ INVITE ਅਤੇ ਇਸਦੇ ਅੰਤਿਮ ਜਵਾਬ ਵਿੱਚ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਏਜੰਟ ਕਾਲ
ਵਾਪਸ ਕਰਦਾ ਹੈ: ਇਹ ਅਲਵਿਦਾ ਕਹਿੰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਖਤਮ ਕਰਦਾ ਹੈ, ਅਤੇ ਤੁਹਾਡੀ ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ
ਦੁਬਾਰਾ ਲੈ ਲੈਂਦੀ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ
ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ):
{"name": "NICE CXone", "action": "return"}NICE ਇਸ ਗੱਲ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ ਕਿ ਕੀ ਸਕ੍ਰਿਪਟ Placecall ਤੋਂ ਬਾਅਦ, ਕੀਤੀ ਹੋਈ
ਕਾਲ ਖਤਮ ਹੋਣ 'ਤੇ, ਜਾਰੀ ਰਹਿੰਦੀ ਹੈ। ਹੋਰ AI ਪ੍ਰਦਾਤਾਵਾਂ ਦੇ CXone ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਕਾਲ ਖਤਮ
ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ CXone ਦੀ Signal API (POST /interactions/{contactId}/signal) ਰਾਹੀਂ
ਸਕ੍ਰਿਪਟ ਨੂੰ ਸਿਗਨਲ ਕਰਦੇ ਹਨ; ThunderPhone ਇਸਨੂੰ ਕਾਲ ਨਹੀਂ ਕਰਦਾ। NICE ਨਾਲ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ
ਤੁਹਾਡੀ ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ ਕਿਵੇਂ ਵਾਪਸ ਲੈਂਦੀ ਹੈ, ਫਿਰ ਇੱਕ REST API ਐਕਸ਼ਨ ਨਾਲ
ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰੋ:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ਤੋਂ ਬਾਅਦContactID।- ਹੈਡਰ
Authorization: Bearer sk_live_…। - ਕਾਂਟੈਕਟ ਨੂੰ ਰੂਟ ਕਰਨ ਲਈ ਜਵਾਬ ਵਿੱਚੋਂ
handoff.summaryਅਤੇhandoff.intentਪੜ੍ਹੋ।
ਵੇਖੋ ਹੈਂਡ-ਆਫ਼ ਕੀਤੀ ਕਾਲ ਲੱਭੋ।
ਇਸਦੀ ਜਾਂਚ ਕਰੋ
ਉਸ ਨੰਬਰ 'ਤੇ ਕਾਲ ਕਰੋ ਜੋ ਸਕ੍ਰਿਪਟ ਚਲਾਉਂਦਾ ਹੈ, ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਲਈ ਪੁੱਛੋ, ਅਤੇ ਜਾਂਚੋ ਕਿ
ਸਕ੍ਰਿਪਟ ਜਾਰੀ ਰਹਿੰਦੀ ਹੈ ਅਤੇ REST API ਕਾਰਵਾਈ ਹੈਂਡ-ਆਫ਼ ਵਾਪਸ ਕਰਦੀ ਹੈ। ਜੇ ਕਾਲ
ਕਦੇ ਵੀ ਏਜੰਟ ਤੱਕ ਨਹੀਂ ਪਹੁੰਚਦੀ, ਤਾਂ CXone ਵੱਲੋਂ ਭੇਜੇ ਨੰਬਰ ਦੀ ਜਾਂਚ ਕਰੋ ਕਿ ਇਸਦਾ ਸਰੋਤ ਪਤਾ
allowed_source_cidrs ਵਿੱਚ ਹੈ ਅਤੇ ਕਾਲ TCP ਜਾਂ TLS ਰਾਹੀਂ ਆਈ ਸੀ। ਫਿਰ
GET /v1/calls/{call_id} ਨਾਲ ਕਾਲ ਖੋਲ੍ਹੋ: sip_headers ਵਿੱਚ x-call-id ਸੂਚੀਬੱਧ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ
external_call_id ContactID ਦੇ ਬਰਾਬਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।
ਸੀਮਾਵਾਂ
- CXone ਸਿਰਫ਼
INVITEਅਤੇ ਇਸਦੇ ਅੰਤਿਮ2xx'ਤੇ ਹੀ ਹੈਡਰ ਭੇਜਦਾ ਅਤੇ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਏਜੰਟ ਦੇBYEਵਿੱਚਲੀ ਕੋਈ ਵੀ ਚੀਜ਼ ਸਕ੍ਰਿਪਟ ਤੱਕ ਨਹੀਂ ਪਹੁੰਚਦੀ। - NICE ਏਜੰਟ ਤੋਂ
REFERਸਵੀਕਾਰ ਕਰਨ ਬਾਰੇ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਦਿੰਦਾ। - REST API ਕਾਰਵਾਈ ਮੂਲ ਰੂਪ ਵਿੱਚ 10 ਸਕਿੰਟਾਂ ਬਾਅਦ ਸਮਾਪਤ ਹੋ ਜਾਂਦੀ ਹੈ (ਵੱਧ ਤੋਂ ਵੱਧ 90 ਤੋਂ ਘੱਟ) ਅਤੇ 32 KB ਤੱਕ ਦੇ ਜਵਾਬ ਪੜ੍ਹਦੀ ਹੈ।