Webhook ile her sistemden WhatsApp mesajı gönderin

Başka bir sistemde bir şey olduğunda WhatsApp mesajı göndermek için o sistemin webhook’unu, müşteriyi telefon numarasından bulan ve onaylı bir WhatsApp şablonu gönderen bir alıcıya yönlendirin. Mağazanız, CRM’iniz veya randevu aracınız siparişler, ödemeler ve randevular için zaten webhook gönderiyor; asıl iş hangi olayların mesajı hak ettiğini seçmek, şablonları yazmak, URL’yi güvenceye almak ve müşteriler bir şey görmeden önce gerçek isteklerle test etmektir.

Bu rehber planı, onu şekillendiren WhatsApp kurallarını ve kendi webhook URL’sinden başlayan bir iş akışıyla bunu MonoChat’te nasıl kuracağınızı anlatıyor.

Webhook nedir, ne değildir?

Webhook, bir olay gerçekleştiğinde bir sistemin sizin verdiğiniz URL’ye gönderdiği bir HTTP isteğidir. Shopify bir sipariş oluşturulduğunda, WooCommerce bir sipariş güncellendiğinde, bir CRM bir fırsat aşama değiştirdiğinde, bir randevu aracı bir randevu alındığında webhook gönderebilir. İstek, olayın ayrıntılarını genellikle JSON olarak taşır: sipariş numarası, tutar, müşteri adı ve WhatsApp için en önemlisi, bir telefon numarası.

Webhook müşteriye kendi başına hiçbir şey göndermez. İsteği bir şeyin alması, onunla ne yapılacağına karar vermesi ve WhatsApp Business API’yi çağırması gerekir. Bu “bir şey” ya sizin yazıp barındırdığınız bir koddur ya da size bir webhook URL’si veren ve gerisini kod yazmadan kurmanızı sağlayan bir otomasyon platformudur.

Hangi olaylar bir WhatsApp mesajını hak eder?

Her olay bir mesaja değmez. Tek bir sipariş için beş bildirim alan müşteri hepsini görmezden gelmeye başlar. Müşterinin gerçekten beklediği anları seçin:

Olay	Mesaj	Şablon kategorisi
Sipariş oluşturuldu veya ödendi	Sipariş numarası ve sonraki adımlarla onay	Utility
Ödeme başarısız oldu veya beklemede	Kısa bir not ve yeniden ödeme yolu	Utility
Sipariş kargoya verildi	Kargo firması ve takip bağlantısı	Utility
Kapıda ödemeli sipariş oluşturuldu	Bir soru: siparişi onaylayın, adresi değiştirin veya iptal edin	Utility
Randevu alındı, değişti veya yarın	Tarih, saat, yer ve randevuyu değiştirme yolu	Utility
CRM’de fırsat kazanıldı veya kaybedildi	Müşteri temsilcisine devir ya da bir geri bildirim sorusu	Metne göre utility veya pazarlama
Sepet terk edildi	Bir hatırlatma, belki bir teklifle	Pazarlama

Meta kategoriyi sizin seçtiğiniz etikete göre değil, şablonun ne söylediğine göre belirler. Belirli bir sipariş, ödeme veya randevu hakkındaki mesaj utility’dir; tanıtım yapan, teklif sunan veya ikna etmeye çalışan her şey pazarlamadır ve pazarlamayı kapsayan bir izin gerektirir. WhatsApp şablon örneklerimizde yukarıdaki utility durumları için hazır metinler var.

Geçerli olan WhatsApp kuralları

Webhook mesajlarının çoğu şablon gerektirir

Müşteri hizmetleri penceresi, müşteri size mesaj yazdığında veya sizi aradığında açılır ve son mesajından itibaren 24 saat sürer. Pencere içinde serbestçe yanıt verebilirsiniz; dışında yalnızca önceden onaylanmış şablon mesajlar gönderebilirsiniz. Mağaza ve CRM olayları nadiren bu pencerenin içinde gerçekleşir; bu yüzden her webhook mesajını bir şablon olarak planlayın ve herhangi bir şeyi açmadan önce şablonları onaya gönderin.

Telefon numarası kullanılabilir olmalı

