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

Contact centers

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

AI Agent Connect ਨਾਲ Five9 ਕਾਲਾਂ ਨੂੰ SIP ਰਾਹੀਂ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਉਹਨਾਂ ਰੂਟਿੰਗ ਹੈਡਰਾਂ ਨਾਲ ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰੋ ਜੋ ਤੁਹਾਡੀ IVR ਸਕ੍ਰਿਪਟ ਪੜ੍ਹਦੀ ਹੈ।

ਤੁਹਾਡੀ Five9 IVR ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ Five9 ਦੇ ਕਾਲ ਵੇਰਵਿਆਂ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦੀ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਮੁੱਕ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਇਹ SIP BYE ਉੱਤੇ ਰੂਟਿੰਗ ਹੈਡਰਾਂ ਨਾਲ ਕਾਲ ਬੰਦ ਕਰਦਾ ਹੈ, ਜਿਨ੍ਹਾਂ ਨੂੰ ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ ਰੂਟ ਕਰਨ ਲਈ ਕਾਲ ਵੇਰੀਏਬਲਾਂ ਵਿੱਚ ਪੜ੍ਹਦੀ ਹੈ।

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

  • ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ API ਕੁੰਜੀ।
  • Five9 ਦਾ AI ਏਜੰਟ ਕਨੈਕਟ ਐਡ-ਆਨ। Five9 ਇਸਨੂੰ ਆਪਣੇ ਮਾਨਤਾ-ਪ੍ਰਾਪਤ AI ਪ੍ਰਦਾਤਾਵਾਂ ਤੱਕ ਸੀਮਿਤ ਰੱਖਦਾ ਹੈ ਅਤੇ Five9 ਦੀ ਇੰਪਲੀਮੈਂਟੇਸ਼ਨ ਟੀਮ ਇਸਨੂੰ ਸੈੱਟ ਅੱਪ ਕਰਦੀ ਹੈ: ਇਹ ਪ੍ਰਦਾਤਾ ਦਾ IVR ਸਕ੍ਰਿਪਟ ਟੈਂਪਲੇਟ ਇੰਪੋਰਟ ਕਰਦੀ ਹੈ, ਕਾਲ ਵੇਰੀਏਬਲ ਬਣਾਉਂਦੀ ਹੈ ਅਤੇ ਸਕ੍ਰਿਪਟ ਦੇ ਥਰਡ ਪਾਰਟੀ ਟ੍ਰਾਂਸਫਰ ਮੋਡੀਊਲ ਨੂੰ ਪ੍ਰਦਾਤਾ ਵੱਲ ਪੌਇੰਟ ਕਰਦੀ ਹੈ। ThunderPhone ਹਾਲੇ Five9 ਦੀ ਮਾਨਤਾ-ਪ੍ਰਾਪਤ ਸੂਚੀ ਵਿੱਚ ਨਹੀਂ ਹੈ: ਇਸ ਦੇ ਆਧਾਰ 'ਤੇ ਯੋਜਨਾ ਬਣਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਆਪਣੀ Five9 ਅਕਾਊਂਟ ਟੀਮ ਜਾਂ ThunderPhone ਸਹਾਇਤਾ ਨਾਲ ਪੁੱਛੋ।

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

Five9 ਦਾ ਥਰਡ ਪਾਰਟੀ ਟ੍ਰਾਂਸਫਰ ਮੋਡੀਊਲ SIP ਪਤਾ ਨਹੀਂ, ਸਗੋਂ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ, ਅਤੇ ਹੋਰ ਪ੍ਰਦਾਤਾਵਾਂ ਦੇ Five9 ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਪਾਸਵਰਡ ਦੀ ਬਜਾਏ ਸਰੋਤ ਪਤੇ ਰਾਹੀਂ Five9 ਦੀ ਪ੍ਰਮਾਣਿਕਤਾ ਕਰਦੇ ਹਨ। ਇਸ ਲਈ Five9 ਜਿਸ ਨੰਬਰ ਨੂੰ ਡਾਇਲ ਕਰੇਗਾ, ਉਸਨੂੰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਵਜੋਂ ਵਰਤ ਕੇ ਇੱਕ 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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: Five9 ਤੋਂ ਪ੍ਰਾਪਤ ਤੁਹਾਡੇ Five9 ਡਾਟਾ ਸੈਂਟਰਾਂ ਦੀਆਂ SIP ਸਿਗਨਲਿੰਗ ਰੇਂਜਾਂ। ਹਰ ਇੱਕ ਜਨਤਕ IPv4 ਰੇਂਜ /16 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6 /48 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)।
  • dial_in_numbers: ਉਹ ਨੰਬਰ ਜਿਸਨੂੰ Five9 ਦੀ ਸਕ੍ਰਿਪਟ ਡਾਇਲ ਕਰੇਗੀ, ਉਸੇ ਤਰੀਕੇ ਨਾਲ ਲਿਖਿਆ ਹੋਇਆ ਜਿਸ ਤਰ੍ਹਾਂ Five9 ਇਸਨੂੰ ਭੇਜਦਾ ਹੈ। ਇਹ ਅਸਲੀ ਫ਼ੋਨ ਨੰਬਰ ਹੋਣਾ ਜ਼ਰੂਰੀ ਨਹੀਂ ਹੈ। ਇਹ ਪਹਿਲਾਂ ਹੀ ThunderPhone ਉੱਤੇ, ਫ਼ੋਨ ਨੰਬਰ ਵਜੋਂ ਜਾਂ ਕਿਸੇ ਹੋਰ ਐਂਡਪੁਆਇੰਟ ਉੱਤੇ, ਵਰਤੋਂ ਵਿੱਚ ਨਹੀਂ ਹੋ ਸਕਦਾ: ਅਜਿਹਾ ਹੋਣ 'ਤੇ 409 ਵਾਪਸ ਆਉਂਦਾ ਹੈ।

