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

Contact centers

Zoom Contact Center ਤੋਂ ਕਨੈਕਟ ਕਰੋ

ਤੀਜੀ-ਪੱਖੀ ਵੌਇਸਬੌਟ ਕਨੈਕਟਰ ਨਾਲ Zoom Contact Center ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ ਅਤੇ SIP REFER ਰਾਹੀਂ ਉਨ੍ਹਾਂ ਨੂੰ ਵਾਪਸ ਮਨੁੱਖੀ ਏਜੰਟ ਕੋਲ ਲਿਆਓ।

ਤੁਹਾਡੇ Zoom Contact Center ਫ਼ਲੋ ਵਿੱਚ ਇੱਕ ਬੋਟ ਵਿਜਿਟ ਕਾਲਰ ਨੂੰ Zoom ਦੇ ਕਾਲ SID ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਕਾਲਰ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਏਜੰਟ Zoom ਦੇ ਮਨੁੱਖੀ-ਏਜੰਟ ਪਤੇ ਨੂੰ SIP REFER ਭੇਜਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡਾ ਫ਼ਲੋ ਕਾਲ SID ਰਾਹੀਂ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

  • ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ API ਕੁੰਜੀ।
  • ਇੱਕ Zoom Marketplace ਜਨਰਲ ਐਪ, ਜਿਸਨੂੰ ਤੁਹਾਡਾ ਐਡਮਿਨ ਪ੍ਰਬੰਧਿਤ ਕਰਦਾ ਹੈ ਅਤੇ Contact Center ਲਈ ਉਪਲਬਧ ਕਰਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਬੋਟ ਵਿਜਿਟ ਲਈ ਇੱਕ ਕਨੈਕਟਰ ਹੋਵੇ (Zoom ਦੀ ਤੀਜੀ-ਧਿਰ ਵੌਇਸਬੋਟ ਗਾਈਡ)।
  • Zoom ਤੋਂ ਬੋਟ ਪ੍ਰਦਾਤਾ ਤੱਕ ਇੱਕ SIP ਟਰੰਕ। Zoom ਦੀ ISV ਟੀਮ ਇਸਨੂੰ ਪੜਾਵਾਂ ਵਿੱਚ ਬਣਾਉਂਦੀ ਹੈ (ਖੋਜ, ਇੱਕ ਸਟੇਜਿੰਗ ਟਰੰਕ, ਫਿਰ ਪ੍ਰੋਡਕਸ਼ਨ), ਅਤੇ ਐਪ ਦਾ ਕੰਪਨੀ ਨਾਮ ਟਰੰਕ ਰਿਕਾਰਡ ਨਾਲ ਬਿਲਕੁਲ ਮੇਲ ਖਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਇਹ ਸੈਟਅੱਪ ThunderPhone ਸਹਾਇਤਾ ਅਤੇ Zoom ਨਾਲ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ, ਸਿਰਫ਼ ਤੁਹਾਡੇ Zoom ਖਾਤੇ ਵਿੱਚ ਨਹੀਂ।

1. SIP ਐਂਡਪੁਆਇੰਟ ਬਣਾਓ

Zoom ਦਾ ਕਨੈਕਟਰ SIP ਪਤੇ ਦੀ ਬਜਾਏ 999 ਨਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵਾਲੇ 15-ਅੰਕਾਂ ਦੇ ਨੰਬਰ ਨੂੰ ਡਾਇਲ ਕਰਦਾ ਹੈ। ਕਨੈਕਟਰ ਨੂੰ ਸੇਵ ਕਰਨ ਨਾਲ ਉਹ ਨੰਬਰ ਬਣਦਾ ਹੈ। Zoom ਦਾ ਟਰੰਕ ਪੋਰਟ 5061 ਉੱਤੇ TLS 1.2 ਅਤੇ ਆਡੀਓ ਲਈ SRTP ਵਰਤਦਾ ਹੈ, ਅਤੇ ਪਾਸਵਰਡ ਦੀ ਬਜਾਏ Zoom ਦੇ ਸਬਨੈੱਟਾਂ ਰਾਹੀਂ ਅਲਾਊਲਿਸਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਇਸ ਲਈ ਕਨੈਕਟਰ ਦੇ ਨੰਬਰ ਨੂੰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਵਜੋਂ ਅਤੇ SRTP ਲਾਜ਼ਮੀ ਰੱਖ ਕੇ ਇੱਕ 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": "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: Zoom ਤੋਂ ਪ੍ਰਾਪਤ Zoom ਦੇ SIP ਸਿਗਨਲਿੰਗ ਸਬਨੈੱਟ। ਹਰੇਕ /16 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਜਨਤਕ IPv4 ਰੇਂਜ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6 ਲਈ /48 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)।
  • dial_in_numbers: ਕਨੈਕਟਰ ਦਾ ਨੰਬਰ ਬਿਲਕੁਲ ਉਸੇ ਤਰ੍ਹਾਂ ਜਿਵੇਂ Zoom ਇਸਨੂੰ ਭੇਜਦਾ ਹੈ, ਬਿਨਾਂ + ਦੇ।
  • srtp: required, ਕਿਉਂਕਿ Zoom ਦਾ ਟਰੰਕ ਹਮੇਸ਼ਾ SRTP ਵਰਤਦਾ ਹੈ।

