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

Contact centers

Talkdesk ਤੋਂ ਕਨੈਕਟ ਕਰੋ

Connect to Autopilot Voice ਨਾਲ Talkdesk ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ UUI ਵਿੱਚ hand-off id ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਉਹਨਾਂ ਨੂੰ ਵਾਪਸ ਐਸਕਲੇਟ ਕਰੋ।

ਤੁਹਾਡਾ Talkdesk Studio ਫਲੋ ਕਾਲਰ ਨੂੰ interaction id ਅਤੇ UUI ਦੇ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਕਾਲਰ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਏਜੰਟ SIP REFER ਰਾਹੀਂ Talkdesk ਨੂੰ ਐਸਕੇਲੇਟ ਕਰਦਾ ਹੈ, ਅਤੇ ਹੈਂਡ-ਆਫ id ਇੱਕ Studio ਵੇਰੀਏਬਲ ਵਿੱਚ ਆ ਜਾਂਦੀ ਹੈ।

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

  • ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ API ਕੁੰਜੀ।
  • Talkdesk ਦਾ ਕਨਵਰਸੇਸ਼ਨ ਆਰਕੇਸਟ੍ਰੇਟਰ ਲਾਇਸੈਂਸ, ਜੋ ਬਾਹਰੀ ਵੌਇਸ ਸਟ੍ਰੀਮ ਮੋਡ ਵਿੱਚ Studio ਦੇ ਆਟੋਪਾਇਲਟ ਵੌਇਸ ਨਾਲ ਕਨੈਕਟ ਕਰੋ ਕੰਪੋਨੈਂਟ ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ (Talkdesk ਦਾ ਲੇਖ)। ਜਦੋਂ ਏਜੰਟ ਕਾਲ ਨੂੰ ਹੋਲਡ ਕਰਦਾ ਹੈ, Talkdesk ਇਸ ਲਈ ਪ੍ਰਤੀ ਮਿੰਟ ਬਿਲ ਕਰਦਾ ਹੈ।

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

Talkdesk ਸਿਰਫ਼ ਇੱਕ 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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Talkdesk ਦਾ ਲੇਖ ਕਹਿੰਦਾ ਹੈ ਕਿ ਇਹ SRTP ਰਾਹੀਂ ਆਡੀਓ ਭੇਜਦਾ ਹੈ, ਅਤੇ "srtp": "optional" ਜਦੋਂ Talkdesk ਇਸ ਦੀ ਪੇਸ਼ਕਸ਼ ਕਰਦਾ ਹੈ ਤਾਂ SRTP ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ। ਲੇਖ ਇਹ ਨਹੀਂ ਦੱਸਦਾ ਕਿ Talkdesk ਨੂੰ SRTP ਦੀ ਲੋੜ ਹੈ ਜਾਂ ਨਹੀਂ; ਜੇ Talkdesk ਤੁਹਾਨੂੰ ਦੱਸੇ ਕਿ ਹੈ, ਤਾਂ srtp ਨੂੰ required 'ਤੇ ਸੈੱਟ ਕਰੋ, ਜੋ ਇਸ ਤੋਂ ਬਿਨਾਂ ਕਾਲਾਂ ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ।

Talkdesk ਤੋਂ Talkdesk ਦੀਆਂ SIP ਸਿਗਨਲਿੰਗ ਰੇਂਜਾਂ ਪ੍ਰਾਪਤ ਕਰੋ। ਹਰ ਇੱਕ ਜਨਤਕ IPv4 ਰੇਂਜ /16 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6 /48 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)। ਵੇਖੋ ਉਹ ਪਲੇਟਫਾਰਮ ਜੋ ਸਰੋਤ IP ਰਾਹੀਂ ਪ੍ਰਮਾਣਿਤ ਹੁੰਦੇ ਹਨ। Talkdesk, Twilio ਦੇ ਨੈੱਟਵਰਕ ਤੋਂ SIP ਭੇਜਦਾ ਹੈ, ਜਿਸ ਦੇ ਪਤੇ ਹਰ Twilio ਗਾਹਕ ਸਾਂਝੇ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਐਂਡਪੌਇੰਟ ਦਾ ਪਤਾ ਹੀ ਹੋਰ ਕਾਲਰਾਂ ਨੂੰ ਬਾਹਰ ਰੱਖਦਾ ਹੈ: ਇਸਨੂੰ ਪ੍ਰਕਾਸ਼ਿਤ ਨਾ ਕਰੋ। ਜਵਾਬ ਦਾ sip_uri ਰੱਖੋ, ਉਦਾਹਰਨ ਲਈ sip:agent-12-jhxmginwjx@sip.thunderphone.com।

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

