Create a Grok xAI 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ş

grokvoiceagent.cs örneği, gelen bir 3CX çağrısını bir xAI Grok gerçek zamanlı ses oturumuna bağlar. Temsilci, arayanlara cevap verebilir, onaylanmış şirket rehberinde arama yapabilir, çağrıları aktarabilir, sesli mesaj veya sohbet seçeneği sunabilir ve yapılandırıldığı takdirde arayanla ilgili 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

• grokvoiceagent.cs.’yi seçin.

• Boşluk olmadan küçük harflerle bir isim girin, örneğin grokreception.
• Komut dosyasının nasıl çalışacağını seçin ve gerekli DID’yi, trunk rotasını ya da dahili hedefi seçin.
• Sorumlu bölümü seçin.
• Kod düzenleyiciye devam edin.

xAI ve Komut Dosyasını

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

• GROK_API_KEY - xAI hesabınızın API anahtarı.
• GROK_REALTIME_MODEL - Grok Realtime ses 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, komut dosyasının üst kısmında yer alan şu müşteri ayarlarını gözden geçirin:

Üretim ortamına geçmeden önce AllowAllVisibilityForTesting ayarını false olarak belirleyin ve uygulanabilir en küçük görünürlük listesini yapılandırın.

İsteğe bağlı araç örneğini etkinleştirmek için, ilgili işleyiciyi inceleyin ve şu satırın yorum işaretini kaldırın:

RegisterExampleCustomTool();



“Kaydet” seçeneğini seçin ve Komut Dosyası çıktısında derlemenin başarıyla tamamlandığını doğrulayın.

Nasıl Çalışır

• Arayan kişi komut dosyasına ulaşır.
• Komut dosyası, kısıtlı dizin görünürlük listesi oluşturur.
• 3CX, medya kanalını hazırlar ve Grok gerçek zamanlı ses oturumunu başlatır.
• Temsilci, arayan kişiyle görüşür ve onaylanmış 3CX işlevlerini çalıştırır.
• Aktarmalar, konuşma sırasında verilen sözler yerine araçlar aracılığıyla gerçekleştirilir.
• Sağlayıcı veya medya arızası durumunda, arayan kişi yapılandırılmış yedek çözüme yönlendirilir.

Komut Dosyasını Test Edin

• Seçilen Grok sesini ve çok dilli davranışını doğrulayın.
• İzin verilen ve gizli dahilileri arayın.
• Arayanın onayının ardından temsilcinin aktarım işlemini gerçekleştirdiğini doğrulayın.
• Kullanıcı ulaşılamadığında sesli mesaj ve sohbeti test edin.
• Veda edin ve oturumun normal şekilde kapandığını doğrulayın.
• Sağlayıcı arızası ve yedekleme davranışını test edin.

Sorun Giderme

• Oturum hemen başarısız oluyor: GROK_API_KEY’i, desteklenen modeli, lisansı, PBX sürümünü ve dış hat sağlayıcısıyla bağlantıyı kontrol edin.
• Aktarım duyuruluyor ancak gerçekleştirilmiyor: Özel talimatların hâlâ bağlantı aracını gerektirip gerektirmediğini ve üzerine yazılmadığını doğrulayın.
• Dizin araması çok fazla sonuç veriyor: AddAll() işlevini devre dışı bırakın ve görünürlüğü kısıtlayın.
• Yedekleme başarısız oluyor: Hedef ve bölüm izinlerini kontrol edin.
• Komut istemi eksik: Etkin komut istemi kümesinde ERROR'un mevcut olup olmadığını kontrol edin.

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üncellenmiştir.

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