Twilio, uluslararası bir telekomünikasyon sağlayıcısıdır. Botun, Twilio'nun telefon numarası sunduğu Meksika, Brezilya, Türkiye, İspanya, Almanya, Fransa, BAE, Tayland, Malezya ve diğerleri dahil 100'den fazla ülkede 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 arayın;
  • otomatik senaryo tabanlı aramalar — bot müşteriyi arar ve bir metni sesli olarak 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 gizlidir; görüntülemek için Show düğmesine tıklayın

⚠️ Auth Token'ı 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. Tek bir görünmez 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. Hesabınızda Twilio'yu Bağlayın

Project → Integrations → Telephony → 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 Number 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 callback URL 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.

Team sekmesini açın, bir çalışan seçin ve Twilio Phone Number 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. Bağlantı normalde otomatik olarak göründüğü için bu nadiren gereklidir (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 completed olayını değil, recording olayını bekleyin. 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 bir mesaj gönder" senaryosu şu şekilde çalışır: twilio_call_event no-answer veya busy koşulu → müşteriye bir 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 aramayı twilio_call_id kullanarak bulun.

⚖️ Arama kaydı yasalarla düzenlenir. Almanya, Fransa, İspanya ve birçok ABD eyaleti dahil 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

Callback URL, 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 Number 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ığı önleme önlemi olarak birçok ülkeye yapılan 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 Bir Sohbet Kartı Oluşturuluyor

Callback yanlış URL ile yapılandırılmış. Callback URL'yi 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.