Five9 ਦੇ ਪਤੇ ਇਸਦੇ ਸਾਰੇ ਗਾਹਕਾਂ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਇਸ ਲਈ ਕੋਈ ਵੀ ਹੋਰ Five9 ਗਾਹਕ ਜੋ ਇਹ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ, ਤੁਹਾਡੇ ਏਜੰਟ ਤੱਕ ਪਹੁੰਚੇਗਾ। ਜਿੱਥੇ ਤੁਸੀਂ ਨੰਬਰ ਚੁਣਦੇ ਹੋ, ਉੱਥੇ ਅਜਿਹਾ ਲੰਮਾ ਨੰਬਰ ਚੁਣੋ ਜਿਸਦਾ ਕੋਈ ਅੰਦਾਜ਼ਾ ਨਾ ਲਗਾ ਸਕੇ (ਵੱਧ ਤੋਂ ਵੱਧ 15 ਅੰਕ), ਯਕੀਨੀ ਬਣਾਓ ਕਿ Five9 ਇਸਨੂੰ ਫ਼ੋਨ ਨੈੱਟਵਰਕ ਵੱਲ ਬਾਹਰ ਭੇਜਣ ਦੀ ਬਜਾਏ ThunderPhone ਨੂੰ ਭੇਜਦਾ ਹੈ, ਅਤੇ ਇਸਨੂੰ ਪ੍ਰਕਾਸ਼ਿਤ ਨਾ ਕਰੋ।

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

Five9 ਦੀ ਇੰਪਲੀਮੈਂਟੇਸ਼ਨ ਟੀਮ ਨੂੰ ਕਹੋ ਕਿ ਉਹ:

  • ਥਰਡ ਪਾਰਟੀ ਟ੍ਰਾਂਸਫਰ ਮੋਡੀਊਲ ਤੋਂ ਕਾਲ ਨੂੰ sip:+14155550188@sip.thunderphone.com ਉੱਤੇ ਭੇਜੇ, ਜਿਸ ਵਿੱਚ ਨੰਬਰ ਬੇਨਤੀ URI ਅਤੇ To ਹੈਡਰ ਦੋਵਾਂ ਵਿੱਚ ਹੋਵੇ। ਮੋਡੀਊਲ ਪ੍ਰਦਾਤਾ ਦੇ SIP ਡੋਮੇਨ ਨੂੰ ਹੈਡਰ ਵਿੱਚ ਰੱਖ ਕੇ ਨੰਬਰ ਲੈਂਦਾ ਹੈ।
  • ਇਸਨੂੰ TLS (ਪੋਰਟ 5061) ਜਾਂ TCP (ਪੋਰਟ 5060) ਰਾਹੀਂ ਭੇਜੇ। ਐਂਡਪੁਆਇੰਟ UDP ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ ਅਤੇ Five9 ਇਹ ਪ੍ਰਕਾਸ਼ਿਤ ਨਹੀਂ ਕਰਦਾ ਕਿ ਇਹ ਕਿਹੜਾ ਟ੍ਰਾਂਸਪੋਰਟ ਵਰਤਦਾ ਹੈ, ਇਸ ਲਈ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਇਹ UDP ਨਾ ਹੋਵੇ।
  • ਤੀਜੀ ਪਾਰਟੀ ਕਾਲ ਤੋਂ ਬਾਅਦ ਵਾਪਸ ਆਓ ਚਾਲੂ ਕਰੋ, ਤਾਂ ਜੋ ਏਜੰਟ ਵੱਲੋਂ ਕਾਲ ਬੰਦ ਕਰਨ 'ਤੇ ਸਕ੍ਰਿਪਟ ਜਾਰੀ ਰਹੇ (Five9 ਤੀਜੀ-ਪਾਰਟੀ ਕਾਲ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ 3,600 ਸਕਿੰਟ ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ)।

