# OpenAI Realtime SIP kurulumu: ses ajanını KobiKom numaranıza bağlama

> OpenAI Realtime’ı AI Entegrasyonu SIP Trunk ile numaranıza bağlayın: TLS ve SRTP şartları, gelen çağrı web kancası, dışarı arama hattı ve test adımları.

Kaynak: https://bilgibankasi.kobikom.com.tr/yapay-zeka/openai-realtime-sip-entegrasyonu · Kategori: Yapay Zeka Ses Platformları · Güncelleme: 2026-10-23 · Yayıncı: KobiKom (https://www.kobikom.com.tr)

**Başlamadan önce**

- Aktif bir KobiKom numarası (0850, coğrafi ya da taşınmış numara).
- **AI Entegrasyonu SIP Trunk** hizmeti. OpenAI’ın SIP girişi TLS ve SRTP ister; bu bağlantı bu hizmetle sağlanır.
- Bir OpenAI hesabı ve projesi ([platform.openai.com](https://platform.openai.com)).
- OpenAI’ın göndereceği web kancasını (webhook) karşılayacak bir sunucu.

OpenAI Realtime, gelen bir telefon aramasını SIP üzerinden alıp yapay zeka ajanınızla gerçek zamanlı konuşturabilir. Bunun için çağrının OpenAI’a **TLS ile şifrelenmiş sinyalleşme** ve **SRTP ile şifrelenmiş sesle** ulaşması gerekir. KobiKom, numaranızı AI Entegrasyonu SIP Trunk üzerinden OpenAI’ın beklediği biçimde bağlar; siz yalnız OpenAI tarafını ve çağrıyı karşılayan kodunuzu hazırlarsınız.

**Akış: Gelen bir arama OpenAI’a nasıl ulaşır?**
1. **Arayan → KobiKom**: Müşteriniz `0850 XXX XX XX`’i arar
2. **KobiKom → OpenAI Realtime**: Çağrı proje adresinize iletilir: TLS + SRTP
3. **OpenAI Realtime → Sunucunuz**: `realtime.call.incoming` web kancası
4. **Sunucunuz → OpenAI Realtime**: `accept` ile çağrı kabul edilir
5. **Arayan → OpenAI Realtime**: Ajanla görüşme; ses şifreli akar

_Arayanın numarası SIP başlığında OpenAI’a, oradan web kancasıyla sunucunuza ulaşır._

## Kim ne yapar?

1. **OpenAI projesi ve web kancası** (Siz · OpenAI): Proje kimliğinizi alır, gelen çağrılar için web kancası tanımlarsınız.
2. **Numara, TLS hesabı ve yönlendirme** (KobiKom ekibi): Numaranızı AI Entegrasyonu SIP Trunk’a bağlar, SIP hesabınızı açar, gelen çağrıları proje adresinize yönlendiririz.
3. **Çağrıyı karşılayan kod** (Siz · sunucunuz): Web kancasında çağrıyı kabul eder, ajanı WebSocket ile bağlarsınız.
4. **Test** (Siz · DigitalOffix): Gelen ve giden test aramalarını yapar, Çağrı Geçmişi’nden doğrularsınız.

## Bağlantı değerleri

Kendi SIP istemciniz ya da OpenAI’ın dışarı arama hattı için kullanacağınız değerler şunlardır. Alan adınız ve SIP hesabınız hizmet açılırken size iletilir.

| Alan | Değer | Not |
| --- | --- | --- |
| SIP sunucusu | _firmaniz.kobipbx.net_ | Size özel alan adı; IP adresi değil alan adı kullanın (sertifika alan adına göre doğrulanır). |
| Port | `5061` |  |
| Transport | `TLS` |  |
| Ses şifreleme | `SRTP (SDES), zorunlu` | Şifresiz arama teklifleri `488 Not Acceptable Here` ile reddedilir. |
| Şifreleme paketi | `AES_CM_128_HMAC_SHA1_80` |  |
| Kodek | `Opus, PCMU, PCMA` |  |
| Kullanıcı adı ve şifre | _Size iletilen SIP hesabı_ |  |

## 1. OpenAI tarafında hazırlık

### 1. Proje kimliğinizi bulun (Siz · OpenAI)

[platform.openai.com](https://platform.openai.com) adresinde **Settings → Project → General** ekranını açın. Proje kimliği `proj_` ile başlar.

| Alan | Değer | Not |
| --- | --- | --- |
| Project ID | _proj_XXXXXXXX_ |  |

### 2. Gelen çağrı web kancasını tanımlayın (Siz · OpenAI)

**Settings → Project → Webhooks** ekranında yeni bir web kancası oluşturun. Olay türü olarak `realtime.call.incoming` seçin; adres alanına çağrıyı karşılayacak sunucunuzun adresini yazın.

> Web kancası hangi projede tanımlıysa yönlendirme de o projenin kimliğine yapılmalıdır. Farklı proje kimliği iletilirse çağrı OpenAI’a ulaşır ama sunucunuza haber gelmez.

## 2. KobiKom tarafında yönlendirme

### 1. Talebinizi iletin (Siz)

Firma adınızı, numaranızı ve OpenAI proje kimliğinizi [destek ekibimize](https://bilgibankasi.kobikom.com.tr/baslarken/destek-kanallari) iletin. Verinin Avrupa’da işlenmesini istiyorsanız bunu da belirtin.

### 2. Yönlendirmeyi kurarız (KobiKom ekibi)

Ekibimiz numaranıza gelen çağrıları `sips:proj_XXXXXXXX@sip.api.openai.com` adresine (Avrupa için `sip-eu.api.openai.com`) TLS ve SRTP ile yönlendirir. Arayanın numarası SIP başlığında iletilir. Kurulum tamamlanınca size haber veririz.

## 3. Çağrıyı kabul etme

Çağrı geldiğinde OpenAI web kancanıza `realtime.call.incoming` olayını gönderir. Olayın içinde `call_id` ve arayanın bilgileri (`sip_headers` altında `From`) bulunur. Sunucunuz çağrıyı aşağıdaki isteklerle yönetir; her istekte `Authorization: Bearer <OPENAI_API_KEY>` başlığı gönderilir.

| İşlem | İstek |
| --- | --- |
| Kabul et | `POST https://api.openai.com/v1/realtime/calls/{call_id}/accept` |
| Reddet | `POST https://api.openai.com/v1/realtime/calls/{call_id}/reject` (kod verilmezse `603`) |
| Aktar | `POST https://api.openai.com/v1/realtime/calls/{call_id}/refer` (gövdede `target_uri`) |
| Kapat | `POST https://api.openai.com/v1/realtime/calls/{call_id}/hangup` |

Kabul ettikten sonra görüşmeyi `wss://api.openai.com/v1/realtime?call_id={call_id}` adresine WebSocket ile bağlanarak yönetirsiniz. Model kabul isteğinde seçildiği için bağlantıda ayrıca model belirtmezsiniz.

> `sip_headers` içindeki arayan bilgisi kimlik doğrulama yerine geçmez; OpenAI de bu bilgiyi güvenilmez kabul etmenizi önerir. Hesap bilgisi, ödeme ya da kişisel veri paylaşan işlemlerde arayanı ayrıca doğrulayın.

## 4. Giden aramalar

Giden aramalar için iki yol vardır:

- **Kendi uygulamanızdan:** SIP istemciniz yukarıdaki bağlantı değerleriyle hesabınıza TLS üzerinden kayıt olur ve aramayı başlatır; ses SRTP ile şifrelenir. Karşı tarafta KobiKom numaranız görünür.
- **OpenAI’ın kendisinden:** OpenAI dışarı aramayı Live API ile yapar ve bunun için bir SIP hattı ister. Bu özelliğin OpenAI organizasyonunuz için açık olması gerekir; açık değilse istek `outbound_sip_not_enabled` hatasıyla döner.

**OpenAI dışarı arama hattı (Live API) değerleri**

| Alan | Değer | Not |
| --- | --- | --- |
| `transport.trunk.provider_url` | `sips:firmaniz.kobipbx.net:5061` | `sips:` ile başlamalı; alan adınızı yazın. |
| `transport.trunk.auth.type` | `digest` |  |
| `transport.trunk.auth.username` / `password` | _Size iletilen SIP hesabı_ |  |
| `transport.trunk.caller_number` | `+90850XXXXXXX` | Numaranız, E.164 biçiminde. |
| `transport.destination` | `+905XXXXXXXXX` | Aranacak numara, E.164 biçiminde; SIP adresi desteklenmez. |

## 5. Test ve kontrol

### 1. Gelen aramayı deneyin (Siz · telefon)

Başka bir telefondan numaranızı arayın. Web kancanıza `realtime.call.incoming` olayı gelmeli; kabul ettiğinizde ajan konuşmaya başlamalı.

### 2. Giden aramayı deneyin (Siz · uygulama)

Uygulamanızdan ya da OpenAI üzerinden bir cep telefonunu arayın. Karşı tarafta KobiKom numaranız görünmeli.

### 3. Çağrı Geçmişi’nden doğrulayın (Siz · DigitalOffix)

**Ses Hizmeti → Çağrı Geçmişi** ekranında test aramalarınız **Gelen** ve **Giden** olarak görünmeli.

## Sık karşılaşılan sorunlar

| Belirti | Olası neden | Çözüm |
| --- | --- | --- |
| Numara çalıyor ama web kancası gelmiyor | Web kancası başka projede tanımlı ya da proje kimliği yanlış iletilmiş | Web kancasının tanımlı olduğu projenin kimliğini kontrol edip bize iletin |
| Web kancası geliyor ama ajan konuşmuyor | Çağrı kabul edilmemiş ya da WebSocket bağlantısı kurulmamış | `accept` isteğinin başarılı döndüğünü ve `call_id` ile bağlandığınızı kontrol edin |
| SIP istemciniz kayıt olamıyor | Transport UDP/TCP seçili ya da port 5060 girilmiş | Transport’u **TLS**, portu **5061** yapın; sunucuyu alan adıyla yazın |
| Arama `488 Not Acceptable Here` ile düşüyor | İstemcinizde ses şifrelemesi (SRTP) kapalı | SRTP’yi açın; anahtar yöntemi **SDES** olmalı |
| Kayıt `401` / `403` veriyor | Kullanıcı adı veya şifre hatalı | Bilgileri kontrol edin. Arka arkaya hatalı denemeler IP adresinizin güvenlik için geçici olarak engellenmesine yol açabilir |
| OpenAI dışarı arama `outbound_sip_not_enabled` döndürüyor | Özellik OpenAI organizasyonunuzda açık değil | OpenAI hesabınızda dışarı SIP aramasının açılmasını isteyin |

> **Hazır çözüm mü istiyorsunuz?:** Kendi ses ajanınızı geliştirmek yerine KobiKom AI Agent’ı kullanabilirsiniz: asistan santralimizin içinde çalışır, MCP ve API ile CRM’inize bağlanır. Bkz. [DigiAI rehberleri](https://bilgibankasi.kobikom.com.tr/digiai). Bu bağlantının neden TLS ve SRTP gerektirdiğini [blog yazımızda](https://www.kobikom.com.tr/blog/yapay-zeka-sip-trunk-openai-realtime-tls-srtp) anlattık.

Araç: [Destek Talebi Hazırlayıcı](https://bilgibankasi.kobikom.com.tr/araclar/destek-talebi) — Sorununuzu birkaç soruyla tarif edin; ekibimizin ihtiyaç duyduğu bilgilerle hazır bir mesaj oluşturun.

**İlgili KobiKom hizmetleri:** [SIP Trunk ve DID Numara](https://www.kobikom.com.tr/sip-trunk-did-numara), [Çok Kanallı AI Asistan](https://www.kobikom.com.tr/yapay-zeka)

Destek: 0850 888 1 444 · destek@kobikom.com.tr