Webhook’un WhatsApp’ın ulaşabileceği bir telefon numarası taşıması gerekir: uluslararası biçimde, ülke koduyla. Birçok mağaza müşterilerin numarasını istediği gibi yazmasına izin verir; birkaç gerçek siparişi kontrol edin. Ülke kodu olmayan bir numara, testin çalışıp canlı ortamın çalışmamasının en yaygın nedenidir.

Fiyatlandırma 1 Ekim 2026’da değişti

Meta 1 Temmuz 2025’ten bu yana iletilen mesaj başına ücret alıyor. 1 Ekim 2026’dan bu yana açık bir müşteri hizmetleri penceresi içinde gönderilen utility şablonları, ücretsiz oldukları bir dönemin ardından yeniden ücretlendiriliyor ve her işletme telefon numarası ayda 1.000 ücretsiz servis mesajı alıyor. Ücretler kategoriye ve müşterinin ülkesine bağlıdır. Pratikte: bir sipariş onayı, müşteri size yakın zamanda yazmış olsun ya da olmasın ücretlidir; bu yüzden önemli mesajları gönderin, gerisini atlayın. WhatsApp API fiyatlandırma rehberi ücret tablosunu açıklıyor.

Webhook URL’sini güvenceye alın

Bir webhook URL’sini bilen herkes onu çağırabilir. Bu URL WhatsApp mesajı gönderiyorsa, sızan bir URL başkasının sizin adınıza müşterilerinize mesaj atabileceği ya da faturanızı şişirebileceği anlamına gelir. Bunu üç alışkanlık önler:

• Secret zorunlu kılın. Gönderen sistem secret’ı bir header’a ekler ya da istek gövdesini onunla imzalar (HMAC-SHA256); böylece alıcı isteğin yolda değiştirilmediğini doğrulayabilir. Geçerli bir secret veya imza içermeyen istekler reddedilir.
• Her amaç için ayrı URL kullanın. Sipariş iş akışı ile randevu iş akışının URL’leri ve secret’ları farklı olmalı; böylece birini diğerine dokunmadan yenileyebilirsiniz.
• Gönderen taraftaki hataları izleyin. WooCommerce, art arda beşten fazla başarısız teslimattan sonra webhook’u devre dışı bırakır; Shopify ise hedefi tekrar tekrar 200 dışında yanıt veren webhook aboneliğini siler. Kapalı veya yanlış yapılandırılmış bir alıcı, bildirimlerinizi sessizce durdurabilir.

Shopify ve WooCommerce’te webhook nereden oluşturulur?

• Shopify: Settings › Notifications › Webhooks, ardından Create webhook. Bir olay seçin (Order creation, Order payment, Fulfillment creation ve daha fazlası), format olarak JSON’u ve bir https:// URL’si girin. Webhook oluşturulduktan sonra olay değiştirilemez; bu yüzden her olay için ayrı bir webhook oluşturun. Send test, isteğin URL’ye ulaştığını kontrol eder.
• WooCommerce: WooCommerce › Settings › Advanced › Webhooks, ardından Add webhook. Bir konu seçin (sipariş, müşteri, kupon veya ürün olayları), teslimat URL’sini ve bir secret girin; WooCommerce, bu secret ile oluşturulan payload hash’ini isteğin header’larına ekler.
• Bir CRM veya randevu aracı: “webhook”, “otomasyonlar” ya da “giden entegrasyonlar” bölümüne bakın. Yalnızca sabit bir format sunuyorsa, bir şey kurmadan önce müşterinin telefon numarasının hangi alanda olduğunu kontrol edin.

Canlıya almadan önce gerçek isteklerle test edin

Webhook payload’ları uzundur ve her platform alanlarını farklı adlandırır: telefon numarası phone, billing.phone ya da customer.default_address.phone olabilir. Tahmin etmeyin. Gerçek bir test isteği gönderin, neyin geldiğine bakın ve alanları buna göre eşleştirin. Ardından uç durumları test edin:

• telefon numarası olmayan ya da ülke kodu eksik numaralı bir sipariş;
• aynı olayın iki kez iletilmesi (platformlar yeniden denerken bunu yapar);
• mesajın sabaha kadar beklemesini tercih ediyorsanız gece 3’te verilen bir sipariş;
• bildirime yanıt veren bir müşteri; bir kişi veya yapay zekâ asistanı yanıtlamaya hazır olmalı.

