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

Contact centers

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

CallSid ਨਾਲ SIP ਰਾਹੀਂ Twilio ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਪਤੇ ਵਿੱਚ ਹੈਂਡ-ਆਫ਼ ਦੇ ਨਾਲ ਉਹਨਾਂ ਨੂੰ ਆਪਣੇ referUrl ਰਾਹੀਂ ਵਾਪਸ ਲਵੋ।

ਤੁਹਾਡਾ TwiML ਕਾਲ ਦੇ CallSid ਨੂੰ ਇੱਕ ਹੈਡਰ ਵਿੱਚ ਰੱਖ ਕੇ ਏਜੰਟ ਦੇ SIP ਪਤੇ ਨੂੰ ਡਾਇਲ ਕਰਦਾ ਹੈ। ਜਦੋਂ ਕਾਲਰ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਏਜੰਟ ਇੱਕ SIP REFER ਭੇਜਦਾ ਹੈ, Twilio ਹੈਂਡ-ਆਫ ਦੇ ਨਾਲ ਟ੍ਰਾਂਸਫਰ ਪਤਾ ਤੁਹਾਡੇ referUrl ਹੈਂਡਲਰ ਨੂੰ ਭੇਜਦਾ ਹੈ, ਅਤੇ ਤੁਹਾਡਾ ਹੈਂਡਲਰ ਜੋ TwiML ਵਾਪਸ ਕਰਦਾ ਹੈ ਉਹ ਤੈਅ ਕਰਦਾ ਹੈ ਕਿ ਕਾਲਰ ਕਿੱਥੇ ਜਾਂਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ Flex ਕਤਾਰ ਵਿੱਚ।

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

  • ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ API ਕੁੰਜੀ।
  • Twilio Programmable Voice, ਅਤੇ TwiML ਅਤੇ ਇੱਕ referUrl ਹੈਂਡਲਰ ਸਰਵ ਕਰਨ ਲਈ ਕੋਈ ਥਾਂ: ਤੁਹਾਡਾ ਆਪਣਾ ਸਰਵਰ, ਜਾਂ ਇੱਕ TwiML Bin ਅਤੇ ਇੱਕ Twilio Function। Flex ਵਿਕਲਪਿਕ ਹੈ।

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

Twilio ਦਾ <Sip> ਯੂਜ਼ਰਨੇਮ ਅਤੇ ਪਾਸਵਰਡ ਲੈਂਦਾ ਹੈ, ਇਸ ਲਈ ਇੱਕ ਮਿਆਰੀ ਐਂਡਪੌਇੰਟ ਵਰਤੋ:

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": "Twilio"}'

ਜਵਾਬ ਵਿੱਚੋਂ password ਤੁਰੰਤ ਸੁਰੱਖਿਅਤ ਕਰੋ; ਇਹ ਸਿਰਫ਼ ਇੱਕ ਵਾਰ ਦਿਖਾਇਆ ਜਾਂਦਾ ਹੈ। ਕੇਵਲ Twilio ਤੋਂ ਕਾਲਾਂ ਸਵੀਕਾਰ ਕਰਨ ਲਈ, ਵੇਖੋ ਸਰੋਤ IP ਸੀਮਿਤ ਕਰੋ।

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

ਜਿਸ ਕਾਲ ਨੂੰ ਤੁਸੀਂ ਏਜੰਟ ਨੂੰ ਸੌਂਪਣਾ ਚਾਹੁੰਦੇ ਹੋ, ਉਸ ਲਈ ਇਹ TwiML ਵਾਪਸ ਕਰੋ:

<Response>
  <Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
    <Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
  </Dial>
