WhatsApp Sipariş Bildirimi kurulumu: WooCommerce rehberi

WhatsApp Sipariş Bildirimi kurulumu; WooCommerce API anahtarı, WhatsApp numara kimliği ve erişim anahtarı, şablon onayı, panel ayarları ve webhook adımlarından oluşur. Kurulumu Sedeus ekibi yapar; bu rehber kurulumda neler yapıldığını ve kendi kurmak isteyenler için adımları anlatır. Sizden istenenler: Meta işletme hesabınıza erişim, numaranıza gelen doğrulama kodu ve Meta'ya bir ödeme kartı.

Bu rehber, WhatsApp Sipariş Bildirimi modülünü WooCommerce mağazanıza ve WhatsApp Business hesabınıza bağlamayı adım adım anlatır. En uzun bekleme Meta'nın şablon onayıdır; onay beklerken öteki adımlara devam edebilirsiniz.

Modül, sipariş durumu değiştiğinde müşterinize sizin numaranızdan, Meta'nın onayladığı bir şablonla mesaj gönderir. Hangi durumda hangi mesajın gideceğini panelden siz seçersiniz.

WhatsApp Sipariş Bildirimi kurulumu hangi sırayla yapılır?

Sıra şöyledir: numaranızı kontrol edin; WooCommerce API anahtarını oluşturun; Meta'dan telefon numarası kimliğini ve kalıcı erişim anahtarını alın; şablonları onaya gönderin; panel ayarlarını doldurun; WooCommerce webhook'unu ekleyin; deneme mesajı gönderin. Şablon onayı beklerken öteki adımlara devam edebilirsiniz.

Başlamadan önce

• Etkin bir lisans. Modül, Hesabım › Entegrasyonlarım'da görünür.
• https:// ile açılan, herkese açık bir alan adında WooCommerce mağazası. IP adresi ya da yerel adres kabul edilmez.
• Meta Business hesabı ve WhatsApp Business Platform'a (Cloud API) kayıtlı bir numara.
• WhatsApp Business hesabınızda tanımlı bir ödeme yöntemi. Meta'nın mesaj ücretleri lisans bedeline dahil değildir, doğrudan Meta'ya ödenir.
• Kargo mesajı için takip kodunu siparişe yazan bir kargo eklentisi ya da özel alan.

Numaranızı kontrol edin

Mesajlar sizin WhatsApp numaranızdan gider. Numaranın WhatsApp Business Platform'a (Cloud API) kayıtlı olması gerekir.

• Numaranız WhatsApp Business uygulamasında kullanılıyorsa: Meta, uygun numaralarda uygulamayla API'nin birlikte kullanılmasına izin verir. Numarayı eklerken Meta, numaranızın buna uygun olup olmadığını gösterir.
• Uygun değilse: API için ayrı bir numara kullanın (ör. sabit hat ya da 0850 numarası). Yalnızca API'ye kayıtlı bir numara WhatsApp uygulamasında açılmaz.
• Numara eklemek için: WhatsApp Manager › Telefon numaraları › Telefon numarası ekle. Meta, doğrulama kodunu SMS ya da sesli aramayla gönderir.
• Görünen ad: numarayı eklerken yazdığınız işletme adını Meta ayrıca inceler. Reddedilirse WhatsApp Manager'da düzeltip yeniden gönderin.

WooCommerce API anahtarı

Modül, mesajdaki bilgileri siparişin kendisinden okur. Bunun için yalnızca okuma yetkili bir anahtar yeterlidir.

1. WooCommerce › Ayarlar › Gelişmiş › REST API › Anahtar ekle.
2. Açıklama: "Sedeus WhatsApp". Kullanıcı: yönetici hesabınız. İzinler: Okuma.
3. API anahtarı oluştur. Tüketici anahtarı (consumer key) ve tüketici gizli anahtarı (consumer secret) yalnızca bir kez gösterilir; ikisini de kopyalayın.
4. Panelde Ayarlar › Bağlantılar'a yazın:
   • WooCommerce site adresi: mağazanızın ana adresi, ör. https://magazaniz.com;
   • WooCommerce consumer key;
   • WooCommerce consumer secret.

Anahtar ekranının ayrıntısı WooCommerce'in REST API belgesinde (yeni sekmede açılır) anlatılır.

Ayarlar › Kalıcı bağlantılar "Düz" seçiliyse REST API çalışmaz; "Yazı adı" gibi bir yapı seçin.

WhatsApp numara kimliği ve erişim anahtarı

Meta'da bir uygulamanız yoksa developers.facebook.com'da "İşletme" türünde bir uygulama oluşturup WhatsApp ürününü ekleyin.

Telefon numarası kimliği ve işletme hesabı kimliği

