---
title: "Twilio నుండి కనెక్ట్ చేయండి"
description: "CallSid‌తో Twilio కాల్‌లను SIP ద్వారా ThunderPhone ఏజెంట్‌కు పంపండి మరియు ట్రాన్స్‌ఫర్ చిరునామాలోని హ్యాండ్-ఆఫ్‌తో మీ referUrl ద్వారా వాటిని తిరిగి పొందండి."
---

మీ TwiML కాల్ యొక్క `CallSid`ను హెడర్‌లో ఉంచి ఏజెంట్ SIP చిరునామాకు డయల్ చేస్తుంది.
కాలర్‌కు ఒక వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ SIP `REFER`ను పంపుతుంది, Twilio హ్యాండ్-ఆఫ్‌తో కూడిన బదిలీ చిరునామాను మీ `referUrl` హ్యాండ్లర్‌కు పంపుతుంది, ఆపై మీ హ్యాండ్లర్ తిరిగి ఇచ్చే TwiML కాలర్ ఎక్కడికి వెళ్లాలో నిర్ణయిస్తుంది, ఉదాహరణకు Flex క్యూ.

## ప్రారంభించే ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/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లను పరిమితం చేయండి](/te/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-` హెడర్‌లు మరియు percent-encoded `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. కాల్‌ను తిరిగి పొందండి

హ్యాండ్-ఆఫ్ id మరియు intent‌ను కలిగిన బదిలీ చిరునామాతో ఏజెంట్ `REFER` ద్వారా బదిలీ చేస్తుంది. ఈ బదిలీ నంబర్‌ను జోడించండి (చూడండి
[బదిలీ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview)
మరియు [బదిలీ చిరునామాలోని హెడర్‌లు](/te/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 క్యూలో ఉంచుతుంది మరియు హ్యాండ్-ఆఫ్ id ద్వారా సారాంశాన్ని వెతుకుతుంది. 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>`తో ఏజెంట్‌కు డయల్ చేయండి.
