---
title: "Twilio থেকে সংযোগ করুন"
description: "CallSid ব্যবহার করে SIP-এর মাধ্যমে Twilio কল একটি ThunderPhone এজেন্টে পাঠান এবং ট্রান্সফার ঠিকানায় হ্যান্ড-অফসহ আপনার referUrl-এর মাধ্যমে সেগুলো ফিরিয়ে নিন।"
---

আপনার TwiML একটি হেডারে কলের `CallSid` সহ এজেন্টের SIP ঠিকানায় ডায়াল করে।
কলারের কোনো ব্যক্তির প্রয়োজন হলে, এজেন্ট একটি SIP `REFER` পাঠায়, Twilio হ্যান্ড-অফসহ
ট্রান্সফার ঠিকানাটি আপনার `referUrl` হ্যান্ডলারে পাঠায়, এবং আপনার হ্যান্ডলার যে TwiML
ফিরিয়ে দেয় তা নির্ধারণ করে কলার কোথায় যাবে, যেমন একটি Flex কিউতে।

## শুরু করার আগে

- একটি ThunderPhone এজেন্ট এবং একটি প্রতিষ্ঠান [API কী](/bn/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 থেকে কল গ্রহণ করতে চাইলে, দেখুন
[উৎস IP সীমিত করুন](/bn/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 থাকে। এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন
[ট্রান্সফার নম্বর যোগ করুন](/bn/guides/contact-centers/overview)
এবং [ট্রান্সফার ঠিকানার ভেতরের হেডার](/bn/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 সম্পূর্ণ ঠিকানাটি `ReferTransferTarget` হিসেবে আপনার `referUrl`-এ পাঠায়,
উদাহরণস্বরূপ `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`।
আপনার হ্যান্ডলার এটি থেকে হেডারগুলো পড়ে এবং কলার পরবর্তী কোথায় যাবে তার জন্য
TwiML ফেরত দেয়। ঠিকানার user অংশটি (`support`) আপনি পছন্দমতো নির্ধারণ করতে পারেন,
তাই প্রতিটি গন্তব্যের জন্য একটি করে ট্রান্সফার নম্বর যোগ করে সেটির ভিত্তিতে রাউট করতে পারেন।

এই Twilio Function হ্যান্ড-অফটিকে task attributes হিসেবে রেখে কলারকে Flex-এ কিউতে
যোগ করে এবং হ্যান্ড-অফ id দিয়ে সারাংশ খুঁজে বের করে। এই লুকআপটি একটি Function-এ
চলে, কারণ Studio-এর HTTP Request widget `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);
};
```

Function-এর environment variables-এ API key রাখুন। অন্যান্য ফিল্ডের জন্য
[হ্যান্ড-অফ করা কল খুঁজে দেখুন](/api-reference/calls#look-up-a-handed-off-call)
দেখুন।

## এটি পরীক্ষা করুন

উপরের TwiML ফেরত দেয় এমন একটি Twilio নম্বরে কল করুন, এজেন্টের কাছে একজন ব্যক্তির
জন্য অনুরোধ করুন, এবং নিশ্চিত করুন যে আপনার `referUrl` হ্যান্ডলার উভয় হেডারসহ
`ReferTransferTarget` পাচ্ছে ও কলার কিউতে পৌঁছাচ্ছে। তারপর `GET /v1/calls/{call_id}`
দিয়ে কলটি খুলুন: `external_call_id`-এ `CallSid` থাকা উচিত।

## সীমাবদ্ধতা

- Twilio `Refer-To`-কে 256 অক্ষরে সীমাবদ্ধ রাখে। ThunderPhone ঠিকানাটি 254 অক্ষরের
  মধ্যে রাখে এবং না-ধরা কোনো হেডার বাদ দেয়, তাই হেডারের নাম ও মান ছোট রাখুন।
- Twilio একটি `BYE`-এ হেডার পড়ার বিষয়টি নথিভুক্ত করেনি, তাই রিটার্নের মাধ্যমে
  হ্যান্ড-অফ আবার Twilio-তে ফেরত নেওয়া যায় না। উপরের মতো `REFER` ব্যবহার করুন।
- `<Conference>` বা `<Queue>`-এর মাধ্যমে সংযুক্ত কলে Twilio একটি `REFER` গ্রহণ করে
  না, তাই উপরের মতো `<Dial><Sip>` দিয়ে এজেন্টকে ডায়াল করুন।