Five9 ਦੀ ਗਾਈਡ ਉਹ ਮੁੱਲ ਸੂਚੀਬੱਧ ਕਰਦੀ ਹੈ ਜੋ ਇਹ ਭੇਜਦਾ ਹੈ (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name ਅਤੇ ਹੋਰ), ਪਰ ਉਹਨਾਂ ਦੇ ਹੈਡਰ ਨਾਮ ਨਹੀਂ। ਹੋਰ AI ਪ੍ਰਦਾਤਾਵਾਂ ਦੇ Five9 ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਉਹਨਾਂ ਨੂੰ ਵਾਇਰ ਉੱਤੇ X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign ਅਤੇ X-AgentID ਵਜੋਂ ਦਸਤਾਵੇਜ਼ ਕਰਦੇ ਹਨ; ਆਪਣੀ ਪਹਿਲੀ ਟੈਸਟ ਕਾਲ 'ਤੇ ਉਹਨਾਂ ਦੀ ਜਾਂਚ ਕਰੋ। ਹਰ ਇੱਕ ਪ੍ਰੌਮਪਟ ਤੱਕ ਇੱਕ ਵੇਰੀਏਬਲ ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ {{sip_x_callcampaign}}। X-CallID ਕਾਲ ਦੇ external_call_id ਵਜੋਂ ਸਟੋਰ ਹੁੰਦਾ ਹੈ।

3. ਕਾਲ ਵਾਪਸ ਲਓ

ਏਜੰਟ ਕਾਲ ਵਾਪਸ ਕਰਦਾ ਹੈ: ਇਹ ਅਲਵਿਦਾ ਕਹਿੰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਬੰਦ ਕਰਦਾ ਹੈ, ਅਤੇ BYE ਵਿੱਚ ਉਹ ਚਾਰ ਹੈਡਰ ਹੁੰਦੇ ਹਨ ਜੋ Five9 ਦੀ ਸਕ੍ਰਿਪਟ ਪੜ੍ਹਦੀ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType ਅਤੇ X-RouteValue ਸਕ੍ਰਿਪਟ ਨੂੰ ਦੱਸਦੇ ਹਨ ਕਿ ਕਾਲਰ ਨੂੰ ਕਿੱਥੇ ਭੇਜਣਾ ਹੈ, ਇੱਥੇ ਸਹਾਇਤਾ ਸਕਿਲ ਨੂੰ। ਹੋਰ ਪ੍ਰਦਾਤਾ X-RouteType ਲਈ ਜਿਨ੍ਹਾਂ ਮੁੱਲਾਂ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਕਰਦੇ ਹਨ, ਉਨ੍ਹਾਂ ਵਿੱਚ SkillTransfer, PhoneTransfer, Hangup ਅਤੇ DispositionOnly ਸ਼ਾਮਲ ਹਨ; ਮੁੱਲਾਂ ਬਾਰੇ ਸਕ੍ਰਿਪਟ ਸੰਭਾਲਣ ਵਾਲੇ ਵਿਅਕਤੀ ਨਾਲ ਸਹਿਮਤੀ ਕਰੋ। ਕਈ ਮੰਜ਼ਿਲਾਂ ਲਈ, ਹਰ ਮੰਜ਼ਿਲ ਲਈ ਵੱਖਰੇ ਨਾਮ ਅਤੇ X-RouteValue ਨਾਲ ਇੱਕ ਰਿਟਰਨ ਸ਼ਾਮਲ ਕਰੋ।
  • X-RouteReason ਏਜੰਟ ਦਾ ਇਰਾਦਾ ਲੇਬਲ ਰੱਖਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ billing_dispute।
  • X-CustomMetaData ਹੈਂਡ-ਆਫ ਆਈਡੀ ਰੱਖਦਾ ਹੈ। BYE ਇਸਨੂੰ X-TP-Handoff-Id ਵਜੋਂ ਵੀ ਰੱਖਦਾ ਹੈ, ਜਿਸਨੂੰ Five9 ਨਹੀਂ ਪੜ੍ਹਦਾ।

