Twilio, uluslararası bir telekomünikasyon sağlayıcısıdır. Botun, Twilio'nun telefon numarası sunduğu 100'den fazla ülkede (Meksika, Brezilya, Türkiye, İspanya, Almanya, Fransa, BAE, Tayland, Malezya ve diğerleri dahil) müşterileri aramasını ve onları çalışanlarınıza bağlamasını sağlar.

Twilio'yu bağladıktan sonra elde edecekleriniz:

  • sohbet kartından tek tıkla müşteriyi arama;
  • otomatik senaryo tabanlı aramalar — bot müşteriyi arar ve bir metin mesajını sesli okur;
  • grup aramaları — bot müşteriyi arar ve onu ilk müsait çalışana bağlar;
  • tüm aramaların kaydı, kayıt bağlantısı sipariş değişkenlerinde saklanır;
  • arama olayları (çalıyor, cevaplandı, tamamlandı) doğrudan sohbette — bunları senaryolar oluşturmak için kullanabilirsiniz.

Adım 1. Hesap Oluşturun ve Numara Satın Alın

  1. twilio.com adresine kaydolun ve doğrulama sürecini tamamlayın.
  2. Twilio Console'da Phone Numbers → Buy a number bölümünü açın ve ihtiyacınız olan ülkede bir numara seçin. Voice özelliğinin etkin olduğundan emin olun — bazı numaralar yalnızca SMS destekler ve aramalar için kullanılamaz.

Adım 2. Erişim Kimlik Bilgilerinizi Kopyalayın

Twilio Console'un ana sayfasında, Account Info altında iki değer bulacaksınız:

Öğe Görünümü
Account SID ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auth Token gizli; görüntülemek için Show düğmesine tıklayın

⚠️ Auth Token'ı tam olarak göründüğü gibi, önünde veya arkasında fazladan boşluk olmadan kopyalayın. Twilio'dan gelen her isteğin gerçekliğini doğrulamak için kullanırız. Görünmeyen tek bir fazladan karakter, aramaların çalışmasına ancak arama olaylarının sohbette görünmemesine neden olabilir.

Auth Token, Twilio hesabınıza ve içindeki fonlara tam erişim sağlar. Bunu mesajlaşma uygulamaları üzerinden göndermeyin veya herhangi bir yerde yayınlamayın.


Adım 3. Twilio'yu Hesabınıza Bağlayın

Proje → Entegrasyonlar → Telefon Hizmeti → Twilio bölümünü açın ve üç alanı doldurun:

Alan Ne girilecek
Account SID Adım 2'den
Auth Token Adım 2'den
Twilio Numarası satın aldığınız numara, uluslararası formatta: +14155550100

Numara E.164 formatında girilmelidir: +, ülke kodu ve telefon numarası, boşluk, parantez veya tire olmadan.

Kaydettikten sonra sayfada bir geri arama URL'si görünecektir. Bunu kopyalayın. Ardından Twilio Console'da satın aldığınız numaranın ayarlarını açın ve Voice & Fax altında şunları yapılandırın:

  • A call comes in → Webhook → kopyalanan URL'yi yapıştırın ve HTTP POST seçin.

Bu yapılandırma olmadan, giden aramalar çalışır, ancak gelen aramalar ve sohbetteki arama olayları çalışmaz.

Entegrasyonu kaldırmak için Account SID alanını temizleyin ve ayarları kaydedin.


Adım 4. Çalışan Telefon Numaralarını Ekleyin

Twilio çalışanları normal telefon numaralarından arar — burada dahili hat yoktur.

Ekip sekmesini açın, bir çalışan seçin ve Twilio Telefon Numarası alanına tam telefon numarasını aynı formatta doldurun:

+905551112233

Bu numara olmadan, müşteri kartındaki arama düğmesi o çalışan için çalışmaz.


Müşteri Kartından Arama

Sohbet kartında müşterinin telefon numarasının yanında bir arama düğmesi görünecektir. Tıklamak aşağıdaki sırayı başlatır:

  1. Twilio çalışanı arar — çalışan, arayan kimliği olarak Twilio numaranızı görür.
  2. Çalışan aramayı cevaplar.
  3. Ancak o zaman Twilio müşteriyi arar ve iki tarafı birbirine bağlar.

