---
title: "Twilio'dan bağlanın"
description: "Twilio çağrılarını CallSid ile SIP üzerinden bir ThunderPhone yapay zeka ajanına gönderin ve aktarım adresindeki devirle referUrl'niz üzerinden geri alın."
---

TwiML'niz, çağrının `CallSid` değerini bir üst bilgide taşıyarak ajanın SIP adresini arar.
Arayanın bir insana ihtiyacı olduğunda ajan bir SIP `REFER` gönderir, Twilio aktarım
adresini aktarım bilgisiyle birlikte `referUrl` işleyicinize iletir ve işleyicinizin
döndürdüğü TwiML, arayanın örneğin bir Flex kuyruğu gibi nereye yönlendirileceğini belirler.

## Başlamadan önce

- Bir ThunderPhone yapay zeka ajanı ve bir kuruluş [API anahtarı](/tr/guides/api-keys).
- Twilio Programmable Voice ve TwiML ile bir `referUrl` işleyicisi sunabileceğiniz
  bir ortam: kendi sunucunuz veya bir TwiML Bin ve Twilio Function. Flex isteğe bağlıdır.

## 1. SIP uç noktasını oluşturun

Twilio'nun `<Sip>` öğesi bir kullanıcı adı ve parola alır; bu nedenle standart bir uç nokta kullanın:

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

Yanıttaki `password` değerini hemen saklayın; yalnızca bir kez gösterilir. Ayrıca
yalnızca Twilio'dan gelen çağrıları kabul etmek için
[Kaynak IP'leri kısıtlama](/tr/guides/sip-addresses) bölümüne bakın.

## 2. Çağrıları bağlamla gönderin

Ajana devretmek istediğiniz çağrı için bu TwiML'yi döndürün:

```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` önemlidir: Twilio aksi belirtilmedikçe UDP kullanır.
- `X-Call-ID`, `CallSid` değerini taşır. Twilio kendi çağrı kimliği üst bilgisini
  belgelemez; bu nedenle bunu ekleyin: ThunderPhone bunu çağrının
  `external_call_id` değeri olarak saklar. `{{CallSid}}` bir TwiML Bin içinde çalışır;
  kendi sunucunuzdan gönderiyorsanız gelen isteğin `CallSid` değerini yazın.
- `&amp;X-Account-Id=12345` gibi daha fazla bağlamı aynı şekilde ekleyin. TwiML içinde
  `&` karakterini `&amp;` olarak yazın; çünkü yalın bir `&` geçersiz XML'dir. Her biri
  isteme burada `{{sip_x_account_id}}` olarak bir değişken şeklinde ulaşır. Twilio,
  URI'nin tamamı 255 karakterin ve üst bilgilerin toplamı 1.024 karakterin altında
  olduğu sürece, yüzde kodlamalı `x-` üst bilgilerine ve `User-to-User` değerine izin verir.
- `referUrl`, Twilio'nun ajanın `REFER` isteğini kabul etmesini sağlar; bu olmadan
  aktarım [13802 hatasıyla](https://www.twilio.com/docs/api/errors/13802) başarısız olur.
  `answerOnBridge="true"`, yeni hedef yanıt verene kadar arayanı bağlı tutar; böylece
  başarısız bir aktarım için geri dönüş uygulanabilir.

Studio'nun **Çağrıyı Şuna Bağla** bileşeni özel üst bilgileri veya `referUrl` değerini
belgelemez; bu nedenle Studio'dan çağrıyı, örneğin bir **TwiML Yönlendirmesi** bileşeniyle
bu TwiML'ye aktarın.

## 3. Aramayı geri alın

Sesli AI ajanı, aktarım adresinde aktarma kimliği ve niyetini taşıyan bir `REFER`
ile aktarır. Bu aktarım numarasını ekleyin (bkz.
[Aktarım numarasını ekleme](/tr/guides/contact-centers/overview)
ve [Aktarım adresindeki üstbilgiler](/tr/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, tüm adresi `ReferTransferTarget` olarak `referUrl` adresinize gönderir;
örneğin `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`.
İşleyiciniz üstbilgileri bu adresten okur ve arayanın sonraki adımda nereye
gideceğine ilişkin TwiML'yi döndürür. Adresin kullanıcı bölümü (`support`)
sizin seçiminizdir; böylece her hedef için bir aktarım numarası ekleyebilir ve
buna göre yönlendirme yapabilirsiniz.

Bu Twilio Function, aktarma bilgilerini görev öznitelikleri olarak kullanarak
arayanı Flex kuyruğuna ekler ve özeti aktarma kimliğine göre arar. Arama işlemi
bir Function içinde çalışır; çünkü Studio'nun HTTP Request bileşeni
`Authorization` üstbilgisini gönderemez:

```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 anahtarını Function'ın ortam değişkenlerinde tutun. Diğer alanlar için
[aktarılmış bir aramayı arama](/api-reference/calls#look-up-a-handed-off-call)
bölümüne bakın.

## Test edin

Yukarıdaki TwiML'yi döndüren bir Twilio numarasını arayın, ajandan bir insanla
konuşmayı isteyin ve `referUrl` işleyicinizin her iki üstbilgiyle birlikte
`ReferTransferTarget` aldığını ve arayanın kuyruğa ulaştığını kontrol edin.
Ardından aramayı `GET /v1/calls/{call_id}` ile açın: `external_call_id`,
`CallSid` olmalıdır.

## Sınırlar

- Twilio, `Refer-To` değerini 256 karakterle sınırlar. ThunderPhone adresi
  254 karakterle sınırlar ve sığmayan üstbilgiyi dahil etmez; bu nedenle
  üstbilgi adlarını ve değerlerini kısa tutun.
- Twilio, bir `BYE` üzerindeki üstbilgilerin okunmasını belgelemez; bu nedenle
  geri dönüş, aktarma bilgisini Twilio'ya geri taşıyamaz. Yukarıdaki gibi bir
  `REFER` kullanın.
- Twilio, `<Conference>` veya `<Queue>` üzerinden bağlanan bir aramada `REFER`
  kabul etmez; bu nedenle yukarıdaki gibi ajanı `<Dial><Sip>` ile arayın.
