Bir VoIP sağlayıcısına bağlanın

Halihazırda kullandığınız bir sağlayıcıyı bağlayın (API anahtarıyla Twilio veya Telnyx; SIP üzerinden SignalWire, Vonage, Plivo ya da herhangi bir SIP trunk) veya rehberli kurulumla yeni bir Telnyx hesabı açın.

Üretim trafiği, kendi VoIP sağlayıcınız üzerinden sahip olduğunuz numaralarda çalışmalıdır. Kontrol panelindeki Connections → VoIP sayfası (/dashboard/voip-connections) sağlayıcı hesabınızı bağlar; bağlandıktan sonra gelen ve giden aramaları destekleyen numaraları içe aktarırsınız.

Yeni bağlantı seçeneğine tıklayın ve iki yoldan birini belirleyin: Halihazırda kullandığınız bir sağlayıcıyı bağlayın veya Yeni bir Telnyx hesabı oluşturun.

Halihazırda kullandığınız bir sağlayıcıyı bağlayın#

Numaralarınızın bulunduğu sağlayıcıyı seçin:

Twilio ve Telnyx için kimlik bilgilerini yapıştırın ve Bağlan ve Test Et seçeneğine tıklayın. ThunderPhone bunları doğrular ve sağlayıcı tarafını sizin için yapılandırır. Telnyx için ThunderPhone, Telnyx hesabınıza kendine ait bir SIP bağlantısı (thunderphone-production-<org>-outbound-<id> adlı) ekler ve giden aramaları bu bağlantı üzerinden yapar; böylece Telnyx bu aramaları size faturalandırır. Numaralarınızın bulunduğu Telnyx bağlantısının giden ses profilini kullanır; dolayısıyla bu profilin izin verilen ülkeleri ve harcama limitleri uygulanır. Bu bağlantının giden ses profili yoksa ve hesabınızda tam olarak bir etkin profil varsa ThunderPhone onu kullanır. Farklı bir profil kullanmak için Telnyx portalında bu profili bağlantıya atayın ve ThunderPhone bağlantısını yeniden kaydedin. Hesapta etkin profil yoksa veya birden fazla etkin profil varsa Telnyx portalında bağlantıya bir profil atayın ve ThunderPhone bağlantısını yeniden kaydedin. O zamana kadar giden aramalar outbound_trunk_unavailable hatasıyla başarısız olur; gelen aramalar çalışmaya devam eder.

Telnyx bir giden aramayı reddettiğinde (örneğin SIP 403 Forbidden), ret işlemi kendi Telnyx hesabınızdan kaynaklanır. Yaygın nedenler kullanılabilir kredi olmaması, arayan numaranın bu Telnyx hesabında bulunmaması veya hedef ülkeye izin vermeyen bir giden ses profilidir.

SignalWire, Vonage ve Plivo için SIP kurulumu#

Bu üçü, üst bölümünde ilgili sağlayıcıya yönelik adımların, sağlayıcının kendi kurulum kılavuzuna bir bağlantının ve örnek bir SIP alan adının bulunduğu manuel SIP formunu açar:

• SignalWire: giden aramalar için SIP kimlik bilgileri oluşturun, SIP alan adını, kullanıcı adını ve parolayı girin ve her numaraya gelen aramaları ThunderPhone SIP uç noktasına bağlayan bir SWML betiği atayın.
• Vonage: SIP Trunking panosunda giden kimlik bilgileri olan bir trunk oluşturun, alan adını (örneğin your-trunk.sip-us.vonage.com) ve kimlik bilgilerini girin, ThunderPhone SIP uç noktasını trunk'ın gelen SIP URI'si olarak ekleyin ve numaralarınızı trunk'a bağlayın.
• Plivo: bir kimlik bilgisiyle giden trunk oluşturun ve Termination SIP Domain (<trunk-id>.zt.plivo.com), kullanıcı adı ve parolayı girin; Primary URI değeri ;transport=tcp ile devam eden ThunderPhone SIP uç noktası olan bir gelen trunk oluşturun; ardından her numaranın Application Type değerini bu trunk olarak ayarlayın.