</Response>
  • ;transport=tls ਮਹੱਤਵਪੂਰਨ ਹੈ: ਹੋਰ ਤਰੀਕੇ ਨਾਲ ਦੱਸੇ ਬਿਨਾਂ Twilio UDP ਵਰਤਦਾ ਹੈ।
  • X-Call-ID ਵਿੱਚ CallSid ਹੁੰਦਾ ਹੈ। Twilio ਆਪਣੇ ਕਿਸੇ ਕਾਲ-ਆਈਡੀ ਹੈਡਰ ਨੂੰ ਦਸਤਾਵੇਜ਼ਬੱਧ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਇਹ ਹੈਡਰ ਜੋੜੋ: ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੇ external_call_id ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ। {{CallSid}} ਇੱਕ TwiML Bin ਵਿੱਚ ਕੰਮ ਕਰਦਾ ਹੈ; ਆਪਣੇ ਸਰਵਰ ਤੋਂ, ਆਉਣ ਵਾਲੀ ਬੇਨਤੀ ਦਾ CallSid ਲਿਖੋ।
  • ਇਸੇ ਤਰੀਕੇ ਨਾਲ ਹੋਰ ਸੰਦਰਭ ਜੋੜੋ, ਜਿਵੇਂ ਕਿ &amp;X-Account-Id=12345। TwiML ਦੇ ਅੰਦਰ, & ਨੂੰ &amp; ਵਜੋਂ ਲਿਖੋ, ਕਿਉਂਕਿ ਇਕੱਲਾ & ਅਵੈਧ XML ਹੈ। ਹਰ ਇੱਕ prompt ਤੱਕ ਇੱਕ ਵੇਰੀਏਬਲ ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ, ਇੱਥੇ {{sip_x_account_id}}। Twilio x- ਹੈਡਰਾਂ ਅਤੇ User-to-User ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ, ਪ੍ਰਤੀਸ਼ਤ-ਏਨਕੋਡ ਕੀਤੇ ਹੋਏ, ਜਿਸ ਵਿੱਚ ਪੂਰਾ URI 255 ਅੱਖਰਾਂ ਤੋਂ ਘੱਟ ਅਤੇ ਹੈਡਰ 1,024 ਤੋਂ ਘੱਟ ਹੋਣ।
  • referUrl Twilio ਨੂੰ ਏਜੰਟ ਦਾ REFER ਸਵੀਕਾਰ ਕਰਨ ਦਿੰਦਾ ਹੈ; ਇਸ ਤੋਂ ਬਿਨਾਂ ਟ੍ਰਾਂਸਫਰ ਗਲਤੀ 13802 ਨਾਲ ਅਸਫਲ ਹੁੰਦਾ ਹੈ। answerOnBridge="true" ਕਾਲਰ ਨੂੰ ਨਵੀਂ ਮੰਜ਼ਿਲ ਦੇ ਜਵਾਬ ਦੇਣ ਤੱਕ ਕਨੈਕਟ ਰੱਖਦਾ ਹੈ, ਤਾਂ ਜੋ ਅਸਫਲ ਟ੍ਰਾਂਸਫਰ ਲਈ ਫਾਲਬੈਕ ਕੀਤਾ ਜਾ ਸਕੇ।

Studio ਦਾ ਕਾਲ ਨੂੰ ਇਸ ਨਾਲ ਕਨੈਕਟ ਕਰੋ ਵਿਜਟ ਕਸਟਮ ਹੈਡਰਾਂ ਜਾਂ referUrl ਨੂੰ ਦਸਤਾਵੇਜ਼ਬੱਧ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ Studio ਤੋਂ ਕਾਲ ਨੂੰ ਇਸ TwiML ਵੱਲ ਭੇਜੋ, ਉਦਾਹਰਨ ਲਈ ਇੱਕ TwiML ਰੀਡਾਇਰੈਕਟ ਵਿਜਟ ਨਾਲ।

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

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

{
  "name": "Twilio support",
  "number": "sip:support@acme.sip.twilio.com",
  "headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
  "headers_in_uri": true
}

Twilio ਪੂਰਾ ਪਤਾ ਤੁਹਾਡੇ referUrl ਨੂੰ ReferTransferTarget ਵਜੋਂ ਭੇਜਦਾ ਹੈ, ਉਦਾਹਰਨ ਲਈ <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>। ਤੁਹਾਡਾ ਹੈਂਡਲਰ ਇਸ ਵਿੱਚੋਂ ਹੈਡਰ ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਕਾਲਰ ਅਗਲੇ ਪੜਾਅ ਵਿੱਚ ਜਿੱਥੇ ਜਾਂਦਾ ਹੈ ਉਸ ਲਈ TwiML ਵਾਪਸ ਕਰਦਾ ਹੈ। ਪਤੇ ਦਾ ਯੂਜ਼ਰ ਹਿੱਸਾ (support) ਤੁਸੀਂ ਚੁਣ ਸਕਦੇ ਹੋ, ਇਸ ਲਈ ਤੁਸੀਂ ਹਰੇਕ ਮੰਜ਼ਿਲ ਲਈ ਇੱਕ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰ ਸਕਦੇ ਹੋ ਅਤੇ ਇਸ ਦੇ ਆਧਾਰ 'ਤੇ ਰੂਟ ਕਰ ਸਕਦੇ ਹੋ।

