---
title: "Twilio ನಿಂದ ಸಂಪರ್ಕಿಸಿ"
description: "CallSid ಬಳಸಿ Twilio ಕರೆಗಳನ್ನು SIP ಮೂಲಕ ThunderPhone ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸಿ ಮತ್ತು ವರ್ಗಾವಣೆ ವಿಳಾಸದಲ್ಲಿರುವ ಹ್ಯಾಂಡ್-ಆಫ್‌ನೊಂದಿಗೆ ನಿಮ್ಮ referUrl ಮೂಲಕ ಅವುಗಳನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ."
---

ನಿಮ್ಮ TwiML ಕರೆಯ `CallSid` ಅನ್ನು ಹೆಡರ್‌ನಲ್ಲಿ ಸೇರಿಸಿ ಏಜೆಂಟ್‌ನ SIP ವಿಳಾಸಕ್ಕೆ ಡಯಲ್ ಮಾಡುತ್ತದೆ.
ಕರೆ ಮಾಡುವವರಿಗೆ ವ್ಯಕ್ತಿಯ ಅಗತ್ಯವಿದ್ದಾಗ, ಏಜೆಂಟ್ SIP `REFER` ಕಳುಹಿಸುತ್ತದೆ, Twilio ಹ್ಯಾಂಡ್‌ಆಫ್‌ನೊಂದಿಗೆ ವರ್ಗಾವಣೆ ವಿಳಾಸವನ್ನು ನಿಮ್ಮ `referUrl` ಹ್ಯಾಂಡ್ಲರ್‌ಗೆ ರವಾನಿಸುತ್ತದೆ, ಮತ್ತು ನಿಮ್ಮ ಹ್ಯಾಂಡ್ಲರ್ ಹಿಂತಿರುಗಿಸುವ TwiML ಕರೆ ಮಾಡುವವರು ಎಲ್ಲಿ ಹೋಗುತ್ತಾರೆ ಎಂಬುದನ್ನು ನಿರ್ಧರಿಸುತ್ತದೆ, ಉದಾಹರಣೆಗೆ Flex ಸರತಿಗೆ.

## ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು

- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ [API ಕೀ](/kn/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 ಗಳನ್ನು ನಿರ್ಬಂಧಿಸಿ](/kn/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 ತನ್ನದೇ ಆದ ಕಾಲ್-ಐಡಿ ಹೆಡರ್ ಅನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಇದನ್ನು ಸೇರಿಸಿ: ThunderPhone ಇದನ್ನು ಕರೆಯ `external_call_id` ಆಗಿ ಸಂಗ್ರಹಿಸುತ್ತದೆ. `{{CallSid}}` TwiML Bin ನಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ; ನಿಮ್ಮ ಸ್ವಂತ ಸರ್ವರ್‌ನಿಂದ, ಒಳಬರುವ ವಿನಂತಿಯ `CallSid` ಅನ್ನು ಬರೆಯಿರಿ.
- `&amp;X-Account-Id=12345` ನಂತಹ ಹೆಚ್ಚಿನ ಸಂದರ್ಭವನ್ನು ಇದೇ ರೀತಿಯಲ್ಲಿ ಸೇರಿಸಿ. TwiML ಒಳಗೆ, `&` ಬದಲಿಗೆ `&amp;` ಎಂದು ಬರೆಯಿರಿ, ಏಕೆಂದರೆ ಸರಳ `&` ಅಮಾನ್ಯ XML ಆಗಿದೆ. ಪ್ರತಿಯೊಂದೂ ಪ್ರಾಂಪ್ಟ್‌ಗೆ ಚರವಾಗಿ ತಲುಪುತ್ತದೆ, ಇಲ್ಲಿ `{{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` ಮೂಲಕ ವರ್ಗಾಯಿಸುತ್ತದೆ, ಇದರ ವರ್ಗಾವಣೆ ವಿಳಾಸವು ಹ್ಯಾಂಡ್-ಆಫ್
ಐಡಿ ಮತ್ತು ಉದ್ದೇಶವನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ನೋಡಿ
[ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ](/kn/guides/contact-centers/overview)
ಮತ್ತು [ವರ್ಗಾವಣೆ ವಿಳಾಸದೊಳಗಿನ ಹೆಡರ್ಗಳು](/kn/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 ಗೆ ಕ್ಯೂ ಮಾಡುತ್ತದೆ ಮತ್ತು ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಮೂಲಕ
ಸಾರಾಂಶವನ್ನು ಹುಡುಕುತ್ತದೆ. 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 ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡಿ, ಏಜೆಂಟ್ ಬಳಿ ಒಬ್ಬ
ವ್ಯಕ್ತಿಯನ್ನು ಕೇಳಿ, ಮತ್ತು ನಿಮ್ಮ `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>` ಬಳಸಿ ಏಜೆಂಟ್‌ಗೆ ಡಯಲ್ ಮಾಡಿ.
