---
title: "Talkdesk'ten bağlanın"
description: "Talkdesk çağrılarını Autopilot Voice'a Bağlan ile bir ThunderPhone yapay zeka ajanına gönderin ve UUI içindeki aktarma kimliğiyle geri aktarın."
---

Talkdesk Studio akışınız, arayanı etkileşim kimliği ve UUI ile yapay zeka ajanına gönderir. Arayanın bir insana ihtiyacı olduğunda, ajan Talkdesk'e SIP
`REFER` ile yükseltir ve aktarım kimliği bir Studio değişkenine ulaşır.

## Başlamadan önce

- Bir ThunderPhone ajanı ve kuruluş [API anahtarı](/tr/guides/api-keys).
- **Harici Ses Akışı** modundaki Studio **Otopilot Sese Bağlan** bileşenini kapsayan bir Talkdesk **Konuşma Düzenleyici** lisansı
  ([Talkdesk makalesi](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk, yapay zeka ajanı çağrıyı sürdürürken dakika başına ücretlendirir.

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

Talkdesk yalnızca bir IP izin listesi belgeliyor; bu nedenle kaynak adresine göre
çağrıları kabul eden bir uç nokta oluşturun:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

Talkdesk makalesi sesin SRTP üzerinden gönderildiğini ve `"srtp": "optional"`
ayarının Talkdesk sunduğunda SRTP ile yanıt verdiğini belirtir. Makale, Talkdesk'in
SRTP gerektirip gerektirmediğini söylemez; Talkdesk gerekli olduğunu bildirirse
`srtp` değerini `required` olarak ayarlayın; bu ayar SRTP olmayan çağrıları reddeder.

Talkdesk'in SIP sinyalleşme aralıklarını Talkdesk'ten alın. Her biri `/16` veya
daha dar bir genel IPv4 aralığı olmalıdır (IPv6 için `/48` veya daha dar).
[Kaynak IP'ye göre kimlik doğrulayan platformlar](/tr/guides/sip-addresses)
bölümüne bakın. Talkdesk, SIP'i her Twilio müşterisinin paylaştığı Twilio ağından
gönderir; bu nedenle diğer arayanları dışarıda tutan şey uç noktanın adresidir:
adresini yayımlamayın.
Yanıttaki `sip_uri` değerini saklayın; örneğin
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

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

Studio akışınızda, **Harici Ses Akışı** modunda **Otopilot Sese Bağlan** ekleyin
ve hedefini uç noktanın sonuna `;transport=tls` eklenmiş `sip_uri` değeri olarak ayarlayın;
örneğin `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Uç nokta,
aksi belirtilmediği sürece Twilio SIP'in kullandığı UDP üzerinden gelen çağrıları reddeder.

Talkdesk şunları gönderir:

- Çağrının `external_call_id` değeri olarak saklanan `X-Talkdesk-Interaction-Id`;
- `business_hours=open` gibi onaltılık kodlanmış `User-to-User`. İstemlere kodu
  çözülmüş şekilde `{{sip_uui}}` olarak ulaşır.

Bileşenin 2.1 sürümü **Tanımlı başlıklar** da gönderebilir. Talkdesk'in tercihler
sayfası bunları WebSocket üzerinden gönderilen JSON olarak açıklar; bunlara güvenmeden
önce SIP başlıkları olarak ulaşıp ulaşmadıklarını Talkdesk ile doğrulayın.

## 3. Çağrıyı geri alın

Sesli AI ajanı, aktarım kimliği bu adresin içinde onaltılık UUI olarak yer alacak şekilde Talkdesk'in eskalasyon adresine bir `REFER` gönderir; Talkdesk bu kimliği yalnızca burada okur. Bu aktarım numarasını ekleyin (bkz.
[Aktarım numarasını ekleme](/tr/guides/contact-centers/overview)
ve [Aktarım adresindeki başlıklar](/tr/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Adres, Talkdesk makalesindeki adrestir. Bileşenin 2.1 sürümü
`autopilot_result=` değerini okur; 1.7 sürümü `escalate_to=` değerini okur;
bu nedenle 1.7'de bu anahtarı kullanın. `REFER` şu şekilde görünür:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk değeri bir Studio değişkenine yerleştirir. Özeti ve amacı almak için
Connections ile oluşturulmuş özel bir entegrasyona **Eylemi Çalıştır** adımı
ekleyin:

- Kimlik doğrulama türü **API anahtarı**, başlık adı `Authorization`, değer
  `Bearer sk_live_…`.
- İstek: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ifadesinin ardından değişkendeki kimliği ekleyin. Çağrıyı etkileşim kimliği
  ile `external_call_id` üzerinden de arayabilirsiniz.
- `handoff.intent` değerine göre yönlendirin ve `handoff.summary` değerini
  çağrıyı devralan kişiye gösterin.

Bkz. [Aktarılmış bir çağrıyı arama](/api-reference/calls#look-up-a-handed-off-call).

## Test edin

Studio akışı üzerinden bir çağrı başlatın, ajandan bir kişi isteyin ve akışın
bileşeni değişkenindeki aktarım kimliğiyle geçmeye devam ettiğini kontrol edin.
Ardından çağrıyı `GET /v1/calls/{call_id}` ile açın:
`external_call_id`, Talkdesk etkileşim kimliği olmalıdır.

## Sınırlar

- Talkdesk en fazla 256 bayt UUI okur ve `|` veya `;` ile ayrılmış değerlere
  izin vermez; bu nedenle tek bir değer gönderin. Aktarım kimliği sığar.
- Talkdesk API'leri ajanın dökümünü okuyamaz. Bunun yerine aktarım aramasını
  veya `GET /v1/calls/{call_id}` kullanın.
