Kurye firması · Bildirimler
WhatsApp bildirimleri
Müşterilerinize giden sipariş mesajlarını kendi WhatsApp Business hesabınızdan (Twilio ya da Meta) gönderme; kurulum adımları, SMS'e düşüş, iletildi/okundu bilgisi ve sorunlar.
WhatsApp bildirimleri açıkken müşterilerinize ve alıcılarınıza giden sipariş mesajları SMS yerine WhatsApp'tan gider. Mesajın metni SMS şablonunuzla aynıdır; yalnız gönderildiği yer değişir. Mesaj WhatsApp'tan ulaşmazsa aynı metin kendiliğinden SMS olarak gönderilir.
WhatsApp'tan giden mesajlar:
- Sipariş durumu bildirimleri (ör. Sipariş açıldı, Teslim edildi)
- Teslim kodu
- "Kuryeniz yolda" mesajı
- Değerlendirme (puanlama) bağlantısı
- Planlı iş (randevu) hatırlatması
Her zaman SMS olarak kalanlar: SMS gönder ile elle gönderdiğiniz SMS'ler, Toplu mesaj gönderimleri ve telefon doğrulama SMS'leri.
Ücret
WhatsApp mesajları kendi Twilio ya da Meta hesabınızdan gider ve ücreti o hesaptan ödenir. Meta, şablonlu her mesaj (konuşma) için ücret alır; Twilio buna kendi ücretini ekler. Güncel fiyatları kendi hesabınızın panelinden görün. Courino bu özellik için ücret almaz.
Başlamadan önce
- Bir WhatsApp Business hesabınız olmalı (Twilio üzerinden ya da doğrudan Meta'da).
- Gönderen olarak kullanacağınız telefon numarası WhatsApp Business'a kayıtlı olmalı. Bu numara aynı anda telefondaki WhatsApp uygulamasında kullanılamaz.
- Onaylı bir mesaj şablonu gerekir. WhatsApp, işletmenin başlattığı mesajlarda yalnız Meta'nın onayladığı şablonları kabul eder.
- Müşterilerinizin izni: Müşterilerinize WhatsApp'tan mesaj göndermek için onlardan izin almak sizin sorumluluğunuzdadır (KVKK ve ticari ileti kurallarına benzer şekilde). İzni sipariş alırken ya da sözleşmenizde alabilirsiniz.
Şablonu hazırlama
Courino, SMS metnini şablonunuzdaki tek değişkene ({{1}}) yerleştirir. Şablonun gövdesinde yalnız bir değişken olmalı. Meta, değişkenle başlayan ya da biten şablonları reddeder; bu yüzden değişkenin önüne ve arkasına sabit bir metin yazın. Örnek gövde (üç satır):
| Satır | Metin |
|---|---|
| 1 | Gönderiniz hakkında bilgilendirme: |
| 2 | {{1}} |
| 3 | Bu otomatik bir bilgilendirme mesajıdır. |
- Kategori olarak Utility (hizmet/bilgilendirme) seçin.
- Şablonun dilini müşterilerinizin diliyle aynı seçin (ör. Türkçe).
- Onay genellikle birkaç dakika ile birkaç saat sürer.
Twilio ile kurulum
- Twilio hesabınıza girin. Ana sayfadaki Account SID (AC ile başlar) ve Auth Token değerlerini bir yere not edin.
- Messaging › Senders › WhatsApp senders bölümünden WhatsApp gönderen numaranızı kaydedin (Twilio sizi Meta onayından geçirir).
- Messaging › Content Template Builder bölümünde yukarıdaki örneğe benzer bir şablon oluşturun ve WhatsApp onayına gönderin. Onaylanınca şablonun Content SID değerini (HX ile başlar) not edin.
- Courino'da Ayarlar › Bildirimler › Sağlayıcı hesapları'nda WhatsApp satırındaki Tanımla'ya basın.
- Sağlayıcı olarak Twilio'yu seçin.
- Account SID, WhatsApp gönderen numarası (ör. +90 5xx xxx xx xx), Content şablonu SID ve Auth token alanlarını doldurun.
- Kaydet'e basın.
Content şablonu SID'ini boş bırakırsanız mesaj serbest metin olarak gider; bu yalnız Twilio'nun deneme ortamında (sandbox) çalışır. Gerçek müşterilere gönderim için şablon zorunludur.
İletildi/okundu bilgisi için bir şey yapmanız gerekmez: Twilio, pencerede görünen Geri bildirim adresi'ni her mesajla birlikte kendiliğinden alır.
Meta WhatsApp Cloud API ile kurulum
- Meta for Developers üzerinde İşletme (Business) türünde bir uygulama oluşturun ve uygulamaya WhatsApp ürününü ekleyin.
- WhatsApp › API Setup sayfasında gönderen numaranızı ekleyip doğrulayın. Aynı sayfadaki Phone number ID (yalnız rakamlardan oluşur) değerini not edin.
- Kalıcı erişim anahtarı oluşturun: Meta Business Suite'te İşletme ayarları › Kullanıcılar › Sistem kullanıcıları'ndan bir sistem kullanıcısı ekleyin, ona uygulamanızı ve WhatsApp hesabınızı atayın, Token oluştur'a basın ve
whatsapp_business_messagingiznini seçin. Süresi dolmayan bir anahtar seçin. (API Setup sayfasındaki geçici anahtar 24 saatte biter; onu kullanmayın.) - Uygulamanın Ayarlar › Temel sayfasından App secret (uygulama gizli anahtarı) değerini not edin.
- WhatsApp Manager › Mesaj şablonları'ndan yukarıdaki örneğe benzer bir şablon oluşturun ve onaya gönderin. Şablonun adını (ör. siparis_bilgilendirme) ve dilini (ör. tr) not edin.
- Courino'da Ayarlar › Bildirimler › Sağlayıcı hesapları'nda WhatsApp satırındaki Tanımla'ya basın ve Sağlayıcı olarak Meta WhatsApp Cloud API'yi seçin.
- Telefon numarası kimliği, Şablon adı, Şablon dili (boş bırakırsanız tr), Kalıcı erişim anahtarı ve Uygulama gizli anahtarı alanlarını doldurup Kaydet'e basın.
- Kaydedince pencerede Geri bildirim adresi ve Doğrulama belirteci (verify token) görünür. Yanlarındaki kopyala düğmesiyle kopyalayın.
- Meta'da uygulamanızın WhatsApp › Configuration sayfasını açın. Webhook bölümünde Edit'e basın; Callback URL'ye geri bildirim adresini, Verify token'a doğrulama belirtecini yapıştırıp kaydedin.
- Aynı sayfadaki Webhook fields listesinde messages alanına Subscribe (abone ol) deyin.
Uygulama gizli anahtarı girilmezse veya webhook kurulmazsa mesajlar yine gider, yalnız İletildi / Okundu bilgisi ve "numara WhatsApp'ta yok" gibi sonradan gelen hatalar işlenmez; bu durumda SMS'e düşüş de yalnız gönderim anındaki hatalarda olur.
Deneme gönderme
- WhatsApp penceresinin altındaki Deneme gönder bölümüne kendi cep telefonunuzu yazın.
- Gönder'e basın. "Sağlayıcı mesajı kabul etti." yazarsa telefonunuza şablonlu bir deneme mesajı gelir.
- Hata çıkarsa metni okuyun; çoğu zaman şablon adı, dili ya da anahtar hatalıdır.
Deneme mesajı SMS'e düşmez: numara WhatsApp kullanmıyorsa hata olarak görünür.
SMS'e düşüş
Ulaşmayan mesajı SMS olarak gönder seçeneği varsayılan olarak açıktır. Açıkken:
- WhatsApp mesajı gönderilemezse (ör. numara geçersiz, şablon reddedildi) ya da sağlayıcı sonradan "ulaşmadı" bildirirse (ör. numara WhatsApp kullanmıyor), aynı metin aynı kişiye bir kez SMS olarak gider.
- Bunun için SMS kanalınızın (kendi SMS hesabınız ya da platform SMS'i) açık olması gerekir. SMS kanalınız hazır değilse düşüş yapılmaz; pencerede uyarı çıkar.
- Platform SMS'i kullanıyorsanız düşen SMS'ler de platform SMS'i olarak ücretlendirilir.
Seçeneği kapatırsanız ulaşmayan WhatsApp mesajı için SMS gönderilmez.
İletildi ve okundu bilgisi
Bildirim günlüğü'nde WhatsApp satırlarında şu bilgiler görünür:
- İletildi: mesaj alıcının telefonuna ulaştı.
- Okundu: alıcı mesajı açtı. Alıcı WhatsApp'ta okundu bilgisini kapattıysa bu rozet gelmez.
- Ulaşmazsa SMS'e düşer: mesaj ulaşmazsa SMS gönderilecek.
- SMS olarak gönderildi: WhatsApp mesajı başarısız oldu ve aynı alıcıya SMS gönderildi; SMS ayrı bir satırda görünür.
Ayrıntı: Bildirim günlüğü.
Kapatma
WhatsApp penceresinde Gönderim açık seçeneğini kaldırıp Kaydet'e basın; mesajlar yeniden SMS olarak gider. Bilgilerinizi tamamen silmek için Sil'e basın.
Sorun mu var?
- Şablon onaylanmadı ya da "template" hatası: Şablonun onaylı olduğunu, adını ve dilini Courino'ya aynen yazdığınızı kontrol edin. Şablonda yalnız bir değişken olmalı ve şablon değişkenle başlamamalı/bitmemeli.
- Numara WhatsApp kullanmıyor: Mesaj başarısız olur; SMS'e düşüş açıksa ve SMS kanalınız hazırsa SMS gider.
- 24 saat kuralı: WhatsApp, son 24 saat içinde size yazmamış birine yalnız onaylı şablonla mesaj göndermenize izin verir. Bu yüzden şablon zorunludur; serbest metin (Twilio'da şablonsuz gönderim) gerçek müşterilere ulaşmaz.
- Erişim anahtarı geçersiz: Meta'nın geçici anahtarı 24 saatte biter. Sistem kullanıcısıyla süresiz bir anahtar oluşturup yeniden girin.
- İletildi/okundu hiç gelmiyor: Meta'da webhook adresini ve doğrulama belirtecini girdiğinizi, messages alanına abone olduğunuzu ve Courino'ya Uygulama gizli anahtarı'nı girdiğinizi kontrol edin.
- Bakiye yetersiz: Twilio ya da Meta hesabınızda ödeme yöntemi ve bakiye olduğunu kontrol edin.
- Bağlantının genel durumunu Entegrasyon durumu ekranında da görebilirsiniz.