Sonuç, elle girilen bir bağlantıyla tamamen aynı şekilde test edilen ve doğrulanan manuel bir SIP bağlantısıdır (API'de provider: "manual"). Bağlantı kartı sağlayıcının adını gösterir; örneğin SignalWire · SIP.

Yeni bir Telnyx hesabı oluşturun#

Henüz bir sağlayıcınız yok mu? Rehberli akış, bir Telnyx hesabı açmanız ve bağlamanız için size yol gösterir:

1. Hesabı oluşturun

   Open Telnyx Signup seçeneğine tıklayın, hesabınızı oluşturun ve "I've created my account." seçeneğini işaretleyin.

2. API anahtarı alın

   Open API Keys Page seçeneğine tıklayın, bir anahtar oluşturun ve bunu API Key (v2) alanına yapıştırın. İsteğe bağlı olarak bağlantıyı adlandırın.

3. Bağlan ve Test Et

   Connect & Test seçeneğine tıklayın — ThunderPhone kimlik bilgilerini doğrular ve kaydetmeden önce Telnyx tarafında ihtiyaç duyduğu kaynakları sağlar.

ThunderPhone'un Telnyx'te ayarladıkları#

Kendi Bağlantı Kimliğinizi girmediğiniz sürece, her iki Telnyx yolu da (yönlendirmeli kurulum ve API anahtarı yapıştırma) Telnyx hesabınızda aynı öğeyi bırakır: thunderphone-<your organization id> adlı tek bir SIP bağlantısı. Bu, FQDN kaydı ThunderPhone'un SIP uç noktasını gösteren bir FQDN bağlantısıdır ve içe aktardığınız her numara buna atanır. Telnyx, bu numaralara gelen çağrıları SIP üzerinden doğrudan ThunderPhone'a gönderir.

• Webhook alanları bilerek boştur. Herhangi bir webhook, Call Control uygulaması, TeXML uygulaması veya kayıtlı SIP telefonu kullanılmaz.
• İçe aktarılan numaraları başka bir bağlantıya ya da uygulamaya taşımayın ve buna karşı bir cihaz kaydetmeyin.
• Bağlanırken kendi Bağlantı Kimliğinizi girdiyseniz ThunderPhone bunun yerine o bağlantıyı kullanır ve asla değiştirmez; bağlantının, ThunderPhone SIP uç noktasını gösteren bir FQDN bağlantısı olması gerekir.

30 Ağustos 2026'dan önce ThunderPhone'un oluşturduğu thunderphone-… bağlantısı, çağrı alamayan bir Kimlik bilgileri bağlantısıydı. Sizinkinde hâlâ Kimlik bilgileri bağlantısı görünüyorsa destek ekibiyle iletişime geçin; onu dönüştürelim.

Manuel SIP yapılandırması#

SignalWire, Vonage ve Plivo kartları bu formu açar; Diğer sağlayıcı altındaki Her ayarı kendim gireceğim seçeneği de aynı formu açar. DIDWW veya kendi işlettiğiniz bir PBX dahil olmak üzere tüm SIP trunk'ları çalışır. Bağlantı adını, SIP alan adı / URI bilgisini, isteğe bağlı kullanıcı adı ve parolayı, bağlantı noktasını ve taşıma protokolünü girin; Gelişmiş Ayarlar medya şifrelemesini (SRTP) ekler. Form ayrıca trunk'ınızın gelen aramaları göndermesi gereken SIP adresini de gösterir: sip.thunderphone.com; UDP veya TCP için 5060, TLS için ise 5061 numaralı bağlantı noktasını kullanın. TLS üzerinden SIP sinyalleşmesi, ThunderPhone'un aramayı yönettiği LiveKit Cloud'a kadar şifreli kalır; ses hiçbir zaman sip.thunderphone.com üzerinden geçmez, bu nedenle SRTP eskisi gibi çalışır. Her aramayı, istek satırında ve To başlığında + dahil aynı numarayı kullanarak E.164 biçimindeki aranan numaraya yönlendirin: örneğin sip:+14155550142@sip.thunderphone.com. + işareti, ThunderPhone'un aramayı doğru bölgede işlemesini sağlar (IP izin listesi altındaki nota bakın). Daha önce <your-project>.sip.livekit.cloud adresiyle ayarlanmış trunk'lar, İzin Verilen Kaynak IP'ler boş olduğu sürece çalışmaya devam eder; bunları değiştirmeniz gerekmez. ThunderPhone bu ayarları LiveKit Cloud üzerinde özel bir SIP trunk çiftine dönüştürür: bağlantı numaralarından yapılan giden aramalar, kimlik bilgileriniz kullanılarak SIP alan adınıza yönlendirilir ve bu numaralara gelen aramalar, isteğe bağlı İzin Verilen Kaynak IP'ler alanını doldurmadığınız sürece herhangi bir adresten kabul edilir. Bu alanı yalnızca operatörünüz sabit sinyalleşme IP'leri yayımlıyorsa doldurun: yanlış veya eksik bir liste, ThunderPhone'un operatörünüzden gelen aramaları reddetmesine neden olur. İki düğme temel işlemleri gerçekleştirir:

• Yapay Zeka Kurulum Kılavuzu Oluştur — ihtiyacınız olan trunk tarafı yapılandırması için sağlayıcıya özel talimatlar oluşturur.
• Bağlantıyı Test Et ve Kaydet — SIP uç noktasının genel bir adrese çözümlendiğini ve TCP/TLS için seçilen bağlantı noktasında bağlantı kabul ettiğini kontrol eder (UDP ana bilgisayarları yalnızca DNS kontrolünden geçer), ardından kaydeder. Bağlantıda henüz numara olmadığı için henüz arama yapamaz; asıl doğrulama içe aktarma sırasında gerçekleşir (aşağıda).

Bir bağlantıyı daha sonra düzenlemek, herhangi bir şey kaydedilmeden önce değişen ayarlarınızla aynı denetimi yeniden çalıştırır, ardından trunk'ı yeniden oluşturur ve arka planda kısa bir test aramasıyla bağlantıdaki her numarayı yeniden doğrular — numaralar, test aramaları başarılı olana kadar Sağlanıyor olarak görünür. Bağlı bir bağlantıda yalnızca İzin Verilen Kaynak IP'ler alanını değiştirmek farklıdır: bu değişiklik giden aramaları hiçbir zaman etkilemez; bu nedenle ThunderPhone listeyi gelen trunk üzerinde hemen günceller ve numaralar Etkin durumda kalır. Gelen arama testleri test edilmedi durumuna sıfırlanır; yeni listenin aramalara izin verdiğini doğrulamak için testi yeniden çalıştırın veya operatörünüz üzerinden gerçek bir arama yapın. Test araması liste kapsamında reddedilecekse test başarısız olur. Kaydedilmiş parolalar hiçbir zaman yeniden gösterilmez; parolayı korumak için alanı boş bırakın veya IP kimlik doğrulamalı bir trunk için "Kaydedilen parolayı kaldır" seçeneğini işaretleyin.

IP izin listesi ve trunk kimlik doğrulaması#

Bazı operatörler (DIDWW, Telnyx IP kimlik doğrulamalı bağlantıları, bir güvenlik duvarının arkasındaki çoğu PBX) yalnızca izin listesine eklediğiniz adreslerden gelen SIP trafiğini kabul eder veya giden aramaları kaynak IP'ye göre kimlik doğrular. ThunderPhone iki adres grubu kullanır.

SIP uç noktası. sip.thunderphone.com adresine gönderdiğiniz gelen aramalar, yalnızca SIP sinyalleşmesini taşıyan ThunderPhone SIP uç noktasından geçer. İlk INVITE sip.thunderphone.com adresine gider; aramanın sinyalleşmesinin geri kalanı (ACK, kapatma, aktarımlar), operatörünüz ile aramayı alan uç sunucu (sip-1 veya sip-2) arasında gerçekleşir. Güvenlik duvarınız SIP sinyalleşmesini filtreliyorsa UDP ve TCP 5060 bağlantı noktası ile TLS 5061 bağlantı noktasında üçünün de geçmesine izin verin:

LiveKit Cloud. Her aramanın sesi (RTP) ve giden aramaların SIP sinyalleşmesi, SIP uç noktası üzerinden değil, operatörünüz ile LiveKit Cloud arasında gerçekleşir. Hem SIP sinyalleşmesi hem de medya için aşağıdaki tüm aralıklara izin verin:

LiveKit bu aralıkları Realtime, SIP sinyalleşmesi ve medya ile Webhook'lara uygular; bunlar Kanada, AB, Hindistan, Japonya ve ABD bölgelerinde işlenen aramaları kapsar. Sabitlenmiş bir uç nokta için bölge adları: canada, eu, india, japan, us.

Trunk için birkaç temel kural:

• ThunderPhone kaydolmaz. Operatörünüze hiçbir zaman SIP REGISTER göndermez; bu nedenle trunk yapılandırmasını kayıt yerine IP tabanlı ve/veya kimlik bilgilerine dayalı (kullanıcı adı + parola) kimlik doğrulama için ayarlayın.
• Giden aramalarda kimlik bilgileri kullanılmalıdır. Operatör tarafında kullanıcı adı/parola kimlik doğrulamasını etkinleştirin ve manuel SIP formuna aynı değerleri girin. IP izin listesini tek koruma katmanı olarak değil, ikinci bir katman olarak kullanın — kapsanan bölgelerin dışındaki hedeflere yapılan giden aramalar başka adreslerden kaynaklanabilir.
• Gelen aramalar ters yöndedir. Formdaki isteğe bağlı İzin Verilen Kaynak IP'ler alanı, ThunderPhone'un yalnızca bu adreslerden gelen aramaları kabul etmesi için operatörünüzün sinyalleşme adreslerini girdiğiniz yerdir. IP adresleri veya CIDR aralıkları girin; ana makine adları hiçbir zaman eşleşmez. Operatörünüz sabit bir liste yayımlamıyorsa bu alanı boş bırakın. ThunderPhone, her gelen aramada listeyi SIP uç noktasının gördüğü adrese göre denetler; bu nedenle liste ayarlandıktan sonra aramalarınızı sip.thunderphone.com adresine gönderin. Listede olmayan bir adresten gelen veya doğrudan <your-project>.sip.livekit.cloud adresine gönderilen bir arama reddedilir: başarısız olur ya da bağlanır ve hemen sona erer.

Aralıklar LiveKit tarafından Regions, regional endpoints, and static IPs sayfasında yayımlanır; ThunderPhone bu sayfayı haftalık olarak kontrol eder ve değiştiğinde bu kılavuzu günceller.

Bağlantıdan sonra#

Numaraları Telefon Numaraları → Numara ekle → VoIP sağlayıcısı bağla bölümünden (veya doğrudan bağlantıdan) içe aktarın. İçe aktarılan her numara etkinleşmeden önce doğrulanır. Manuel bir SIP bağlantısında bu doğrulama, numaranızdan SIP trunk'ınız üzerinden bir ThunderPhone numarasına kısa (birkaç saniyelik) bir test araması yapar; böylece kullanıcı adı, parola, aktarım ve operatörünüzün giden yönlendirmesi gerçek koşullarda sınanır. Operatörünüz bu aramayı diğer tüm aramalar gibi ücretlendirir. Operatör reddederse numara Sağlanıyor durumunda kalır ve telefon numaraları sayfası operatörün yanıtını gösterir (örneğin "ThunderPhone kimlik bilgileri reddedildi (SIP 401)"); bağlantıyı düzeltin ve yeniden doğrulayın. Operatörünüz trunk'ı kabul eder ancak yönlendirme planı ThunderPhone'un test numarasını kapsamazsa (DIDWW "Hedef numara yönlendirme planı tarafından engellendi" yanıtını verir), numara Doğrulandı · operatör kabul etti olarak görünür: kullanılabilir, ancak diğer hedeflere yapılan aramalar test edilmemiştir. Bu arama, trunk'ınızın bu numara olarak arama başlatabildiğini kanıtlar; numaraya sahip olduğunuzu kanıtlamaz ve numaraya gelen aramaları test etmez; aşağıdaki isteğe bağlı gelen arama testi bunu yapar. Doğrulanmış numaralar gelen ve giden aramaları destekler; bu da giden arama kampanyalarını ve programatik giden aramaları mümkün kılar.

Gelen çağrı testi#

Numarayı doğrula, gelen çağrıları da test edebilen bir iletişim kutusu açar. Test, numaranızı arar, çağrının ThunderPhone'a ulaştığını kontrol eder ve ardından yapay zeka ajanınızı başlatmadan çağrıyı kapatır:

• Kendi giden SIP trunk'ı olan numaralar (manuel SIP numaraları ve ThunderPhone Twilio hesabınızda giden çağrıları ayarladıktan sonraki Twilio numaraları) önce kendilerini arar: ThunderPhone, bu trunk üzerinden numarayı numaranın kendisinden arar. İletişim kutusu, çağrıyı yapmadan önce sizi bilgilendirir. Çağrı operatörünüz üzerinden çıkar ve gelen çağrı yönlendirmeniz doğruysa doğrudan ThunderPhone'a geri gelir. Çağrı numaranın kendi arayan kimliğiyle geri geldiğinde, bu tek çağrı hem operatörünüzün numara olarak ThunderPhone'dan gelen çağrıları kabul ettiğini hem de numaraya gelen çağrıların her ülkede ThunderPhone'a ulaştığını kanıtlar. Bazı operatörler bir numaranın kendisini aramasını reddeder veya bağlamaz; bu, yönlendirmeniz hakkında hiçbir şey göstermez. Bu durumda ThunderPhone kendi numaralarından biriyle arar. Numaranız başka bir yere yönlendiriliyorsa o telefon iki kez çalabilir: önce numaranın kendi arayan kimliği, ardından ThunderPhone'un test numarası gösterilir.
• Diğer numaralar (ve yukarıdaki geri dönüş seçeneği), ThunderPhone'un kendi numaralarından biriyle aranır. ThunderPhone şu an bu çağrıları yalnızca ABD ve Kanada numaralarına yapabilir; diğer numaralarda test, kendi kendini arama reddedildiyse operatörünüzün yanıtıyla birlikte çalıştırılamadığını bildirir.

Operatörünüz arayan kimliğini yolda değiştirirse ThunderPhone çağrıyı tanıyamaz; bu nedenle yapay zeka ajanınız çağrıyı kısa süreliğine yanıtlayabilir. Gelen çağrı testi isteğe bağlıdır. Atlarsanız numara yine de çalışır; telefon numaraları sayfasında Gelen arama test edilmedi görünür ve daha sonra Test ile veya numaranın Gelen çağrıları test et menü öğesiyle çalıştırabilirsiniz. İçe aktarmanın hemen ardından telefon numaraları sayfası, yeni numaralardaki gelen çağrıları test etmenizi de ister. İletişim kutusunda onay vermediğiniz sürece hiçbir numara aranmaz.

Sağlayıcınız numarayı başka bir yere gönderiyorsa ThunderPhone çağrıyı kapatmadan önce numaranın yönlendirdiği yer her çağrı için en fazla 8 saniye çalabilir. Önce başka bir şey yanıt verirse (yanıtlayıp sonra yönlendiren bir Twilio uygulaması veya telefon menüsü), test yönlendirilen çağrının ThunderPhone'a ulaşmasını bekler: kendi kendini aramada en fazla 8 saniye ve ThunderPhone numarasından yapılan çağrıda 15 saniye. Sonuç, bağlantıyı değiştirene veya numarayı yeniden içe aktarana kadar numarada (Gelen arama başarılı ya da başarısız) kalır; bu işlem durumu test edilmedi olarak sıfırlar. Bağlantıyı değiştirmek, giden çağrıları arka planda yeniden doğrular ancak siz istemeden numaranızı asla aramaz.

Gelen aramalarda sorun giderme#

Bağlantının Test düğmesi kimlik bilgilerini, doğrulama ise giden aramayı kontrol eder. Gelen aramaları kontrol etmek için yukarıdaki gelen arama testini çalıştırın veya bir telefondan numarayı arayıp aramayı Arama Geçmişi bölümünde bulun. Tarayıcıdaki Konuş testleri ve botlar arası simülasyonlar operatörünüz üzerinden geçmez; bu nedenle gelen aramaların çalışıp çalışmadığını göstermez. Telefon numarasını hedefleyen bir simülasyon (SIP geri döngüsü) numarayı operatörünüz üzerinden arar; dolayısıyla yanıtlanan bir simülasyon, gelen arama yönlendirmesini gerçekten test eder.

• Kendi mobil operatörünüzün mesajını duyarsınız (örneğin "Verizon'a hoş geldiniz" veya "aradığınız numara hizmet dışıdır"): arama ThunderPhone'a ulaşmadan önce başarısız olmuştur. Numaranın sağlayıcı hesabınızda etkin olduğunu ve ThunderPhone bağlantısına veya trunk'ına atandığını kontrol edin.
• Meşgul sinyali duyarsınız veya arama yanıtsız çalar: sağlayıcı aramayı kabul etmiş ancak iletememiştir. Telnyx kullanıyorsanız numaranın Telnyx portalındaki Bağlantı ayarını kontrol edin: bu, yukarıda açıklanan thunderphone-… FQDN bağlantısı veya ThunderPhone SIP uç noktasını işaret eden kendi FQDN bağlantınız olmalıdır. Twilio kullanıyorsanız numara, Voice webhook'una veya TwiML uygulamasına değil ThunderPhone SIP trunk'ına bağlanmış olmalıdır.
• Operatör günlüklerinizde 404 No trunk found görünür (manuel SIP): arama ThunderPhone'a ulaşmıştır ancak hiçbir trunk ile eşleşmemiştir. Numaranın bu bağlantıya içe aktarıldığını ve trunk'ın sip.thunderphone.com adresini işaret ettiğini kontrol edin. Trunk, <your-project>.sip.livekit.cloud adresini işaret ediyorsa İzin Verilen Kaynak IP'ler boş olmalıdır: bir liste ayarlandığında yalnızca sip.thunderphone.com adresine gönderilen aramalar kabul edilir.
• sip.thunderphone.com adresinden 404 Not Found (manuel SIP): arama bir telefon numarasına yönlendirilmemiştir veya istek satırı ile To başlığı farklı numaralar belirtmektedir. Yukarıdaki gibi, aranan numarayı her ikisinde de gönderin.
• sip.thunderphone.com adresinden 403 Forbidden: istek satırı başka bir ana bilgisayar belirtmektedir. Aramayı sip.thunderphone.com adresine yönlendirin; örneğin sip:+14155550142@sip.thunderphone.com.
• Arama ThunderPhone'a ulaşır ancak yanlış yapay zeka ajanı yanıtlar veya hiç kimse yanıtlamaz: numaranın Telefon Numaraları bölümündeki gelen arama yapay zeka ajanını kontrol edin.

Uygulama içi yardımcı pilot sizin için bir numarayı kontrol edebilir: numaraya yapılan aramaların neden başarısız olduğunu sorun. Telnyx bağlantılarında, salt okunur olarak ve kuruluş yöneticileri için, Telnyx'in numarayı hangi bağlantıya atadığını da sorgular.

Sonraki adımlar#