ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Contact centers

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 ਤੋਂ ਪਹਿਲਾਂ:

  1. X-Call-ID ਹੈਡਰ ਅਤੇ ContactID ਦੇ ਮੁੱਲ ਨਾਲ ਇੱਕ Sipputheader ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ। CXone ਆਪਣਾ ਕੋਈ ਕਾਲ-ID ਹੈਡਰ ਨਹੀਂ ਭੇਜਦਾ; ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੀ external_call_id ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ।
  2. ਏਜੰਟ ਨੂੰ ਪਤਾ ਹੋਣੇ ਚਾਹੀਦੇ ਹਰ ਹੋਰ ਮੁੱਲ ਲਈ ਇੱਕ Sipputheader ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ, ਜਿਵੇਂ support 'ਤੇ ਸੈੱਟ ਕੀਤਾ X-Skill। ਇਹ prompt ਵਿੱਚ {{sip_x_skill}} ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। Sipputheader User-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 ਤੱਕ ਦੇ ਜਵਾਬ ਪੜ੍ਹਦੀ ਹੈ।