ਇਹ Twilio ਫੰਕਸ਼ਨ ਹੈਂਡ-ਆਫ਼ ਨੂੰ ਟਾਸਕ ਐਟ੍ਰਿਬਿਊਟਾਂ ਵਜੋਂ ਰੱਖ ਕੇ ਕਾਲਰ ਨੂੰ Flex ਵਿੱਚ ਕਤਾਰਬੱਧ ਕਰਦਾ ਹੈ ਅਤੇ ਹੈਂਡ-ਆਫ਼ ਆਈਡੀ ਰਾਹੀਂ ਸਾਰ ਲੱਭਦਾ ਹੈ। ਲੁੱਕਅੱਪ ਫੰਕਸ਼ਨ ਵਿੱਚ ਚੱਲਦਾ ਹੈ ਕਿਉਂਕਿ Studio ਦਾ HTTP ਰਿਕਵੈਸਟ ਵਿਜਿਟ Authorization ਹੈਡਰ ਨਹੀਂ ਭੇਜ ਸਕਦਾ:

exports.handler = async (context, event, callback) => {
  const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
  const params = new URLSearchParams(target.split("?")[1] || "");
  const handoffId = params.get("X-Handoff-Id") || "";
  const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
 
  if (handoffId) {
    const response = await fetch(
      "https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
      { headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
    );
    if (response.ok) {
      const call = await response.json();
      attributes.summary = (call.handoff && call.handoff.summary) || "";
    }
  }
 
  const twiml = new Twilio.twiml.VoiceResponse();
  twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
  callback(null, twiml);
};

API ਕੀ ਨੂੰ ਫੰਕਸ਼ਨ ਦੇ ਇਨਵਾਇਰਨਮੈਂਟ ਵੇਰੀਏਬਲਾਂ ਵਿੱਚ ਰੱਖੋ। ਹੋਰ ਫੀਲਡਾਂ ਲਈ ਹੈਂਡ-ਆਫ਼ ਕੀਤੀ ਕਾਲ ਲੱਭੋ ਵੇਖੋ।

ਇਸ ਦੀ ਜਾਂਚ ਕਰੋ

ਉਸ Twilio ਨੰਬਰ 'ਤੇ ਕਾਲ ਕਰੋ ਜੋ ਉੱਪਰ ਦਿੱਤਾ TwiML ਵਾਪਸ ਕਰਦਾ ਹੈ, ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਨਾਲ ਗੱਲ ਕਰਵਾਉਣ ਲਈ ਕਹੋ, ਅਤੇ ਜਾਂਚੋ ਕਿ ਤੁਹਾਡੇ referUrl ਹੈਂਡਲਰ ਨੂੰ ਦੋਵੇਂ ਹੈਡਰਾਂ ਸਮੇਤ ReferTransferTarget ਮਿਲਦਾ ਹੈ ਅਤੇ ਕਾਲਰ ਕਤਾਰ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ। ਫਿਰ GET /v1/calls/{call_id} ਨਾਲ ਕਾਲ ਖੋਲ੍ਹੋ: external_call_id CallSid ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।

ਸੀਮਾਵਾਂ

  • Twilio Refer-To ਨੂੰ 256 ਅੱਖਰਾਂ ਤੱਕ ਸੀਮਿਤ ਕਰਦਾ ਹੈ। ThunderPhone ਪਤੇ ਨੂੰ 254 ਅੱਖਰਾਂ ਤੱਕ ਰੱਖਦਾ ਹੈ ਅਤੇ ਜੋ ਹੈਡਰ ਫਿੱਟ ਨਹੀਂ ਹੁੰਦਾ ਉਸਨੂੰ ਛੱਡ ਦਿੰਦਾ ਹੈ, ਇਸ ਲਈ ਹੈਡਰ ਨਾਮ ਅਤੇ ਮੁੱਲ ਛੋਟੇ ਰੱਖੋ।
  • Twilio BYE ਉੱਤੇ ਹੈਡਰ ਪੜ੍ਹਨ ਬਾਰੇ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਦਿੰਦਾ, ਇਸ ਲਈ ਵਾਪਸੀ ਹੈਂਡ-ਆਫ਼ ਨੂੰ ਮੁੜ Twilio ਤੱਕ ਨਹੀਂ ਲੈ ਜਾ ਸਕਦੀ। ਉੱਪਰ ਦਿੱਤੇ ਅਨੁਸਾਰ REFER ਵਰਤੋ।
  • Twilio <Conference> ਜਾਂ <Queue> ਰਾਹੀਂ ਕਨੈਕਟ ਕੀਤੀ ਕਾਲ ਉੱਤੇ REFER ਸਵੀਕਾਰ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਉੱਪਰ ਦਿੱਤੇ ਅਨੁਸਾਰ ਏਜੰਟ ਨੂੰ <Dial><Sip> ਨਾਲ ਡਾਇਲ ਕਰੋ।