WhatsApp Business Tetikleyicisi
WhatsApp Business tetikleyicisi, bir müşteri bağlı bir WhatsApp Business numarasına mesaj gönderdiğinde akışınızı başlatır. WhatsApp mesaj türlerinin tam yelpazesini destekler — metin, medya, butonlar, etkileşimli listeler, form gönderimleri, tepkiler ve daha fazlası — ve Flowera tüm Meta Cloud API altyapısını sizin yerinize halleder.
Bu sayfa, tetikleyiciyi bir akışın içinde kurmayı ele alır. WhatsApp numarasının kendisini bağlamak Channels bölümünde bir kez yapılır.
WhatsApp numarası, buradaki hesap açılır menüsünde görünmeden önce Flowera'ya (Embedded Signup aracılığıyla) zaten bağlı olmalıdır. Hesap bağlama için Bağlantı Bilgileri bölümüne bakın.
Bir akışa ekleme
Başlangıç node üzerinde Webhook'lar'ı açın, bir webhook ekleyin ve Webhook Türü'yü WhatsApp Business olarak ayarlayın.
Girdiler
| Parametre | Açıklama | Zorunlu |
|---|---|---|
| Webhook Adı | Bu webhook için benzersiz bir ad (örn. whatsapp-support). {{$webhook.whatsapp-support.senderId}} gibi değişkenlerde kullanılır. | Evet |
| WhatsApp Hesabı | Bu tetikleyicinin dinlediği bağlı WhatsApp Business hesabı. | Evet |
| WhatsApp Mesaj Türleri | Akışı hangi gelen mesaj türlerinin başlattığı (aşağıdaki 13 türe bakın). | Evet |
| Mesajları Grupla | Açıkken, bir müşterinin hızlı ardışık mesajları tek bir yanıtta birleştirilir. Varsayılan olarak açık. | Hayır |
Mesaj türleri
WhatsApp Mesaj Türleri altında akışı hangi tür gelen mesajların tetikleyeceğini seçersiniz. Herhangi bir kombinasyonu seçebilirsiniz:
| Mesaj türü | Şu durumda tetiklenir… |
|---|---|
| Text | Düz bir metin mesajı. |
| Images | Müşterinin gönderdiği bir fotoğraf. |
| Videos | Bir video mesajı. |
| Audio | Bir sesli not veya ses klibi. |
| Documents | Bir PDF, Word dosyası veya başka bir belge. |
| Stickers | Bir WhatsApp çıkartması. |
| Location | Paylaşılan bir konum (enlem/boylam). |
| Contacts | Paylaşılan bir kişi kartı. |
| Button Replies | Gönderdiğiniz bir yanıt butonuna dokunma. |
| Interactive Lists | Gönderdiğiniz etkileşimli bir listeden bir seçim. |
| Form Responses 📝 | Gönderilen bir WhatsApp Flow formu (nfm_reply). |
| Reactions | Bir mesaja emoji tepkisi. |
| Orders | Bir ürün kataloğundan gönderilen bir sepet/sipariş. |
Aynı numaradaki başka bir akış tarafından zaten sahiplenilmiş mesaj türleri burada gizlenir; böylece iki akış asla aynı türü almaz. Bu, (diyelim) destek metnini bir akışa, katalog siparişlerini başka bir akışa yönlendirmenizi sağlar.
Tetiklenen tür {{$webhook.<name>.eventType}} olarak, metin {{$question}} olarak ve {{$webhook.<name>.location}}, {{$webhook.<name>.buttonPayload}}, {{$webhook.<name>.listReplyId}}, {{$webhook.<name>.reactionEmoji}}, {{$webhook.<name>.formResponse}}, {{$webhook.<name>.order}} ve {{$webhook.<name>.referredProduct}} gibi zengin alanlarla birlikte mevcuttur. Gönderilen bir form ayrıca {{$webhook.<name>.formResponseText}} (cevapların okunabilir etiket: değer özeti) ve {{$webhook.<name>.flowChatflowId}} (formun hangi akıştan gönderildiği) değişkenlerini verir. Tam liste için Değişkenler sayfasına bakın.
Form gönderimleri eventType: nfm_reply olarak gelir; bu, interactive'den (buton ve liste yanıtları) farklıdır. Gönderilen formları almak için Form Responses 📝'yi açıkça etkinleştirmelisiniz — yalnızca Interactive Lists veya Button Replies için kurulmuş bir akış onları yakalamaz.
Siparişler ve ürün soruları
Ürün kataloğundan satış yapıyorsanız iki olay ek veri taşır.
Gönderilen sepet eventType: order ile tetiklenir. {{$question}} okunabilir bir özet,
{{$webhook.<ad>.order}} ise ayrıştırılmış sepeti tutar:
| Alan | Nedir |
|---|---|
items | Her satır için bir kayıt: sku, quantity, unitPrice, lineTotal, currency |
total | Tüm satırların toplamı |
currency | Sepetin para birimi |
itemCount | Farklı ürün sayısı |
note | Müşterinin sepeti gönderirken eklediği serbest metin |
catalogId | Ürünlerin geldiği katalog |
Ürün sorusu — müşteri bir ürün kartından İşletmeye mesaj gönder'e dokunup bir şey yazdığında —
sıradan bir metin mesajı olarak gelir; baktığı ürün {{$webhook.<ad>.referredProduct}} içindedir
(catalogId ve sku). Bu olmadan "Bu hâlâ var mı?" gibi bir mesajın neye dair olduğu bilinemez.
Meta ürün kodlarını gönderir, ürün adlarını asla göndermez. Müşteriye gerçek ürün adıyla hitap etmek için SKU eşlemesini akış içinde siz yapmalısınız.
WhatsApp Message Types altında Orders 🛒'i etkinleştirin; aksi hâlde sepetler akışı hiç tetiklemez.
Mesajları Grupla
Müşteriler genellikle art arda birkaç kısa mesaj gönderir. Mesajları Grupla açıkken (varsayılan), Flowera kısa süre bekler, bunları tek bir girdide birleştirir ve akışı bir kez çalıştırır — böylece bot her parçaya değil, mesajın tamamına yanıt verir. Her mesaja geldiği anda yanıt vermek için kapatın.
Tek istisna: gönderilen sepetler. Sipariş ayrı bir iş olayıdır; bu yüzden müşteri aynı bekleme penceresi içinde birden fazla sepet gönderirse, sepetler tek bir girdide birleştirilmez — her biri geliş sırasına göre kendi akış çalıştırmasını alır. O penceredeki sıradan mesajlar ve ekler son çalıştırmayla birlikte gider. Sipariş akışlarınızı çalıştırma başına tek sepet gelecek şekilde tasarlarsanız her iki durumda da doğru davranışı elde edersiniz. Pencere başına çalıştırma sayısı sınırlıdır; sınıra ulaşıldığında kalan sepetler son çalıştırmayı paylaşır. İçinde Wait veya Human Input düğümü bulunan akışlar hiçbir zaman bu şekilde bölünmez, çünkü bu düğümler çalıştırmayı ortasında duraklatır.
Örnek
Bir WhatsApp destek botu: whatsapp-support adlı webhook, Text ve Audio'yu dinliyor. Metin {{$question}} olarak gelir; sesli notlar otomatik olarak yazıya dökülür ve {{$uploads.audios[0].transcript}}'ten okunur. Bir Agent (isteğe bağlı olarak bir bilgi tabanıyla desteklenir) yanıtlar ve WhatsApp'ta yanıt verir.
Mesaj alınamıyor mu?
Kimlik Bilgileri → WhatsApp hesapları ekranında bir numarada kırmızı Mesaj alınamıyor rozeti görüyorsanız, numara bağlanmış ama gelen mesaj bildirimlerine abone olma adımı onaylanmamış demektir. Mesajlar hiç ulaşmadığı için akışınızın yapabileceği bir şey yoktur; önce bunun temizlenmesi gerekir.
- Önce o numarada Durumu yenile'ye tıklayın. Flowera aboneliği Meta'ya yeniden sorar ve gerçekten kuruluysa rozeti kaldırır. Bu uyarıların çoğu eksik bir abonelik değil, kurulum sırasında kaybolmuş bir onaydır — bu adım genelde yeterlidir.
- Rozet yenilemeden sonra da duruyorsa hesabı tekrar bağlayın. Bu, bağlantıyı baştan kurar ve aboneliği yeniden oluşturur.
Yeniden bağlamanın ikinci adım olması bilinçlidir: sizi bütün WhatsApp bağlantı akışından geçirir ve çoğu durumda gerekmez.
İpuçları
- Yalnızca akışınızın gerçekten ele aldığı mesaj türlerini etkinleştirin — daha az tür, daha temiz yönlendirme demektir.
- Tek bir akışta metin, siparişler ve form yanıtları arasında dallanmak için
{{$webhook.<name>.eventType}}üzerinde bir Koşul kullanın. - WhatsApp'ın 24 saatlik bir mesajlaşma penceresi vardır: 24 saatlik sessizlikten sonra bir müşteriye ulaşmak için onaylanmış bir şablona ihtiyacınız vardır (şablon kampanyaları için Toplu Çalıştırma sayfasına bakın).