Twilio SMS

Bu rehberde: SMS göndermek ve almak için Twilio hesabınızı bağlarsınız. Hesap bilgilerini kopyalar, bir numara alır ve gelen SMS webhook'unu kurarsınız. Ülke kurallarını öğrenirsiniz.

⏱ 20 dakika

Kimlik kartı#

Ne işe yarar?#

SMS kampanyaları gönderir ve iki yönlü SMS chatbot'u çalıştırır: müşteri numaranıza yazar, mesaj Gelen Kutusu'na düşer, chatbot yanıtlar veya insan devralır.

Ön koşullar#

• console.twilio.com hesabı; SMS yeteneği olan bir numara veya onaylı alfanümerik gönderici kimliği.
• Deneme hesabı kısıtları: yalnızca doğrulanmış numaralara gönderim, mesaj başına "Sent from your Twilio trial account" ön eki.
• Ülke kuralları: ABD için A2P 10DLC kaydı; Türkiye için yerel numara alınamaz, uluslararası numara veya ön kayıtlı alfanümerik gönderici kimliği; AB'de numara için belge paketi.

Adım adım kurulum#

A) Twilio Console#

1. Phone Numbers → Manage → Buy a number: ülke, ① SMS işaretli → Search → ② Buy. Mevcut numara için Active numbers.

2. Konsol ana sayfasında Account Info: ① Account SID (AC...) ve ② Auth Token (Show) değerlerini kopyalayın. ③ Numaranız +14155551234 biçimindedir.
3. ABD numaraları için Messaging → Regulatory Compliance → A2P 10DLC kaydı (1-7 gün).
4. Deneme hesabından çıkmak için Upgrade.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Twilio SMS → Bağla → Proje seçin.
2. Alanlar:

3. ③ Bağla. Bağlantıyı test et: hesap adı, bakiye ve numaranın SMS yeteneği doğrulanır.
4. Webhook adımını tamamlayın.

Webhook kurulumu#

1. OrqLabs → Twilio kartı → Webhook URL: https://api.orqlabs.com/api/v1/webhooks/twilio_sms/<hesap kimliği>.
2. Twilio numara ayarı → Configure → Messaging Configuration → ① A message comes in: adresi yapıştırın, HTTP POST → ② Save. Alternatif: Messaging Service → Integration → Send a webhook.
3. ③ Twilio her isteği X-Twilio-Signature ile imzalar; OrqLabs Auth Token ile doğrular. Adres Twilio'ya girdiğinizle birebir aynı olmalıdır.
4. Test: numaranıza SMS gönderin; Gelen Kutusu'nda konuşma görünür.

İzinler#

Twilio'da kapsam yoktur; Account SID + Auth Token tüm hesabı yetkilendirir. Daha dar yetki için API Keys oluşturabilirsiniz; bu durumda imza doğrulaması için ana Auth Token gerekir (yöneticinizle doğrulayın).

Düzenlemeler#

• Deneme hesabı: yalnızca Verified Caller IDs listesindeki numaralara; toplu mesaj çalışmaz.
• A2P 10DLC (ABD): marka ve kampanya kaydı; kayıtsız mesajlar filtrelenir.
• Alfanümerik gönderici kimliği: Türkiye dahil birçok ülkede ön kayıt zorunlu; tek yönlüdür (yanıt alınamaz).
• AB ve İngiltere: numara için işletme belgeleri.

Limitler#

İpucu: Türkçe karakterleri sadeleştirerek (ş→s) segment sayısını yarıya indirebilirsiniz.

Bağlantıyı test etme#

② Bağlantıyı test et hesap durumunu, bakiyeyi ve numaranın yeteneklerini döndürür. Ardından Mesaj gönder (Twilio SMS) ile kendi numaranıza gönderin; Twilio Monitor → Logs altında durumu izleyin.

Kimlik bilgilerini yenileme#

• Account → API keys & tokens → Auth Token → Request a secondary token ile kesintisiz yenileme: ikincil token'ı OrqLabs'a girin, sonra birincili yükseltin.
• Numara değişirse From number ve webhook ayarını güncelleyin.

Sık karşılaşılan hatalar#

Çıkış (STOP) yönetimi#

Twilio, ABD/Kanada'da STOP, UNSUBSCRIBE gibi yanıtları otomatik işler. Diğer ülkelerde OrqLabs STOP, İPTAL, DUR, ÇIK kelimelerini tanır, adaya unsubscribed etiketi ekler ve kampanyadan çıkarır. Her pazarlama SMS'inde "İptal için DUR yazın" bulundurun; Türkiye'de İYS onayı gerekir.

Sık sorulan sorular#

Türkiye'ye SMS gönderebilir miyim? Evet; uluslararası numara veya ön kayıtlı alfanümerik kimlikle. Yerel Türk numarası Twilio'da satılmaz.

Türkçe mesaj neden daha pahalı? Türkçe karakterler mesajı 70 karakterlik parçalara böler. Karakterleri sadeleştirerek tasarruf edersiniz.

Chatbot SMS üzerinden çalışır mı? Evet; iki yönlü SMS için webhook kurulumu gerekir.

Sonraki adım#

• WhatsApp Business, Telegram Bot
• Broadcast kampanyaları ve izin yönetimi
• Chatbot kurulumu