---
title: "Conectați-vă din Twilio"
description: "Trimiteți apelurile Twilio către un agent ThunderPhone prin SIP cu CallSid și preluați-le înapoi prin referUrl, cu transferul în adresa de transfer."
---

TwiML-ul dumneavoastră apelează adresa SIP a agentului vocal cu `CallSid` al apelului într-un antet.
Când apelantul are nevoie de o persoană, agentul vocal trimite un `REFER` SIP, Twilio transmite
adresa de transfer care conține predarea apelului către handlerul dumneavoastră `referUrl`, iar
TwiML-ul returnat de handlerul dumneavoastră decide unde ajunge apelantul, de exemplu într-o coadă Flex.

## Înainte de a începe

- Un agent vocal ThunderPhone și o [cheie API](/ro/guides/api-keys) a organizației.
- Twilio Programmable Voice și un loc pentru a servi TwiML și un handler
  `referUrl`: propriul server sau un TwiML Bin și o Twilio Function. Flex este
  opțional.

## 1. Creați endpointul SIP

Elementul `<Sip>` din Twilio acceptă un nume de utilizator și o parolă, așadar utilizați un endpoint standard:

```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"}'
```

Stocați imediat `password` din răspuns; este afișată o singură dată. Pentru a
accepta apeluri numai de la Twilio, consultați
[Restricționați IP-urile sursă](/ro/guides/sip-addresses).

## 2. Trimiteți apeluri cu context

Returnați acest TwiML pentru apelul pe care doriți să îl predați agentului vocal:

```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` este important: Twilio utilizează UDP dacă nu i se specifică altfel.
- `X-Call-ID` transmite `CallSid`. Twilio nu documentează un antet call-id
  propriu, așadar adăugați-l pe acesta: ThunderPhone îl stochează drept
  `external_call_id` al apelului. `{{CallSid}}` funcționează într-un TwiML Bin; de pe propriul server,
  includeți `CallSid` al cererii de intrare.
- Adăugați mai mult context în același mod, de exemplu `&amp;X-Account-Id=12345`. În
  TwiML, scrieți `&` ca `&amp;`, deoarece un `&` simplu este XML nevalid. Fiecare ajunge în
  prompt ca variabilă, aici `{{sip_x_account_id}}`. Twilio permite antete `x-`
  și `User-to-User`, codificate procentual, cu întregul URI sub 255 de caractere
  și antetele sub 1.024.
- `referUrl` permite Twilio să accepte `REFER`-ul agentului vocal; fără acesta, transferul
  eșuează cu [eroarea 13802](https://www.twilio.com/docs/api/errors/13802).
  `answerOnBridge="true"` menține apelantul conectat până când noua destinație
  răspunde, astfel încât un transfer eșuat să poată reveni la o opțiune alternativă.

Widgetul **Conectare apel către** din Studio nu documentează antete personalizate sau
`referUrl`, așadar din Studio predați apelul acestui TwiML, de exemplu cu un
widget **Redirecționare TwiML**.

## 3. Preluați apelul înapoi

Agentul vocal transferă apelul cu un `REFER` a cărui adresă de transfer conține
ID-ul și intenția predării. Adăugați acest număr de transfer (consultați
[Adăugați numărul de transfer](/ro/guides/contact-centers/overview)
și [Antete în adresa de transfer](/ro/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 trimite întreaga adresă către `referUrl` ca `ReferTransferTarget`, de
exemplu `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`.
Gestionarul dumneavoastră extrage antetele din aceasta și returnează TwiML
pentru următoarea destinație a apelantului. Partea de utilizator a adresei
(`support`) este la alegerea dumneavoastră, astfel încât puteți adăuga câte un
număr de transfer pentru fiecare destinație și puteți direcționa apelurile pe
baza acesteia.

Această Funcție Twilio pune apelantul în coada Flex cu datele predării ca
atribute ale sarcinii și caută rezumatul după ID-ul predării. Căutarea rulează
într-o Funcție deoarece widgetul HTTP Request din Studio nu poate trimite
antetul `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);
};
```

Păstrați cheia API în variabilele de mediu ale Funcției. Consultați
[Căutați un apel predat](/api-reference/calls#look-up-a-handed-off-call)
pentru celelalte câmpuri.

## Testați

Apelați un număr Twilio care returnează TwiML-ul de mai sus, cereți agentului
să vă transfere la o persoană și verificați că gestionarul `referUrl`
primește `ReferTransferTarget` cu ambele antete și că apelantul ajunge în
coadă. Apoi deschideți apelul cu `GET /v1/calls/{call_id}`: `external_call_id`
ar trebui să fie `CallSid`.

## Limite

- Twilio limitează `Refer-To` la 256 de caractere. ThunderPhone menține adresa
  la 254 de caractere și omite un antet care nu încape, așa că păstrați numele
  și valorile antetelor scurte.
- Twilio nu documentează citirea antetelor într-un `BYE`, astfel că o revenire
  nu poate transmite predarea înapoi către Twilio. Utilizați un `REFER` ca mai
  sus.
- Twilio nu acceptă un `REFER` pentru un apel conectat prin `<Conference>` sau
  `<Queue>`, așa că apelați agentul cu `<Dial><Sip>` ca mai sus.