Sıra bilinçlidir: müşteri, çalışan telefonuna ulaşana kadar çalma sesini dinlemek zorunda kalmaz. Çalışan cevap vermezse, müşteri hiç aranmaz.


Bot Senaryolarından Aramalar

Hesaplayıcıda dört yöntem mevcuttur.

twilio_employee_call(client_phone, employee_phone, caller_id)

Bir çalışanı bir müşteriyle bağlar. Müşteri kartındaki arama düğmesiyle aynı şekilde çalışır: önce çalışan aranır, sonra müşteri.

twilio_employee_call(client_phone, "+905551112233")

Üçüncü argüman isteğe bağlıdır. Müşterinin arayan kimliği olarak göreceği telefon numarasını belirtir. Varsayılan olarak Twilio numaranız kullanılır.

twilio_group_call(client_phone, employee_phones, caller_id)

Müşteriyi arar ve müşteri cevap verdiğinde, belirtilen listedeki tüm çalışanları aynı anda arar. Arama, ilk cevap veren çalışana bağlanır.

twilio_group_call(client.phone, "+905551112233,+905554445566,+905557778899")

⚠️ Burada sıra tersine çevrilmiştir. Önceki yöntemin aksine, müşteri önce cevap verir ve Twilio çalışanları ararken birkaç saniye sessizlik duyabilir. Bu bir Twilio sınırlamasıdır: bir grubu aynı anda aramak ve ilk cevap vereni bağlamak yalnızca bu şekilde çalışır. Müşterinin beklemek zorunda kalmaması önemliyse, twilio_employee_call kullanın.

twilio_play_message(client_phone, text, voice, language)

Müşteriyi arar ve belirtilen metni sentezlenmiş konuşma kullanarak okur. Bu, randevu hatırlatmaları, sipariş onayları ve teslimat bildirimleri için kullanışlıdır.

twilio_play_message(client.phone, "Merhaba! Bu, yarın saat 15:00'teki randevunuzla ilgili bir hatırlatmadır.", "alice", "tr-TR")

alice sesi evrenseldir ve tr-TR, es-ES, es-MX, pt-BR, de-DE, fr-FR, en-US, ru-RU ve ar-XA dahil olmak üzere büyük dilleri destekler.

Dili her zaman açıkça belirtin — aksi takdirde Twilio metni İngilizce telaffuzla okuyabilir.

Mesaja şifreler, doğrulama kodları veya diğer hassas bilgileri eklemeyin: arama sesli mesaja düşebilir.

Arama kaydına bir bağlantı döndürür. Bu nadiren gereklidir çünkü bağlantı normalde otomatik olarak görünür (sonraki bölüme bakın). Kayıt bağlantısı alınmadıysa ve tekrar istenmesi gerekiyorsa yararlı olabilir.

twilio_get_record_link()

Argüman sağlanmazsa, müşterinin en son araması kullanılır.


Değişkenler ve Olaylar

Her aramadan sonra bot, müşterinin siparişinde aşağıdaki değişkenleri saklar:

Değişken İçeriği
twilio_call_id Twilio arama tanımlayıcısı
twilio_call_disposition arama sonucu: completed, busy, no-answer, failed, canceled
twilio_call_duration saniye cinsinden arama süresi
twilio_record_link kayda bağlantı
twilio_record_id Twilio kayıt tanımlayıcısı

twilio_call_event <status> biçimindeki olaylar sohbete gönderilir. Bunları senaryolarınızda koşul olarak kullanabilirsiniz:

Olay Ne zaman gönderilir
twilio_call_event initiated arama oluşturuldu
twilio_call_event ringing telefon çalıyor
twilio_call_event answered arama cevaplandı
twilio_call_event completed arama sona erdi
twilio_call_event busy / no-answer / failed / canceled arama tamamlanamadı
twilio_call_event recording arama kaydı hazır