• WhatsApp Manager › Telefon numaraları'nda numaranızı açın; ya da uygulamanızda WhatsApp › API Kurulumu'na bakın.
• Telefon numarası kimliği: uzun bir sayıdır (çoğunlukla 15–16 hane), telefon numarasının kendisi değildir. Panelde "WhatsApp telefon numarası kimliği" alanına yazın.
• WhatsApp işletme hesabı kimliği: Aynı ekranda yazar. İsteğe bağlıdır ama önerilir: doluysa şablonlarınızın onay durumu Durum sekmesinde görünür.

Kalıcı erişim anahtarı

API Kurulumu sayfasındaki geçici anahtar 24 saatte geçersiz olur; onu kullanmayın. Kalıcı anahtarı bir sistem kullanıcısıyla oluşturun:

1. Meta Business Ayarları › Kullanıcılar › Sistem kullanıcıları › Ekle. Rol: Yönetici.
2. Varlık ata: uygulamanıza ve WhatsApp hesabınıza tam kontrol verin.
3. Yeni anahtar oluştur: uygulamanızı seçin, süre "Hiçbir zaman". İzinler: whatsapp_business_messaging ve whatsapp_business_management.
4. Anahtar yalnızca bir kez gösterilir. Panelde "Meta erişim anahtarı" alanına yapıştırın.

Sistem kullanıcısı ve kalıcı anahtar adımları Meta'nın WhatsApp Cloud API başlangıç belgesinde (yeni sekmede açılır) de anlatılır.

Anahtar ve gizli alanlar kaydedildikten sonra panelde gösterilmez. Değiştirmek için alanı yeniden doldurun; boş bırakırsanız eski değer korunur.

Şablonları onaya gönderin

WhatsApp Manager › Mesaj şablonları › Şablon oluştur. Her şablon için:

• kategori: Yardımcı program (Utility);
• dil: Türkçe;
• ad: aşağıdaki tablodaki gibi, küçük harf ve alt çizgiyle;
• değişken örnekleri: Meta her değişken için örnek değer ister; tablodaki örnekleri kullanabilirsiniz.

• Yalnızca bir duruma bağlayacağınız şablonlar gerekir. Ör. yalnızca sipariş onayı ve kargo mesajı istiyorsanız iki şablon yeter.
• Metni değiştirebilirsiniz. Değişken sayısı ve sırası tablodakiyle aynı kalmalı; metin değişkenle başlamamalı ya da bitmemeli.
• Başlık ve alt bilgi isteğe bağlıdır; yalnızca sabit metin kullanın (ör. başlık "Sipariş Onayı", alt bilgi "Bu mesaj otomatik olarak gönderilmiştir."). Başlıkta değişken ve düğme kullanmayın: modül yalnızca gövdedeki değişkenleri doldurur.
• Mesaja kampanya ya da indirim cümlesi eklemeyin. Eklerseniz Meta şablonu pazarlama kategorisine alır ve müşteriden ayrıca izin gerekir.
• Onay çoğunlukla saatler ile 1–2 gün sürer.

Değerlerin kaynağı:

• ad: fatura adı; yoksa teslimat adı; ikisi de yoksa "değerli müşterimiz";
• sipariş no: WooCommerce'teki sipariş numarası;
• tutar: sipariş toplamı, ör. 1.250 ₺;
• kargo firması, takip no ve bağlantı, tahminler: panelde Kargo bilgileri ve Takip kodu alanı ayarlarından.

Hazır metinlerin tamamı ve Meta'nın onay kuralları için WhatsApp mesaj şablonları sayfasına bakın.

Panel ayarları

Hesabım › Entegrasyonlarım › WhatsApp Sipariş Bildirimi › Ayarlar. Bağlantılar bölümünü yukarıdaki adımlarda doldurdunuz. Öteki bölümler:

Durum ve şablon

• Her sipariş durumu için gönderilecek şablonu seçin ya da "Gönderme" bırakın.
• Önerilen eşleme:
  • Hazırlanıyor → Sipariş onayı;
  • Kargoda → Kargoya verildi;
  • Tamamlandı → Teslim edildi.
• "Kargoda" durumu WooCommerce'te varsayılan olarak yoktur; kargo eklentileri ekler. Eklentiniz eklemiyorsa kargo mesajını "Tamamlandı"ya bağlayabilirsiniz.
• Özel durumlar: eklentinizin eklediği başka durumlar için her satıra bir eşleme yazın: durum kodu = şablon adı, ör. dagitimda = dagitimda. En çok 20 satır.

Takip kodu ve kargo bilgileri