Zoom ਦੇ ਪਤੇ ਇਸਦੇ ਸਾਰੇ ਗਾਹਕਾਂ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਇਸ ਲਈ ਕੋਈ ਵੀ ਹੋਰ Zoom ਗਾਹਕ ਜੋ ਇਸ ਨੰਬਰ ਨੂੰ ਡਾਇਲ ਕਰਦਾ ਹੈ ਤੁਹਾਡੇ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ। Zoom ਇਹ ਨੰਬਰ ਨਿਰਧਾਰਤ ਕਰਦਾ ਹੈ; ਇਸਨੂੰ ਪ੍ਰਕਾਸ਼ਿਤ ਨਾ ਕਰੋ।

2. ਸੰਦਰਭ ਨਾਲ ਕਾਲਾਂ ਭੇਜੋ

ਆਪਣੇ ਫ਼ਲੋ ਵਿੱਚ ਇੱਕ ਬੋਟ ਵਿਜਿਟ ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਇਸਨੂੰ ਕਨੈਕਟਰ ਨਾਲ ਬਾਈਂਡ ਕਰੋ। Zoom ਦੀ ISV ਟੀਮ ਨੂੰ ਟਰੰਕ ਨੂੰ sip.thunderphone.com ਵੱਲ ਪੌਇੰਟ ਕਰਨ ਲਈ ਕਹੋ, ਪੋਰਟ 5061 ਉੱਤੇ TLS ਦੇ ਨਾਲ, ਅਤੇ ਕਨੈਕਟਰ ਦੇ ਨੰਬਰ ਨੂੰ ਬੇਨਤੀ URI ਅਤੇ To ਹੈਡਰ ਦੋਵਾਂ ਵਿੱਚ ਰੱਖੋ। ਐਂਡਪੁਆਇੰਟ UDP ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਟਰੰਕ ਇਸ ਉੱਤੇ ਵਾਪਸ ਨਾ ਆਵੇ।

Zoom ਭੇਜਦਾ ਹੈ:

  • X-ZOOM-Call-Sid, ਜੋ ਕਾਲ ਦੇ external_call_id ਵਜੋਂ ਸਟੋਰ ਹੁੰਦਾ ਹੈ। Zoom ਦਾ ਆਪਣਾ ਡਾਟਾ ਮੈਪਿੰਗ ਪੰਨਾ ਇਸਨੂੰ ਸੂਚੀਬੱਧ ਨਹੀਂ ਕਰਦਾ; ਕਿਸੇ ਹੋਰ AI ਪ੍ਰਦਾਤਾ ਦਾ Zoom ਏਕੀਕਰਨ ਇਸਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਆਪਣੀ ਪਹਿਲੀ ਟੈਸਟ ਕਾਲ ਵਿੱਚ ਇਸਦੀ ਜਾਂਚ ਕਰੋ।
  • X-ZOOM-DNIS, ਕਾਲਰ ਵੱਲੋਂ ਡਾਇਲ ਕੀਤਾ ਨੰਬਰ, {{sip_x_zoom_dnis}} ਵਜੋਂ।
  • X-ZOOM-WEBHOOK, ਕਨੈਕਟਰ ਦਾ ਸਥਿਰ URL।

3. ਕਾਲ ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰੋ

ਏਜੰਟ Zoom ਦੇ SBC ਉੱਤੇ ਮਨੁੱਖੀ ਏਜੰਟ ਦੇ ਪਤੇ ਨੂੰ REFER ਭੇਜਦਾ ਹੈ। Zoom ਵੱਲੋਂ ਦਿੱਤੇ SBC ਪਤੇ ਨਾਲ ਇਹ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ):

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

Zoom ਦੀ ਗਾਈਡ ਬੋਟ ਵੱਲੋਂ ਸੰਦਰਭ ਭੇਜਣ ਦੇ ਦੋ ਤਰੀਕੇ ਦੱਸਦੀ ਹੈ: REFER ਤੋਂ ਪਹਿਲਾਂ ਕਨੈਕਟਰ ਦੇ ਸਥਿਰ URL ਲਈ ਇੱਕ POST (voicebot_metadata ਅਤੇ ਸਮਾਨ ਈਵੈਂਟ), ਅਤੇ ਬੋਟ ਤੋਂ ਇਨਬਾਊਂਡ ਹੇਠ ਮੈਪ ਕੀਤੇ SIP ਹੈਡਰ। ThunderPhone ਸਥਿਰ URL ਉੱਤੇ ਪੋਸਟ ਨਹੀਂ ਕਰਦਾ। Zoom ਦੀ ਗਾਈਡ ਇਹ ਨਹੀਂ ਦੱਸਦੀ ਕਿ ਕੀ ਉਹ REFER ਤੋਂ ਮੈਪ ਕੀਤੇ ਹੈਡਰ ਪੜ੍ਹਦਾ ਹੈ; ਜੇ ਤੁਸੀਂ ਅਜ਼ਮਾਉਣਾ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ ਐਂਟਰੀ ਵਿੱਚ "X-Handoff-Id": "{{handoff_id}}" ਵਰਗੇ headers ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਟੈਸਟ ਕਾਲ ਉੱਤੇ ਜਾਂਚ ਕਰੋ। Zoom ਨਾਲ ਇਹ ਵੀ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਉਹ ਪਹਿਲਾਂ ਕੋਈ ਮੈਟਾਡੇਟਾ POST ਨਾ ਹੋਣ ਵਾਲਾ REFER ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ।

