---
title: "Σύνδεση από το Twilio"
description: "Στείλτε κλήσεις Twilio σε έναν πράκτορα ThunderPhone μέσω SIP με το CallSid και επιστρέψτε τες μέσω του referUrl σας, με την παράδοση στη διεύθυνση μεταφοράς."
---

Το TwiML σας καλεί τη διεύθυνση SIP του πράκτορα με το `CallSid` της κλήσης σε μια κεφαλίδα.
Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας στέλνει ένα SIP `REFER`, το Twilio προωθεί τη
διεύθυνση μεταφοράς με την παράδοση μέσα σε αυτήν στον χειριστή `referUrl` σας και το
TwiML που επιστρέφει ο χειριστής σας αποφασίζει πού θα μεταβεί ο καλών, όπως σε μια ουρά Flex.

## Πριν ξεκινήσετε

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Twilio Programmable Voice και ένα σημείο για την εξυπηρέτηση TwiML και ενός
  χειριστή `referUrl`: ο δικός σας διακομιστής ή ένα TwiML Bin και μια Twilio Function. Το Flex είναι
  προαιρετικό.

## 1. Δημιουργήστε το τελικό σημείο SIP

Το `<Sip>` του Twilio δέχεται όνομα χρήστη και κωδικό πρόσβασης, επομένως χρησιμοποιήστε ένα τυπικό τελικό σημείο:

```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 προέλευσης](/el/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. Κάθε τιμή φτάνει στο
  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`, του οποίου η διεύθυνση μεταφοράς περιέχει το αναγνωριστικό και την πρόθεση μεταβίβασης. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε
[Προσθήκη αριθμού μεταφοράς](/el/guides/contact-centers/overview)
και [Κεφαλίδες μέσα στη διεύθυνση μεταφοράς](/el/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 με τη μεταβίβαση ως
χαρακτηριστικά εργασίας και αναζητά τη σύνοψη βάσει αναγνωριστικού μεταβίβασης. Η αναζήτηση εκτελείται σε
Συνάρτηση επειδή το γραφικό στοιχείο Αίτημα HTTP του Studio δεν μπορεί να στείλει την κεφαλίδα `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)
για τα υπόλοιπα πεδία.

## Δοκιμάστε το

Καλέστε έναν αριθμό Twilio που επιστρέφει το παραπάνω TwiML, ζητήστε από τον πράκτορα να μιλήσετε με ένα άτομο,
και ελέγξτε ότι ο χειριστής `referUrl` λαμβάνει το `ReferTransferTarget` με αμφότερες τις
κεφαλίδες και ότι ο καλών φτάνει στην ουρά. Στη συνέχεια, ανοίξτε την κλήση με
`GET /v1/calls/{call_id}`: το `external_call_id` πρέπει να είναι το `CallSid`.

## Περιορισμοί

- Το Twilio περιορίζει το `Refer-To` στους 256 χαρακτήρες. Το ThunderPhone διατηρεί τη διεύθυνση στους
  254 και παραλείπει μια κεφαλίδα που δεν χωράει, επομένως διατηρήστε σύντομα τα ονόματα και τις τιμές
  κεφαλίδων.
- Το Twilio δεν τεκμηριώνει την ανάγνωση κεφαλίδων σε `BYE`, επομένως μια επιστροφή δεν μπορεί να μεταφέρει
  τη μεταβίβαση πίσω στο Twilio. Χρησιμοποιήστε ένα `REFER` όπως παραπάνω.
- Το Twilio δεν δέχεται `REFER` σε κλήση που συνδέεται μέσω `<Conference>` ή
  `<Queue>`, επομένως καλέστε τον πράκτορα με `<Dial><Sip>` όπως παραπάνω.