Five9 ਦੀ ਸਕ੍ਰਿਪਟ ਇਨ੍ਹਾਂ ਚਾਰ ਹੈਡਰਾਂ ਨੂੰ ਕਾਲ ਵੇਰੀਏਬਲਾਂ ਵਿੱਚ ਮੈਪ ਕਰਦੀ ਹੈ। ਏਜੰਟ ਦੇ ਸੰਖੇਪ ਲਈ, ਸਕ੍ਰਿਪਟ ਤੋਂ IVR ਕਵੇਰੀ ਮਾਡਿਊਲ ਨਾਲ ਹੈਂਡ-ਆਫ ਲੁੱਕਅੱਪ ਕਾਲ ਕਰਵਾਓ: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ਦੇ ਬਾਅਦ call.call_id, ਇੱਕ ਪ੍ਰਮਾਣਿਕਤਾ ਪ੍ਰੋਫ਼ਾਈਲ ਨਾਲ ਜੋ Authorization: Bearer ਅਤੇ ਤੁਹਾਡੀ API ਕੁੰਜੀ ਭੇਜਦਾ ਹੈ। ਵੇਖੋ ਹੈਂਡ-ਆਫ ਕੀਤੀ ਕਾਲ ਲੱਭੋ।

ਇਸਦੀ ਜਾਂਚ ਕਰੋ

IVR ਸਕ੍ਰਿਪਟ 'ਤੇ ਕਾਲ ਕਰੋ, ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਨਾਲ ਜੋੜਨ ਲਈ ਕਹੋ, ਅਤੇ ਜਾਂਚੋ ਕਿ ਸਕ੍ਰਿਪਟ ਭਰੇ ਹੋਏ ਕਾਲ ਵੇਰੀਏਬਲਾਂ ਨਾਲ ਕਾਲਰ ਨੂੰ ਰੂਟ ਕਰਦੀ ਹੈ। ਜੇ ਕਾਲ ਕਦੇ ਵੀ ਏਜੰਟ ਤੱਕ ਨਹੀਂ ਪਹੁੰਚਦੀ, ਤਾਂ ਜਾਂਚੋ ਕਿ ਬੇਨਤੀ URI ਅਤੇ To ਹੈਡਰ ਵਿੱਚ ਨੰਬਰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਨਾਲ ਮੇਲ ਖਾਂਦਾ ਹੈ, ਕਿ Five9 ਦਾ ਸਰੋਤ ਪਤਾ allowed_source_cidrs ਵਿੱਚ ਹੈ, ਅਤੇ ਕਿ ਕਾਲ TCP ਜਾਂ TLS ਰਾਹੀਂ ਆਈ ਸੀ। ਫਿਰ GET /v1/calls/{call_id} ਨਾਲ ਕਾਲ ਖੋਲ੍ਹੋ: sip_headers ਵਿੱਚ x-callid ਸੂਚੀਬੱਧ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ external_call_id Five9 ਵਿੱਚ call.call_id ਨਾਲ ਮੇਲ ਖਾਣਾ ਚਾਹੀਦਾ ਹੈ।

ਸੀਮਾਵਾਂ

  • Five9 ਦੀ ਗਾਈਡ BYE ਉੱਤੇ ਰੂਟਿੰਗ ਡਾਟਾ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਕਰਦੀ ਹੈ ਅਤੇ REFER ਸਵੀਕਾਰ ਕਰਨ ਦਾ ਜ਼ਿਕਰ ਨਹੀਂ ਕਰਦੀ, ਇਸ ਲਈ ਵਾਪਸੀ ਹੈਂਡ-ਆਫ ਸਕ੍ਰਿਪਟ ਦੁਆਰਾ ਕੀਤਾ ਕੋਲਡ ਟ੍ਰਾਂਸਫਰ ਹੈ।
  • Five9 X-RouteType, X-RouteValue, X-RouteReason ਅਤੇ X-CustomMetaData ਪੜ੍ਹਦਾ ਹੈ, User-to-User ਨਹੀਂ। ThunderPhone ਹਰੇਕ ਹੈਡਰ ਮੁੱਲ ਵੱਧ ਤੋਂ ਵੱਧ 256 ਬਾਈਟ ਲੰਬਾ ਭੇਜਦਾ ਹੈ।
  • Five9 ਪੈਕੇਟ ਫ੍ਰੈਗਮੈਂਟੇਸ਼ਨ ਤੋਂ ਬਚਣ ਲਈ ਕਸਟਮ ਹੈਡਰਾਂ ਦੀ ਗਿਣਤੀ ਲਗਭਗ ਦਸ ਤੱਕ ਰੱਖਣ ਦੀ ਸਿਫਾਰਸ਼ ਕਰਦਾ ਹੈ।