Hizmet rehberleri menüsü
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ı.
İçindekiler
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).
- 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.
- 1Müşteriniz
0850 XXX XX XX’i arar - 2Çağrı proje adresinize iletilir: TLS + SRTP
- 3
realtime.call.incomingweb kancası - 4
acceptile çağrı kabul edilir - 5Ajanla görüşme; ses şifreli akar
- Telefon araması
- Sistemler arası istek / yanıt
- Görüşme (numaralar gizli)
- 1Arayan → KobiKom: Müşteriniz
0850 XXX XX XX’i arar - 2KobiKom → OpenAI Realtime: Çağrı proje adresinize iletilir: TLS + SRTP
- 3OpenAI Realtime → Sunucunuz:
realtime.call.incomingweb kancası - 4Sunucunuz → OpenAI Realtime:
acceptile çağrı kabul edilir - 5Arayan → 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?
- 1Siz · OpenAI
OpenAI projesi ve web kancası
Proje kimliğinizi alır, gelen çağrılar için web kancası tanımlarsınız.
- 2KobiKom ekibi
Numara, TLS hesabı ve yönlendirme
Numaranızı AI Entegrasyonu SIP Trunk’a bağlar, SIP hesabınızı açar, gelen çağrıları proje adresinize yönlendiririz.
- 3Siz · sunucunuz
Çağrıyı karşılayan kod
Web kancasında çağrıyı kabul eder, ajanı WebSocket ile bağlarsınız.
- 4Siz · DigitalOffix
Test
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.
- 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 Hereile 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 · OpenAIplatform.openai.com adresinde Settings → Project → General ekranını açın. Proje kimliği
proj_ile başlar.- Project ID
- proj_XXXXXXXX
- 2
Gelen çağrı web kancasını tanımlayın
Siz · OpenAISettings → Project → Webhooks ekranında yeni bir web kancası oluşturun. Olay türü olarak
realtime.call.incomingseçin; adres alanına çağrıyı karşılayacak sunucunuzun adresini yazın.
2. KobiKom tarafında yönlendirme
- 1
Talebinizi iletin
SizFirma adınızı, numaranızı ve OpenAI proje kimliğinizi destek ekibimize iletin. Verinin Avrupa’da işlenmesini istiyorsanız bunu da belirtin.
- 2
Yönlendirmeyi kurarız
KobiKom ekibiEkibimiz numaranıza gelen çağrıları
sips:proj_XXXXXXXX@sip.api.openai.comadresine (Avrupa içinsip-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.
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_enabledhatasıyla döner.
OpenAI dışarı arama hattı (Live API) değerleri
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 · telefonBaşka bir telefondan numaranızı arayın. Web kancanıza
realtime.call.incomingolayı gelmeli; kabul ettiğinizde ajan konuşmaya başlamalı. - 2
Giden aramayı deneyin
Siz · uygulamaUygulamanı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 · DigitalOffixSes 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 |
Bu rehber işinize yaradı mı?