---
title: "Twilio سے کنیکٹ کریں"
description: "CallSid کے ساتھ Twilio کالز کو SIP کے ذریعے ThunderPhone ایجنٹ کے پاس بھیجیں، اور ٹرانسفر ایڈریس میں ہینڈ آف کے ساتھ انہیں اپنے referUrl کے ذریعے واپس لیں۔"
---

آپ کی TwiML ایک ہیڈر میں کال کے `CallSid` کے ساتھ ایجنٹ کے SIP ایڈریس کو ڈائل کرتی ہے۔
جب کال کرنے والے کو کسی شخص کی ضرورت ہو، تو ایجنٹ SIP `REFER` بھیجتا ہے، Twilio منتقلی کے پتے کو اس میں موجود ہینڈ آف کے ساتھ آپ کے `referUrl` ہینڈلر تک پہنچاتا ہے، اور آپ کے ہینڈلر کی واپس کردہ TwiML طے کرتی ہے کہ کال کرنے والا کہاں جائے گا، مثلاً Flex قطار میں۔

## شروع کرنے سے پہلے

- ایک ThunderPhone ایجنٹ اور تنظیم کی [API کلید](/ur/guides/api-keys)۔
- Twilio Programmable Voice، اور TwiML اور `referUrl` ہینڈلر فراہم کرنے کے لیے کوئی جگہ: آپ کا اپنا سرور، یا TwiML Bin اور Twilio Function۔ Flex اختیاری ہے۔

## 1. SIP اینڈپوائنٹ بنائیں

Twilio کا `<Sip>` صارف نام اور پاس ورڈ لیتا ہے، اس لیے ایک معیاری اینڈپوائنٹ استعمال کریں:

```bash
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 سے کالز قبول کرنے کے لیے بھی، [ماخذ IPs محدود کریں](/ur/guides/sip-addresses) دیکھیں۔

## 2. سیاق کے ساتھ کالز بھیجیں

جس کال کو آپ ایجنٹ کے حوالے کرنا چاہتے ہیں، اس کے لیے یہ TwiML واپس کریں:

```xml
<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 اپنے کسی call-id ہیڈر کو دستاویز نہیں کرتا، اس لیے یہ شامل کریں: 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](https://www.twilio.com/docs/api/errors/13802) کے ساتھ ناکام ہو جاتی ہے۔ `answerOnBridge="true"` کال کرنے والے کو نئی منزل کے جواب دینے تک منسلک رکھتا ہے، تاکہ ناکام منتقلی کے لیے متبادل راستہ استعمال ہو سکے۔

Studio کا **کال اس سے جوڑیں** ویجٹ حسب ضرورت ہیڈرز یا `referUrl` کو دستاویز نہیں کرتا، اس لیے Studio سے کال کو اس TwiML کے حوالے کریں، مثلاً **TwiML ری ڈائریکٹ** ویجٹ کے ذریعے۔

## 3. کال واپس حاصل کریں

ایجنٹ `REFER` کے ذریعے منتقل کرتا ہے جس کے ٹرانسفر ایڈریس میں ہینڈ آف
id اور intent شامل ہوتے ہیں۔ یہ ٹرانسفر نمبر شامل کریں (دیکھیں
[ٹرانسفر نمبر شامل کریں](/ur/guides/contact-centers/overview)
اور [ٹرانسفر ایڈریس کے اندر ہیڈرز](/ur/guides/call-transfers)):

```json
{
  "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 Function کالر کو ہینڈ آف کو ٹاسک خصوصیات کے طور پر شامل کرتے ہوئے Flex میں
قطار میں ڈالتا ہے اور ہینڈ آف id کے ذریعے خلاصہ تلاش کرتا ہے۔ تلاش Function میں چلتی
ہے کیونکہ Studio کا HTTP Request ویجٹ `Authorization` ہیڈر نہیں بھیج سکتا:

```js
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 کلید کو Function کے ماحول کے متغیرات میں رکھیں۔ دیگر فیلڈز کے لیے
[ہینڈ آف کی گئی کال تلاش کریں](/api-reference/calls#look-up-a-handed-off-call)
دیکھیں۔

## اس کی جانچ کریں

ایسے 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>` کے ذریعے ڈائل کریں۔