ਆਪਣੇ Studio ਫਲੋ ਵਿੱਚ, ਬਾਹਰੀ ਵੌਇਸ ਸਟ੍ਰੀਮ ਮੋਡ ਵਿੱਚ ਆਟੋਪਾਇਲਟ ਵੌਇਸ ਨਾਲ ਕਨੈਕਟ ਕਰੋ ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਇਸਦਾ ਟਾਰਗੇਟ ਐਂਡਪੌਇੰਟ ਦੇ sip_uri 'ਤੇ ਸੈੱਟ ਕਰੋ, ਜਿਸ ਵਿੱਚ ;transport=tls ਜੋੜਿਆ ਹੋਵੇ, ਉਦਾਹਰਨ ਲਈ sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls। ਐਂਡਪੌਇੰਟ UDP ਰਾਹੀਂ ਕਾਲਾਂ ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ, ਜਿਸਨੂੰ Twilio ਦਾ SIP ਵਰਤਦਾ ਹੈ ਜਦੋਂ ਤੱਕ ਹੋਰ ਨਾ ਦੱਸਿਆ ਜਾਵੇ।

Talkdesk ਭੇਜਦਾ ਹੈ:

  • X-Talkdesk-Interaction-Id, ਜੋ ਕਾਲ ਦੇ external_call_id ਵਜੋਂ ਸਟੋਰ ਹੁੰਦਾ ਹੈ;
  • User-to-User, ਹੈਕਸ-ਇਨਕੋਡ ਕੀਤਾ ਹੋਇਆ, ਜਿਵੇਂ ਕਿ business_hours=open। ਇਹ ਡੀਕੋਡ ਹੋ ਕੇ prompt ਤੱਕ {{sip_uui}} ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ।

ਕੰਪੋਨੈਂਟ ਦਾ ਵਰਜਨ 2.1 ਪਰਿਭਾਸ਼ਿਤ ਹੈਡਰ ਵੀ ਭੇਜ ਸਕਦਾ ਹੈ। Talkdesk ਦਾ ਤਰਜੀਹਾਂ ਪੰਨਾ ਉਹਨਾਂ ਨੂੰ WebSocket ਰਾਹੀਂ ਭੇਜੇ ਜਾਣ ਵਾਲੇ JSON ਵਜੋਂ ਦਰਸਾਉਂਦਾ ਹੈ, ਇਸ ਲਈ ਉਹਨਾਂ 'ਤੇ ਨਿਰਭਰ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ Talkdesk ਨਾਲ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਕੀ ਉਹ SIP ਹੈਡਰਾਂ ਵਜੋਂ ਪਹੁੰਚਦੇ ਹਨ।

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

ਏਜੰਟ Talkdesk ਦੇ ਐਸਕੇਲੇਸ਼ਨ ਪਤੇ ਲਈ REFER ਨਾਲ ਐਸਕੇਲੇਟ ਕਰਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਹੈਂਡ-ਆਫ਼ ID ਉਸ ਪਤੇ ਦੇ ਅੰਦਰ hex UUI ਵਜੋਂ ਹੁੰਦੀ ਹੈ, ਅਤੇ Talkdesk ਇਸਨੂੰ ਸਿਰਫ਼ ਉੱਥੇ ਹੀ ਪੜ੍ਹਦਾ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਪਤੇ ਦੇ ਅੰਦਰ ਹੈਡਰ):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

