WhatsApp ve Telegram ile doğrulama kodu (OTP) gönderme
Sitenizin ya da uygulamanızın ürettiği tek kullanımlık kodu API ile müşterinin WhatsApp'ına ya da Telegram'ına göndermeyi, gereken hazırlığı ve hata mesajlarını anlatır.
Üyelik, giriş ya da işlem onayında müşteriye tek kullanımlık kod göndermeniz gerekiyorsa bunu SMS yerine WhatsApp ya da Telegram üzerinden yapabilirsiniz. Kodu sizin sisteminiz üretir, KuleConnect yalnız iletir. Kodun doğru girilip girilmediğini ve süresinin dolup dolmadığını da kendi sisteminizde denetlersiniz; KuleConnect'te kod doğrulama ucu yoktur.
İsteklerin nasıl imzalanacağı: API'ye genel bakış ve kimlik doğrulama.
WhatsApp ile doğrulama kodu
Hazırlık
- WhatsApp Business hesabınızı bağlayın. Bkz. WhatsApp Business hesabımı nasıl bağlarım?
- WhatsApp Business → Şablonlar'da yeni şablon açın ve Kategori olarak Doğrulama'yı seçin. Metin Meta'nın sabit metnidir; yalnız Kodun geçerlilik süresi (dk), güvenlik notu ve düğme türünü (Kodu kopyala ya da Tek dokunuşla doldur (Android)) belirlersiniz.
- Şablonu onaya gönderin ve Meta onayını bekleyin.
İstek
POST https://panel.ornek.com/v1/whatsapp/otp
| Alan | Zorunlu | Açıklama |
|---|---|---|
phone | Evet | Alıcının numarası (ör. 05321234567 ya da +905321234567). |
code | Evet | Gönderilecek kod; en fazla 15 karakter, yalnız harf, rakam ve tire. |
template | Hayır | Kullanılacak doğrulama şablonunun adı. |
language | Hayır | Şablonun dil kodu (ör. tr). |
Şablon adı vermezseniz onaylı doğrulama şablonlarınızdan ilk oluşturulan kullanılır. Birden çok dilde şablonunuz varsa template ve language alanlarını gönderin.
Örnek gövde: {"phone": "05321234567", "code": "482913"}
Başarılı yanıt: {"success": true, "message_id": "…", "template": "…"}. Her gönderim WhatsApp mesaj limitinizden bir mesaj düşer; ücret Meta tarafından hesabınızdan kesilir.
Olası hatalar (422)
- “Geçersiz telefon numarası.”
- “Onaylı doğrulama şablonu yok.” Şablon henüz onaylanmamış ya da verdiğiniz ad ve dil eşleşmiyor.
- “WhatsApp Business bağlantısı tanımlı değil.”
- Meta'nın gönderimi reddettiği durumlarda Meta'nın hata metni.
Kod içeren mesaj Mesajlar ekranına yazılmaz; ekibiniz kodu göremez. Müşteri kodu kendisi istediği için pazarlama çıkış listesi bu gönderimi engellemez.
Telegram ile doğrulama kodu
Telegram'da kod, Telegram'ın resmî doğrulama hesabından gelir. Bir bot kurmanız ya da müşterinin size daha önce yazmış olması gerekmez; numarasıyla açılmış bir Telegram hesabı yeterlidir.
Hazırlık
gateway.telegram.orgadresinde bir Gateway hesabı açın ve hesabınızın API bölümünden jetonu alın. Gönderim ücreti bu hesabın bakiyesinden düşer.- Panelde Entegrasyonlar → Mail & İletişim sekmesinde Telegram Gateway (doğrulama kodu) kartını açın.
- Gateway API Jetonu alanına jetonu yapıştırıp kaydedin. Genel adımlar: Bir servisi bağlama, sınama ve kaldırma.
İstek
POST https://panel.ornek.com/v1/telegram/otp
| Alan | Zorunlu | Açıklama |
|---|---|---|
phone | Evet | Alıcının numarası. |
code | Evet | 4-8 haneli, yalnız rakamdan oluşan kod. |
ttl | Hayır | Kodun Telegram'da geçerli kalacağı süre, saniye; 30 ile 3600 arası, verilmezse 300. |
Başarılı yanıt: {"success": true, "request_id": "…", "cost": …, "test": false}. cost Telegram'ın bu gönderim için düştüğü ücreti gösterir. Firmanız test modundaysa kod gönderilmez ve yanıtta "test": true döner; kodun gerçekten gittiğini test alanından anlarsınız.
Olası hatalar (422)
- “Kod 4-8 haneli rakam olmalı (Telegram Gateway kuralı).”
- “Telegram Gateway bağlantısı tanımlı değil.”
- “Telegram gönderimi sunucuda kapalı; kod gönderilmedi.” Telegram gönderimi sistem genelinde kapalı; destek ekibine haber verin.
- “Bu numarayla Telegram hesabı yok ya da kod alamıyor; SMS kullanın.”
- “Telegram Gateway bakiyesi yetersiz.” ya da “Telegram Gateway jetonu geçersiz.”
Önerilen akış
- Önce Telegram'ı deneyin.
- Telegram hesabı yok hatası gelirse aynı kodu WhatsApp ile gönderin.
- O da olmazsa kendi SMS altyapınıza geçin. KuleConnect'te SMS ile kod gönderen bir API ucu henüz yok.
Test modunda
Firmanız test modundayken kodlar gerçekte gönderilmez (izinli alıcılar listesindeki numaralar hariç). Telegram yanıtında test alanı true döner. Bkz. Test modu nedir?