Create an OpenAI Realtime Voice Agent

Giriş

3CX’te Çağrı Komut Dosyası Oluşturun

Nasıl Çalışır

Komut Dosyasını Test Edin

Sorun Giderme

Ayrıca Bakınız

Giriş

openaivoiceagent.cs örneği, gelen bir 3CX çağrısını OpenAI Realtime’a bağlar. Temsilci, arayanları karşılayabilir, genel sorulara yanıt verebilir, izin verilen rehber nesnelerini kullanabilir, çağrıları yönlendirebilir, sesli posta veya sohbet seçeneği sunabilir ve yapılandırılmışsa, arayanla ilgili yararlı bilgileri kaydedebilir.

Bu komut dosyası, güvenli bir AI tarafından çağrılabilir işlevin nasıl kaydedileceğini gösteren, devre dışı bırakılmış bir get_department_hours özel aracı içerir.

Bu komut dosyası için 3CX AI Edition lisansı, PBX Update 10 sürümü ve bir Gemini API hesabı gereklidir.

3CX’te Komut Dosyası Oluşturun

• 3CX Yönetici Konsolu’na giriş yapın.
• Entegrasyonlar > Çağrı Komut Dosyaları’na gidin.
• +Mağazadan Ekle‘yi seçin

• openaivoiceagent.cs’yi seçin.

• Boşluk olmadan küçük harflerle bir isim girin, örneğin openaireception.
• Komut dosyasının nasıl çalışacağını seçin ve gerekli DID’yi, trunk rotasını ya da dahili hedefi seçin.
• Komut dosyasının ait olduğu bölümü seçin.
• Kod düzenleyiciyi açmak için seçimi onaylayın.

Open ve Komut Dosyasını Yapılandırın

Aşağıdaki korunan parametreleri PBX’e ekleyin:

• OPENAI_API_KEY - OpenAI projenizin API anahtarı.
• OPENAI_REALTIME_MODEL - OpenAI Realtime modeli.

Komut dosyasında ApiKeyOverride ve ModelOverride alanlarını boş bırakın. Bu değerler boş olduğunda, komut dosyası API anahtarını ve modeli PBX parametrelerinden otomatik olarak okur.

Özellikle komut dosyası paylaşılacak, dışa aktarılacak veya yayınlanacaksa, Gemini API anahtarını komut dosyasına doğrudan girmeyin. ApiKeyOverride veya ModelOverride alanlarında yapılandırılan bir değer, ilgili PBX parametresine göre önceliklidir.

Ardından, openaivoiceagent komut dosyasının üst kısmındaki şu müşteri ayarlarını gözden geçirin:

AddAll( ), ilk testler için kullanışlıdır ancak normalde üretim ortamına geçmeden önce devre dışı bırakılmalıdır. AllowAllVisibilityForTesting değerini false olarak ayarlayın, ardından temsilcinin ihtiyaç duyduğu numaraları, bölümleri ve rolleri yapılandırın.

Örnek özel aracı etkinleştirmek için, aracın statik yanıtını inceleyin ve şu satırın yorum işaretini kaldırın:

RegisterExampleCustomTool();



Örneği, gerçek müşteri bilgileri için kullanmadan önce güvenilir bir veri kaynağıyla değiştirin.

Derlemek için “Kaydet” seçeneğini seçin. Üretim trafiğini yönlendirmeden önce, komut dosyası çıktısında derlemenin başarılı olduğu bildirildiğini doğrulayın.

Nasıl Çalışır

• Gelen bir çağrı, komut dosyası yönlendirme noktasına ulaşır.
• Komut dosyası, Gemini’nin 3CX dizininde izin verilen görünürlüğünü sıfırlar ve yeniden oluşturur.
• 3CX, medya kanalını hazırlar.
• Komut dosyası bir OpenAI Realtime ses oturumu başlatır.
• Temsilci, yalnızca 3CX’in yerleşik işlevlerini ve açıkça kaydedilmiş özel araçları kullanır.
• Başarılı bir aktarımda, arayan kişi seçilen 3CX hedefine yönlendirilir.
• Medya kurulumu veya sağlayıcı oturumu başarısız olursa, komut dosyası yapılandırılmış yedek seçeneği dener ve yönlendirme de başarısız olursa HATA uyarısını çalar.

Komut Dosyasını Test Edin

• Atanan DID’yi arayın ve karşılama mesajıyla seçilen sesi onaylayın.
• İsim ve numarayla izin verilen bir dahiliyi arayın.
• Gizlenen dahililerin aranamadığını ya da seçilemediği onaylayın.
• Belirsiz bir dizin eşleşmesini test edin.
• Aktarım, ulaşılamayan kullanıcı sesli mesajı ve sohbet mesajı davranışlarını test edin.
• Test ortamında geçersiz bir sağlayıcı anahtarı kullanın ve yedek yönlendirmeyi doğrulayın.
• Konuşmayı doğal bir şekilde sonlandırın ve oturum temizliğini onaylayın.

Sorun Giderme

• Sağlayıcı oturumu başarısız oldu: OPENAI_API_KEY değerini, desteklenen gerçek zamanlı modeli, ağ erişimini, lisans durumunu ve hedef PBX sürümünü kontrol edin.
• Temsilci bir kullanıcı bulamıyor: AllowAllVisibilityForTesting, VisibleNumbers, VisibleDepartments ve VisibleRoles ayarlarını kontrol edin.
• Yanlış nesneler görünür durumda: Üretim görünürlük listesini eklemeden önce Clear() işlevini çağırın ve AddAll() işlevini kullanmaktan kaçının.
• Yedekleme çalışmıyor: Hedefin mevcut olduğunu ve atanan departmandan erişilebilir olduğunu doğrulayın.
• Hata uyarısı duyulmuyor: Etkin uyarı setinde ERROR'un mevcut olduğunu doğrulayın.

Ayrıca Bakınız

• Arama İşleme Komut Dosyası Oluşturun
• PIN için Örnek Arama İşleme Komut Dosyası
• 3CX Yönetim Kılavuzu

Son Güncelleme

Bu kılavuz en son 31 Temmuz 2026’da güncellendi.

https://www.3cx.com/docs/open-ai-voice-agent/