MonoChat’te nasıl yapılır?

MonoChat resmi bir Meta Business Partner’dır. 3.8.37 sürümünden (Ekim 2026) bu yana bir iş akışı webhook’tan başlayabilir; böylece mağazanız veya CRM’iniz, sizin tarafınızda kod yazmadan WhatsApp mesajlarını tetikleyebilir.

1. İş akışını Webhook Alındı düğümüyle başlatın. Olay düğümlerinden ekleyin. Kendi webhook URL’si ve secret’ı olur. Kanalı, örneğin WhatsApp numaranızı, ve istekte müşterinin telefon numarasının bulunduğu yeri gösteren Kimlik Yolu’nu seçin (varsayılan request.body.phone). MonoChat müşteriyi o kanalda bulur ya da oluşturur ve iş akışını onun için çalıştırır. Düğüm, iş akışı kuyruğa alındığında gönderene 202 ile, kanal veya telefon numarası bulunamadığında ise açık bir hatayla yanıt verir.

2. Secret Zorunlu seçeneğini açın. Gönderen, secret’ı token header’ına (varsayılan Authorization, tek başına ya da Bearer <secret> olarak) koyabilir veya ham gövdenin HMAC-SHA256 imzasını imza header’ında (varsayılan X-Signature) gönderebilir. İki header adı da gönderen sisteme uyacak şekilde değiştirilebilir.

3. Gerçek bir isteği yakalayın. Webhook URL’sinin sonuna /test ekleyin ve mağazanızın test webhook’unu bu adrese yönlendirin. Düğüm ayarları açıkken istek, iş akışını başlatmadan gövdesi, query’si ve header’larıyla Yakalanan İstek altında görünür. İhtiyacınız olan yolları bulmak için bunu kullanın, sonra onları iş akışı değişkeni olarak kaydedin; örneğin request.body.orderId değerini orderId olarak.

4. Mesajı gönderin. Onaylı şablonunuzla bir Şablon Mesaj Gönder düğümü ekleyin ve değişkenlerini iş akışı değişkenlerinden doldurun: sipariş numarası, tutar, takip bağlantısı. Farklı durumlar için farklı şablonlar göndermek üzere koşulları kullanın.

5. Gerekirse geri çağırın. Bir HTTP İsteği düğümü kendi sisteminizden ek veri çekebilir ya da müşterinin yanıtını geri yazabilir; örneğin kapıda ödemeli bir siparişe “onaylandı” bilgisini. Çağrı başarılı olduğunda Çıktı, başarısız olduğunda Başarısız Olduğunda üzerinden devam eder; böylece yedek bir mesaj gönderebilir ya da konuşmayı bir kişiye atayabilirsiniz.

Müşteri yanıt verdiğinde konuşma, diğer WhatsApp, Instagram ve Messenger sohbetlerinizle aynı MonoChat ekip gelen kutusuna düşer; orada ekibiniz ya da bir yapay zekâ asistanı devralabilir. İş akışı kurmak için iş akışı otomasyonu sayfasına bakın.

İşi kimin yapacağına göre iki yol daha var:

• Geliştiricileriniz zaten bir API çağırıyor. WhatsApp Template API uygulaması onaylı bir şablonu tek bir API çağrısıyla gönderir ve yanıtlar gelen kutusuna düşer.
• Shopify kullanıyorsunuz ve sipariş verilerini sohbette görmek istiyorsunuz. Shopify sohbet otomasyonu ürünleri ve siparişleri senkronize eder; böylece ekip ve yapay zekâ asistanı sipariş sorularını yanıtlayabilir.

Başlamak için app.monochat.ai adresinde ücretsiz bir hesap oluşturun, WhatsApp numaranızı bağlayın ve planları fiyatlandırma sayfasında karşılaştırın.

Kaynaklar

• Meta for Developers: Mesaj gönderme ve müşteri hizmetleri penceresi
• Meta for Developers: WhatsApp Business Platform fiyatlandırması
• Meta for Developers: Şablon sınıflandırması
• Shopify Yardım Merkezi: Webhook’lar
• WooCommerce dokümantasyonu: Webhook’lar
• MonoChat yardım merkezi: İş akışları, Webhook Alındı ve HTTP İsteği düğümleri