Open in
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ਲਿਖੋ।- ਇਸੇ ਤਰੀਕੇ ਨਾਲ ਹੋਰ ਸੰਦਰਭ ਜੋੜੋ, ਜਿਵੇਂ ਕਿ
&X-Account-Id=12345। TwiML ਦੇ ਅੰਦਰ,&ਨੂੰ&ਵਜੋਂ ਲਿਖੋ, ਕਿਉਂਕਿ ਇਕੱਲਾ&ਅਵੈਧ XML ਹੈ। ਹਰ ਇੱਕ prompt ਤੱਕ ਇੱਕ ਵੇਰੀਏਬਲ ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ, ਇੱਥੇ{{sip_x_account_id}}। Twiliox-ਹੈਡਰਾਂ ਅਤੇUser-to-Userਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ, ਪ੍ਰਤੀਸ਼ਤ-ਏਨਕੋਡ ਕੀਤੇ ਹੋਏ, ਜਿਸ ਵਿੱਚ ਪੂਰਾ URI 255 ਅੱਖਰਾਂ ਤੋਂ ਘੱਟ ਅਤੇ ਹੈਡਰ 1,024 ਤੋਂ ਘੱਟ ਹੋਣ। referUrlTwilio ਨੂੰ ਏਜੰਟ ਦਾ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>ਨਾਲ ਡਾਇਲ ਕਰੋ।