⚠️ Kayıt bağlantısını kullanmadan önce recording olayını bekleyin, completed olayını değil. Twilio, kayıt dosyasını arama sona erdikten sonra işler. completed olayı alındığında, twilio_record_link değişkeni hâlâ boştur. Bu nedenle, kaydı bir yöneticiye veya CRM'e gönderen bir senaryo recording olayı tarafından tetiklenmelidir.

Tipik bir "müşteriye ulaşılamadı — ona mesaj gönder" senaryosu şu şekilde çalışır: twilio_call_event no-answer veya busy koşulu → müşteriye mesaj gönder.


Arama Kayıtları

Kayıt, bir çalışanı içeren tüm aramalar için varsayılan olarak etkindir. Konuşmanın her iki tarafı da arama cevaplandığı andan itibaren kaydedilir. Dosyalar Twilio hesabınızda saklanır ve Twilio tarafından faturalandırılır.

⚠️ twilio_record_link URL'si doğrudan Twilio'ya işaret eder ve hesap kimlik bilgilerinizle korunur. Bir tarayıcıda açamaz veya bir müşteriye gönderemezsiniz — bir erişim hatası görüntülenir. Kaydı indirmek için Twilio Console'u açın ve Monitor → Logs → Calls bölümüne gidin, ardından twilio_call_id kullanarak aramayı bulun.

⚖️ Arama kaydı yasalarla düzenlenir. Almanya, Fransa, İspanya ve birçok ABD eyaleti dahil olmak üzere birçok ülkede her iki tarafın da onayı gerekebilir ve bazı durumlarda aramanın başında sözlü bir bildirim çalınmalıdır. Twilio hesabının sahibi olarak geçerli gereksinimlere uymak sizin sorumluluğunuzdadır. Bu kurallar sizin için geçerliyse, aramaya bir kayıt bildirimiyle başlayın veya Twilio numara ayarlarınızda kaydı devre dışı bırakın.


Sorun Giderme

Arama Oluşturulmuyor ve Kimlik Doğrulama Hatası Döndürülüyor

Account SID veya Auth Token hatalı. Bunları Twilio Console'dan tekrar kopyalayın. En yaygın nedenler fazladan bir boşluk veya ana Auth Token yerine yanlışlıkla Test Token'ın kopyalanmasıdır.

Aramalar Çalışıyor, ancak Sohbette Olay veya Kayıt Yok

Geri arama URL'si Twilio numara ayarlarında yapılandırılmamış (bkz. Adım 3) veya yanlış HTTP yöntemiyle yapılandırılmış. Yöntem HTTP POST olmalıdır.

Diğer bir yaygın neden, Twilio'da Auth Token'ın değiştirilmesi ancak hesabınızda hâlâ eski token'ın yapılandırılmış olmasıdır. Bu durumda, istek imzaları artık eşleşmez, bu nedenle tüm geri aramalar reddedilir.

Hata 21606 veya "From number not valid"

Twilio Numarası alanına girilen numara ya Twilio hesabınız altında satın alınmamıştır ya da sesli aramaları desteklemiyor.

Phone Numbers → Manage → Active numbers bölümünü açın ve numaranın listelendiğinden ve Voice özelliğine sahip olduğundan emin olun.

Hata 21215 — Geo Permissions

Varsayılan olarak Twilio, dolandırıcılık önleme önlemi olarak birçok ülkeye aramaları engeller.

Voice → Settings → Geo Permissions bölümünü açın ve ihtiyacınız olan hedefleri etkinleştirin.

Bir Müşteri Arıyor, ancak Çalışanın Numarası için Sohbet Kartı Oluşturuluyor

Geri arama yanlış URL ile yapılandırılmış. Geri arama URL'sini entegrasyon sayfasından tekrar kopyalayın, soru işaretinden sonraki her şey dahil URL'nin tamamını kopyaladığınızdan emin olun.

Deneme Hesabı: Twilio Aramadan Önce Bir Sesli Mesaj Çalıyor

Bu, Twilio deneme hesapları için standart davranıştır. Deneme hesapları yalnızca doğrulanmış telefon numaralarını arayabilir.

Hesabınıza para ekleyin ve tam bir Twilio hesabına yükseltin.