ਇਨ੍ਹਾਂ ਦੋਵਾਂ ਉੱਤੇ ਨਿਰਭਰ ਕੀਤੇ ਬਿਨਾਂ ਹੈਂਡ-ਆਫ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ, ਬੋਟ ਵਿਜਟ ਤੋਂ ਬਾਅਦ ਆਪਣੇ ਫਲੋ ਨੂੰ ਇਸਨੂੰ ਲੱਭਣ ਲਈ ਸੈੱਟ ਕਰੋ, ਇੱਕ HTTP ਕਾਲ ਜਾਂ ਸਕ੍ਰਿਪਟ ਵਿਜਟ ਨਾਲ:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ਤੋਂ ਬਾਅਦ ਕਾਲ SID।
  • ਹੈਡਰ Authorization: Bearer sk_live_…।
  • ਕਾਲਰ ਨੂੰ ਰੂਟ ਕਰਨ ਅਤੇ ਕਾਲ ਲੈਣ ਵਾਲੇ ਵਿਅਕਤੀ ਨੂੰ ਸੰਖੇਪ ਜਾਣਕਾਰੀ ਦੇਣ ਲਈ handoff.summary ਅਤੇ handoff.intent ਵਰਤੋ।

Zoom ਇਹਨਾਂ ਵਿਜਟਾਂ ਲਈ ਫੀਲਡ-ਪੱਧਰੀ ਦਸਤਾਵੇਜ਼ ਪ੍ਰਕਾਸ਼ਿਤ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਆਪਣੇ ਅਕਾਊਂਟ ਵਿੱਚ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਵਿਜਟ Authorization ਹੈਡਰ ਭੇਜ ਸਕਦਾ ਹੈ। ਵੇਖੋ ਹੈਂਡ-ਆਫ ਕੀਤੀ ਕਾਲ ਲੱਭੋ।

ਇਸਦੀ ਜਾਂਚ ਕਰੋ

ਉਸ ਨੰਬਰ 'ਤੇ ਕਾਲ ਕਰੋ ਜੋ ਬੋਟ ਵਿਜਟ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ, ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਲਈ ਕਹੋ, ਅਤੇ ਜਾਂਚ ਕਰੋ ਕਿ ਕਾਲਰ ਮਨੁੱਖੀ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ ਅਤੇ ਵਿਜਟ ਹੈਂਡ-ਆਫ ਵਾਪਸ ਦਿੰਦਾ ਹੈ। ਫਿਰ GET /v1/calls/{call_id} ਨਾਲ ਕਾਲ ਖੋਲ੍ਹੋ: sip_headers ਵਿੱਚ x-zoom-call-sid ਸੂਚੀਬੱਧ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ external_call_id ਤੁਹਾਡੇ ਫਲੋ ਵੱਲੋਂ ਵਰਤੀ ਜਾਂਦੀ ਕਾਲ SID ਨਾਲ ਮੇਲ ਖਾਣੀ ਚਾਹੀਦੀ ਹੈ।

ਸੀਮਾਵਾਂ

  • ThunderPhone ਕਨੈਕਟਰ ਦੇ ਸਥਿਰ URL ਉੱਤੇ ਪੋਸਟ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ Zoom ਨੂੰ ਹੈਂਡ-ਆਫ ਲੁੱਕਅੱਪ ਰਾਹੀਂ ਮਿਲਦਾ ਹੈ, ਜਾਂ ਮੈਪ ਕੀਤੇ ਹੈਡਰਾਂ ਰਾਹੀਂ ਜੇ ਤੁਹਾਡਾ ਟੈਸਟ ਦਿਖਾਉਂਦਾ ਹੈ ਕਿ Zoom ਉਹਨਾਂ ਨੂੰ REFER ਤੋਂ ਪੜ੍ਹਦਾ ਹੈ।
  • ਟਰੰਕ Zoom ਦੀ ISV ਟੀਮ ਵੱਲੋਂ ਬਣਾਇਆ ਗਿਆ ਹੈ, ਇਸ ਲਈ ਤੁਸੀਂ ਇਸਨੂੰ ਖੁਦ ਸੈੱਟ ਅੱਪ ਜਾਂ ਟੈਸਟ ਨਹੀਂ ਕਰ ਸਕਦੇ।