• Takip kodunun okunacağı alan: kargo eklentinizin takip kodunu yazdığı sipariş alanı, ör. _tracking_number. Listede yoksa alanın adını elle yazın.
• Kargo firması: siparişe firma adı yazılmıyorsa mesajda bu ad kullanılır. Eklentiniz firma adını siparişe yazıyorsa "Kargo firması alanı"na alanın adını yazın.
• Takip bağlantısı kalıbı: kargo firmanızın takip adresi; takip kodunun yerine {kod} yazın. Eklentiniz bağlantının tamamını siparişe yazıyorsa "Takip bağlantısı alanı"nı kullanın.
• Kargo mesajı bir duruma bağlıysa kargo firması (ad ya da alan) ve takip bağlantısı (kalıp ya da alan) gerekir.
• Tahmini kargoya veriliş ve tahmini teslimat: ilgili mesajlarda görünür.

Gönderim saatleri ve uyarı e-postası

• Gönderim saatleri: bu aralığın dışında değişen siparişlerin mesajı bekletilir, aralık başladığında gider.
• Uyarı e-postası: takip kodu 24 saat içinde girilmeyen siparişler, başarısız gönderimler ve eksik ayarlar bu adrese bildirilir.

Ayarları Kaydet'e bastığınızda kurulum kontrolü çalışır; sonucu Durum sekmesinde görürsünüz.

WooCommerce webhook'u

Webhook, sipariş durumu değiştiğinde modüle haber verir.

1. Entegrasyon sayfanızın Durum sekmesinde, "Bağlantı bilgileri"ndeki Webhook adresini ve Lisans anahtarını kopyalayın.
2. WooCommerce › Ayarlar › Gelişmiş › Webhook'lar › Webhook ekle:
   • Ad: "Sedeus WhatsApp";
   • Durum: Etkin;
   • Konu: Sipariş güncellendi;
   • Teslim adresi: webhook adresi;
   • Gizli anahtar: lisans anahtarınız;
   • API sürümü: WP REST API Entegrasyonu v3.
3. Kaydedin. WooCommerce bir deneme isteği gönderir; Durum sekmesinde "WooCommerce webhook'u" satırı "Webhook bağlandı" olur.

Lisans anahtarını yeniden üretirseniz webhook'taki gizli anahtarı da güncelleyin; güncellemezseniz bildirimler durur.

Müşteri yanıtları ve teslim bilgisi

Müşteriniz mesaja yanıt verdiğinde yanıtı uyarı e-postanıza iletebiliriz. Aynı bağlantıyla mesajların teslim edilip okunduğu da Kullanım sekmesinde görünür. İsteğe bağlıdır; bağlamazsanız mesajlar yine gider.

1. developers.facebook.com › uygulamanız › Uygulama ayarları › Temel › Uygulama gizli anahtarı › Göster. Anahtarı kopyalayın.
2. Panelde Ayarlar › Müşteri yanıtları › "Meta uygulama gizli anahtarı" alanına yapıştırıp kaydedin.
3. Kayıttan sonra kurulum kontrolü, uygulamanızın WhatsApp webhook'unu modüle bağlar. Durum sekmesinde "Yanıt ve teslim bilgisi" satırı "tamam" olur.

• Meta uygulamanız yayımlanmış olmalı. Yayımlanmamış uygulamaya Meta yalnızca panelden gönderilen test bildirimlerini iletir; gerçek yanıtlar ve teslim bilgisi gelmez. Yayımlamak için gizlilik politikası adresi, uygulama simgesi ve kategori gerekir.
• Uygulamanızın WhatsApp webhook'u başka bir adrese bağlıysa üzerine yazılmaz; satır bunu gösterir. O webhook'u başka bir sistem kullanıyorsa bu modül için ayrı bir Meta uygulaması açabilirsiniz.
• Elle bağlamak için: uygulamanızda WhatsApp › Yapılandırma › Webhook. Geri çağırma adresine Durum sekmesindeki "Meta webhook adresi"ni, doğrulama belirtecine "Meta doğrulama belirteci"ni yazın ve "messages" alanına abone olun.
• Numaranız WhatsApp Business uygulamasında da açıksa yanıtlar uygulamaya da gelir. E-posta istemiyorsanız "Müşteri yanıtlarını e-postayla ilet"i kapatın.
• E-postada müşterinin adı, telefonu, mesajı ve varsa ilgili sipariş numarası yer alır. Mesaj metni Sedeus panelinde saklanmaz; yalnızca e-postayla iletilir.
• Müşteri size yazdıktan sonraki 24 saat içinde serbest metinle yanıt verebilirsiniz. Bu modül yalnızca şablon mesajı gönderir.

Kontrol ve deneme mesajı

Durum sekmesindeki kurulum kontrolünde beş satır vardır: WooCommerce bağlantısı, WhatsApp numarası, Şablonlar, WooCommerce webhook'u ve Yanıt ve teslim bilgisi. Kontrol, ayarları kaydettiğinizde, webhook bağlandığında ve her gün 09:00'da çalışır.

