---
title: "Twilio இலிருந்து இணைக்கவும்"
description: "CallSid உடன் Twilio அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்டிற்கு அனுப்பி, பரிமாற்ற முகவரியில் hand-off உடன் உங்கள் referUrl மூலம் அவற்றை மீண்டும் பெறுங்கள்."
---

உங்கள் TwiML, அழைப்பின் `CallSid`-ஐ ஒரு ஹெடரில் சேர்த்து ஏஜென்ட்டின் SIP முகவரியை டயல் செய்கிறது.
அழைப்பாளருக்கு ஒருவர் தேவைப்படும்போது, ஏஜென்ட் ஒரு SIP `REFER`-ஐ அனுப்புகிறது; Twilio, அதில் உள்ள ஒப்படைப்பு விவரத்துடன் பரிமாற்ற முகவரியை உங்கள் `referUrl` ஹேண்ட்லருக்கு அனுப்புகிறது, மேலும் உங்கள் ஹேண்ட்லர் திருப்பும் TwiML, அழைப்பாளர் எங்கு செல்ல வேண்டும் என்பதைத் தீர்மானிக்கிறது, உதாரணமாக ஒரு Flex வரிசைக்கு.

## தொடங்குவதற்கு முன்

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனத்தின் [API விசை](/ta/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-களை வரம்பிடுக](/ta/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 தனக்கென ஒரு கால்-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`, ஏஜென்ட்டின் `REFER`-ஐ Twilio ஏற்க அனுமதிக்கிறது; இது இல்லையெனில் பரிமாற்றம் [பிழை 13802](https://www.twilio.com/docs/api/errors/13802) உடன் தோல்வியடையும்.
  `answerOnBridge="true"` புதிய இலக்கு பதிலளிக்கும் வரை அழைப்பாளரை இணைத்தே வைத்திருக்கும்; எனவே தோல்வியடைந்த பரிமாற்றம் மாற்று வழிக்குச் செல்லலாம்.

Studio-வின் **அழைப்பை இதனுடன் இணைக்கவும்** விட்ஜெட் தனிப்பயன் ஹெடர்கள் அல்லது
`referUrl`-ஐ ஆவணப்படுத்தவில்லை; எனவே Studio-விலிருந்து அழைப்பை இந்த TwiML-க்கு ஒப்படைக்கவும், உதாரணமாக ஒரு
**TwiML வழிமாற்று** விட்ஜெட்டைப் பயன்படுத்தி.

## 3. அழைப்பை மீண்டும் பெறுக

ஏஜென்ட், கையளிப்பு அடையாளம் மற்றும் நோக்கத்தைக் கொண்ட பரிமாற்ற முகவரியுடன் `REFER` மூலம் மாற்றுகிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும்
[பரிமாற்ற எண்ணைச் சேர்க்கவும்](/ta/guides/contact-centers/overview)
மற்றும் [பரிமாற்ற முகவரிக்குள் உள்ள தலைப்புகள்](/ta/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 செயல்பாடு, கையளிப்பை பணி பண்புக்கூறுகளாகக் கொண்டு அழைப்பாளரை Flex வரிசையில் சேர்க்கிறது மற்றும் கையளிப்பு அடையாளத்தின் மூலம் சுருக்கத்தைத் தேடுகிறது. 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 விசையை செயல்பாட்டின் சூழல் மாறிகளில் வைத்திருங்கள். மற்ற புலங்களுக்கு
[கையளிக்கப்பட்ட அழைப்பைத் தேடுக](/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 எழுத்துகளுக்குள் வைத்துக்கொண்டு, பொருந்தாத தலைப்பை விடுத்துவிடுகிறது; எனவே தலைப்புப் பெயர்களையும் மதிப்புகளையும் சுருக்கமாக வைத்திருங்கள்.
- `BYE`-இல் தலைப்புகளைப் படிப்பதை Twilio ஆவணப்படுத்தவில்லை; எனவே திரும்பும் அழைப்பு கையளிப்பை மீண்டும் Twilio-க்கு எடுத்துச் செல்ல முடியாது. மேலே உள்ளபடி `REFER` பயன்படுத்தவும்.
- `<Conference>` அல்லது `<Queue>` மூலம் இணைக்கப்பட்ட அழைப்பில் Twilio `REFER`-ஐ ஏற்காது; எனவே மேலே உள்ளபடி `<Dial><Sip>` மூலம் ஏஜென்ட்டை அழைக்கவும்.