ਪਤਾ Talkdesk ਦੇ ਲੇਖ ਵਿੱਚ ਦਿੱਤਾ ਪਤਾ ਹੈ। ਕੰਪੋਨੈਂਟ ਦਾ ਵਰਜਨ 2.1 autopilot_result= ਪੜ੍ਹਦਾ ਹੈ; ਵਰਜਨ 1.7 escalate_to= ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ 1.7 ਵਿੱਚ ਉਹ ਕੁੰਜੀ ਵਰਤੋ। REFER ਇਸ ਤਰ੍ਹਾਂ ਦਿਸਦਾ ਹੈ:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk ਮੁੱਲ ਨੂੰ Studio ਵੇਰੀਏਬਲ ਵਿੱਚ ਰੱਖਦਾ ਹੈ। ਸਾਰ ਅਤੇ ਇਰਾਦਾ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ, Connections ਨਾਲ ਬਣੇ ਕਸਟਮ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਉੱਤੇ ਕਾਰਵਾਈ ਚਲਾਓ ਕਦਮ ਸ਼ਾਮਲ ਕਰੋ:

  • ਪ੍ਰਮਾਣੀਕਰਨ ਕਿਸਮ API ਕੁੰਜੀ, ਹੈਡਰ ਨਾਮ Authorization, ਮੁੱਲ Bearer sk_live_…।
  • ਬੇਨਤੀ: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= ਜਿਸ ਤੋਂ ਬਾਅਦ ਵੇਰੀਏਬਲ ਵਿੱਚੋਂ ID ਹੋਵੇ। ਤੁਸੀਂ ਇੰਟਰੈਕਸ਼ਨ ID ਨਾਲ external_call_id ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਵੀ ਕਾਲ ਲੱਭ ਸਕਦੇ ਹੋ।
  • handoff.intent ਅਨੁਸਾਰ ਰੂਟ ਕਰੋ ਅਤੇ ਕਾਲ ਲੈਣ ਵਾਲੇ ਵਿਅਕਤੀ ਨੂੰ handoff.summary ਦਿਖਾਓ।

ਵੇਖੋ ਹੈਂਡ-ਆਫ਼ ਕੀਤੀ ਕਾਲ ਲੱਭੋ।

ਇਸਦੀ ਜਾਂਚ ਕਰੋ

Studio ਫ਼ਲੋ ਰਾਹੀਂ ਕਾਲ ਸ਼ੁਰੂ ਕਰੋ, ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਨਾਲ ਗੱਲ ਕਰਵਾਉਣ ਲਈ ਕਹੋ, ਅਤੇ ਜਾਂਚ ਕਰੋ ਕਿ ਫ਼ਲੋ ਆਪਣੇ ਵੇਰੀਏਬਲ ਵਿੱਚ ਹੈਂਡ-ਆਫ਼ ID ਦੇ ਨਾਲ ਕੰਪੋਨੈਂਟ ਤੋਂ ਅੱਗੇ ਜਾਰੀ ਰਹਿੰਦਾ ਹੈ। ਫਿਰ GET /v1/calls/{call_id} ਨਾਲ ਕਾਲ ਖੋਲ੍ਹੋ: external_call_id Talkdesk ਇੰਟਰੈਕਸ਼ਨ ID ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ।

ਸੀਮਾਵਾਂ

  • Talkdesk ਵੱਧ ਤੋਂ ਵੱਧ 256 ਬਾਈਟ UUI ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ | ਜਾਂ ; ਨਾਲ ਵੱਖ ਕੀਤੇ ਮੁੱਲਾਂ ਦੀ ਆਗਿਆ ਨਹੀਂ ਦਿੰਦਾ, ਇਸ ਲਈ ਇੱਕੋ ਮੁੱਲ ਭੇਜੋ। ਹੈਂਡ-ਆਫ਼ ID ਇਸ ਵਿੱਚ ਆ ਜਾਂਦੀ ਹੈ।
  • Talkdesk ਦੇ API ਏਜੰਟ ਦੀ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਨਹੀਂ ਪੜ੍ਹ ਸਕਦੇ। ਇਸ ਦੀ ਬਜਾਏ ਹੈਂਡ-ਆਫ਼ ਲੁੱਕਅੱਪ ਜਾਂ GET /v1/calls/{call_id} ਵਰਤੋ।