---
title: "Twilio वरून कनेक्ट करा"
description: "CallSid सह SIP द्वारे Twilio कॉल ThunderPhone एजंटकडे पाठवा आणि ट्रान्सफर पत्त्यातील हँड-ऑफसह तुमच्या referUrl द्वारे ते परत घ्या."
---

तुमचे TwiML कॉलच्या `CallSid` सह हेडरमध्ये एजंटचा SIP पत्ता डायल करते.
कॉल करणाऱ्याला एखादी व्यक्ती हवी असल्यास, एजंट SIP `REFER` पाठवतो, Twilio
त्यामधील हस्तांतरण पत्त्यासह तुमच्या `referUrl` हँडलरकडे पाठवते आणि तुमचा हँडलर
परत करत असलेले TwiML कॉल करणारा कुठे जाईल हे ठरवते, उदाहरणार्थ Flex रांगेत.

## सुरू करण्यापूर्वी

- एक ThunderPhone एजंट आणि एक संस्था [API की](/mr/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 प्रतिबंधित करा](/mr/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 आणि हेतू असतो. हा हस्तांतरण क्रमांक जोडा (पहा
[हस्तांतरण क्रमांक जोडा](/mr/guides/contact-centers/overview)
आणि [हस्तांतरण पत्त्यातील हेडर्स](/mr/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)
पहा.

## चाचणी करा

वरील 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>` वापरून एजंटला डायल करा.