1. İlk dört satır "tamam" olana kadar hataları giderin; Yanıt ve teslim bilgisi isteğe bağlıdır. Onayı beklenen şablon Şablonlar satırında "Meta onayı bekliyor" diye görünür; onaydan sonraki ilk kontrolde satır düzelir.
2. Ayarlar sekmesinde Deneme Mesajı Gönder: kendi numaranızı ülke koduyla yazın (ör. 905xxxxxxxxx). Telefonunuza örnek bir sipariş onayı gelir ("Merhaba Ayşe, 1001 numaralı siparişinizi aldık…"). Deneme mesajı kayıtlı ayarlarla gider; ayarları kaydetmez.
3. Son olarak kendinize bir sipariş oluşturup durumunu değiştirin. Mesaj ve sonucu Durum sekmesindeki olaylarda görünür.

Sık karşılaşılan hatalar

Şablon reddedildi ya da "Onaysız"

• "Meta onayı bekliyor": Meta hâlâ inceliyor; beklemeniz yeterli. Onaydan sonraki ilk kontrolde satır "tamam" olur.
• "Onaylanmadı": ret nedeni WhatsApp Manager'da yazar. Sık nedenler: metnin değişkenle başlaması ya da bitmesi, kısa metinde çok değişken, kampanya dili, yanlış kategori. Metni düzeltip yeniden gönderin; şablon adı aynı kalmalı.
• "Bulunamadı": şablon adı ya da dili farklı. Ad tablodakiyle birebir aynı, dil Türkçe olmalı.

Kargo mesajı gitmedi, "Takip kodu eksik" e-postası geldi

• Kargo mesajı takip kodu siparişe yazılmadan gitmez; modül 24 saat boyunca saatte bir bakar, sonra size e-posta gönderir.
• Takip kodunu siparişe eklediğinizde mesaj kendiliğinden gider.
• Kod siparişte olduğu hâlde mesaj gitmiyorsa "Takip kodunun okunacağı alan" ayarındaki alan adını kontrol edin.

WooCommerce bağlantısı hata veriyor

• "Mağaza anahtarı reddedildi": anahtar silinmiş ya da yanlış kopyalanmış. Yeni bir okuma anahtarı oluşturup iki alanı da yeniden girin.
• "Mağaza adresi yönlendiriyor": adres, sitenizin açıldığı adresle aynı değil (www ya da alt klasör farkı). Tarayıcıda açılan tam adresi yazın.
• "Mağazaya ulaşılamadı" ya da "Mağaza yanıt vermedi": bir güvenlik eklentisi ya da güvenlik duvarı kuralı REST API'yi engelliyor olabilir; /wp-json/wc/v3/ isteklerine izin verin. Kalıcı bağlantılar "Düz" olmamalı.

Geçersiz Meta anahtarı ya da numara kimliği

• "Meta: 190 …": erişim anahtarı geçersiz ya da süresi dolmuş. Çoğunlukla geçici anahtar kullanılmıştır; kalıcı sistem kullanıcısı anahtarı oluşturun.
• "Meta: 100 …": telefon numarası kimliği yanlış; kimlik yerine telefon numarasının kendisi yazılmış olabilir.

Mesaj gönderilemedi uyarısı

• 131026: mesaj alıcıya ulaştırılamadı (numara WhatsApp kullanmıyor olabilir).
• 131042: WhatsApp Business hesabında ödeme sorunu var; Meta Business Ayarları › Ödemeler'i kontrol edin.
• 132000: şablondaki değişken sayısı modülün gönderdiğiyle uyuşmuyor; şablonu tablodaki değişken sayısıyla yeniden oluşturun.
• 132001: şablon bulunamadı ya da henüz onaylanmadı.
• Müşterinin telefonu geçersizse mesaj gönderilmez; Durum sekmesinde olay olarak görünür.

Yanıt ve teslim bilgisi satırı uyarı veriyor

• "Uygulama gizli anahtarı bu uygulamaya ait değil": gizli anahtar, erişim anahtarını oluşturduğunuz uygulamanın anahtarı olmalı.
• "Başka bir adrese bağlı": uygulamanızın WhatsApp webhook'unu başka bir sistem kullanıyor; üzerine yazmıyoruz. Ayrı bir uygulama açın ya da adresi elle değiştirin.
• Yanıt e-postası gelmiyor: "Müşteri yanıtlarını e-postayla ilet" açık mı ve uyarı e-postası dolu mu, bakın. Numara WhatsApp Business uygulamasında da açıksa yanıtı orada da görürsünüz.

Mesajlar sabaha kaldı

Gönderim saatleri dışında değişen siparişlerin mesajı aralık başladığında gider. Saatleri Ayarlar › Gönderim saatleri'nden değiştirebilirsiniz.

Kurulumda takılırsanız bize yazın.