---
title: "Twilio-യിൽ നിന്ന് കണക്റ്റ് ചെയ്യുക"
description: "CallSid ഉപയോഗിച്ച് Twilio കോളുകൾ SIP വഴി ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക. ട്രാൻസ്ഫർ വിലാസത്തിൽ ഹാൻഡ്-ഓഫ് ഉൾപ്പെടുത്തി, നിങ്ങളുടെ referUrl വഴി അവ തിരികെ സ്വീകരിക്കുക."
---

നിങ്ങളുടെ TwiML, കോളിന്റെ `CallSid` ഒരു ഹെഡറിൽ ഉൾപ്പെടുത്തി ഏജന്റിന്റെ SIP വിലാസത്തിലേക്ക് ഡയൽ ചെയ്യുന്നു.
കോളർക്ക് ഒരു വ്യക്തിയെ ആവശ്യമാകുമ്പോൾ, ഏജന്റ് ഒരു SIP `REFER` അയയ്ക്കുന്നു, Twilio അതിലുള്ള കൈമാറ്റ വിവരത്തോടൊപ്പം ട്രാൻസ്ഫർ വിലാസം നിങ്ങളുടെ `referUrl` ഹാൻഡ്‌ലറിലേക്ക് കൈമാറുന്നു, തുടർന്ന് നിങ്ങളുടെ ഹാൻഡ്‌ലർ നൽകുന്ന TwiML കോളർ എവിടേക്ക് പോകണമെന്ന് തീരുമാനിക്കുന്നു, ഉദാഹരണത്തിന് ഒരു Flex ക്യൂവിലേക്ക്.

## ആരംഭിക്കുന്നതിന് മുമ്പ്

- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ [API കീ](/ml/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കൾ നിയന്ത്രിക്കുക](/ml/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`, ഏജന്റിന്റെ `REFER` Twilioയ്ക്ക് സ്വീകരിക്കാൻ അനുവദിക്കുന്നു; ഇത് ഇല്ലെങ്കിൽ ട്രാൻസ്ഫർ [പിശക് 13802](https://www.twilio.com/docs/api/errors/13802) സഹിതം പരാജയപ്പെടും. `answerOnBridge="true"` പുതിയ ലക്ഷ്യസ്ഥാനം മറുപടി നൽകുന്നതുവരെ കോളറെ കണക്റ്റ് ചെയ്ത നിലയിൽ നിലനിർത്തുന്നു, അതിനാൽ പരാജയപ്പെട്ട ട്രാൻസ്ഫറിന് ബദലായി പ്രവർത്തിക്കാം.

Studioയുടെ **കോൾ ഇതിലേക്ക് കണക്റ്റ് ചെയ്യുക** വിജറ്റ് ഇഷ്ടാനുസൃത ഹെഡറുകളെയോ `referUrl`-നെയോ രേഖപ്പെടുത്തുന്നില്ല, അതിനാൽ Studioയിൽ നിന്ന് കോൾ ഈ TwiML-ലേക്ക് കൈമാറുക, ഉദാഹരണത്തിന് ഒരു **TwiML റീഡയറക്ട്** വിജറ്റ് ഉപയോഗിച്ച്.

## 3. കോൾ തിരികെ സ്വീകരിക്കുക

ഏജന്റ്, ഹാൻഡ്-ഓഫ് ഐഡിയും ഉദ്ദേശ്യവും ഉൾക്കൊള്ളുന്ന ട്രാൻസ്ഫർ വിലാസമുള്ള ഒരു `REFER` ഉപയോഗിച്ച് ട്രാൻസ്ഫർ ചെയ്യുന്നു. ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക ([ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക](/ml/guides/contact-centers/overview)
കൂടാതെ [ട്രാൻസ്ഫർ വിലാസത്തിനുള്ളിലെ ഹെഡറുകൾ](/ml/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 മടക്കി നൽകുന്നു. വിലാസത്തിന്റെ ഉപയോക്തൃ ഭാഗം (`support`) നിങ്ങൾക്ക് തിരഞ്ഞെടുക്കാവുന്നതാണ്, അതിനാൽ ഓരോ ലക്ഷ്യസ്ഥാനത്തിനും ഒരു ട്രാൻസ്ഫർ നമ്പർ ചേർത്ത് അതിന്റെ അടിസ്ഥാനത്തിൽ റൂട്ട് ചെയ്യാം.

ഈ Twilio Function, ഹാൻഡ്-ഓഫിനെ ടാസ്‌ക് ആട്രിബ്യൂട്ടുകളായി ഉൾപ്പെടുത്തി വിളിക്കുന്നയാളെ Flex-ലേക്ക് ക്യൂ ചെയ്യുകയും ഹാൻഡ്-ഓഫ് ഐഡി ഉപയോഗിച്ച് സംഗ്രഹം കണ്ടെത്തുകയും ചെയ്യുന്നു. Studio-യിലെ HTTP Request വിജറ്റ് `Authorization`
ഹെഡർ അയയ്ക്കാൻ കഴിയാത്തതിനാൽ ലുക്കപ്പ് ഒരു Function-ലാണ് പ്രവർത്തിക്കുന്നത്:

```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)
കാണുക.

## ഇത് പരിശോധിക്കുക

മുകളിലെ TwiML മടക്കി നൽകുന്ന ഒരു Twilio നമ്പറിലേക്ക് വിളിക്കുക, ഒരു വ്യക്തിയിലേക്ക് ബന്ധിപ്പിക്കാൻ ഏജന്റിനോട് ആവശ്യപ്പെടുക,
തുടർന്ന് രണ്ട് ഹെഡറുകളോടുകൂടിയ `ReferTransferTarget` നിങ്ങളുടെ `referUrl` ഹാൻഡ്‌ലറിന് ലഭിക്കുന്നുണ്ടെന്നും വിളിക്കുന്നയാൾ ക്യൂവിലെത്തുന്നുണ്ടെന്നും പരിശോധിക്കുക. തുടർന്ന്
`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>` ഉപയോഗിച്ച് ഏജന്റിലേക്ക് ഡയൽ ചെയ്യുക.
