WhatsApp Flows

WhatsApp Flow, müşterinizin sohbetten çıkmadan doldurduğu bir formdur. Önce adını, sonra e-postasını, sonra tarihi beş ayrı mesajda sormak — ve cevapların kullanılabilir bir düzende gelmesini ummak — yerine tek bir buton gönderirsiniz. Müşteri butona dokunur, WhatsApp'ın içinde çok ekranlı küçük bir form açılır ve gönderdiğinde bütün cevaplar akışınıza tek seferde ulaşır.

Tipik kullanımlar: müşteri adayı toplama, randevu alma, destek talebi, memnuniyet anketi, kayıt formu.

Başlamadan önce

• Bağlı bir WhatsApp Business numarası (Kimlik Bilgileri → WhatsApp hesapları). Kanalın temelleri için WhatsApp trigger sayfasına bakın.
• Bir flow mesajı yalnızca 24 saatlik müşteri hizmetleri penceresi içinde gönderilebilir — yani müşterinin son mesajından itibaren 24 saat içinde. Pencere kapandıysa önce onaylı bir şablon göndererek konuşmayı yeniden açın.

Bir flow oluşturma

1. Kimlik Bilgileri → WhatsApp hesapları'na gidin ve göndermek istediğiniz numarada Manage WhatsApp Flows'a tıklayın.

2. New flow'a tıklayın — ya da hazır kullanım senaryolarından birini (müşteri adayı toplama, randevu, anket, iletişim formu) seçip düzenleyin.

3. Flow'a bir ad ve bir veya birkaç kategori verin. Meta, flow'u incelerken kategoriye bakar; bu yüzden gerçekte ne topladığınıza uyanı seçin.

4. Ekranlarınızı kurun. Her ekran, paletten eklediğiniz bileşenlerden oluşur:

   Bileşen	Ne için
   Başlık / Alt başlık / Gövde metni / Açıklama	Ne sorduğunuzu ve nedenini anlatmak
   Metin kutusu / Metin alanı	Kısa cevaplar, uzun cevaplar
   Açılır liste / Radyo düğmeleri / Onay kutuları	Seçeneklerden seçtirmek
   Tarih seçici	Tarihler ve randevu günleri
   Onay (Opt-in)	Onay kutuları (koşullar, pazarlama izni)
   Footer (CTA)	Ekranı bitiren buton — sonraki ekrana geçer veya formu tamamlar

5. Sağdaki önizlemeyi takip edin. Formu müşterinin göreceği gibi gösterir; ayrıca Meta'nın reddedeceği her şeyi listeleyen bir doğrulama paneli vardır. Meta preview, gerçek etkileşimli görünümü açar.

6. Save & publish'e tıklayın.

Taslak ve yayınlanmış

Taslak serbestçe düzenlenir ama gönderilemez. Yayınlamak Meta'nın kontrollerini çalıştırır ve flow'u gönderilebilir yapar — bir yandan da dondurur: yayınlanmış bir flow'u değiştirmek için onu yeni bir taslağa klonlarsınız. Bir flow'u düzenleyip kaydetmek yalnızca sizdeki kopyayı değiştirir; siz yeniden yayınlayana kadar müşteriler son yayınlanmış sürümü görmeye devam eder.

Bu düzenleyicinin dışında oluşturulan akışlar

Meta'da kopyalanmış ya da Meta'nın kendi Flow Builder'ında oluşturulmuş bir akışın ekranlarının kopyası bizde yoktur — Meta'nın API'si onları döndürmez. Böyle bir akışı açtığınızda bir uyarı bandı ve boş bir başlangıç akışı görürsünüz; Yine de değiştir'e basana kadar kayıt engellenir: kaydetmek Meta'daki gerçek tasarımın üzerine yazar ve Meta sürüm geçmişi tutmaz. Bu akışları oluşturuldukları yerde düzenleyin ya da değişimi bilerek onaylayın.

Düzenleyici ayrıca karşılığı olmayan bileşenleri korur — Meta yeni bileşenleri, bizim onlara editör eklememizden hızlı yayınlıyor. Kesik çizgili bir "Bilinmeyen bileşen" kartı olarak görünürler, oldukları gibi yayınlanırlar ve JSON görünümünden düzenlenebilirler.

Hiçbir şey kazara silinmez

Kaydedilmemiş değişikliklerle düzenleyiciyi kapatmak — Escape'e basmak veya dışına tıklamak dahil — önce sorar. Çalışmaya başladıktan sonra bir şablon seçmek de sorar, çünkü şablon tüm ekranları değiştirir. Akış listesindeki Sil ve Kullanımdan kaldır da sorar ve akışın adını söyler: ikisi de geri alınamaz, Meta'da geri getirme yoktur.

Bir agentflow'dan flow gönderme

Flow'lar WhatsApp aracıyla, bir Tool node'undan veya bir Agent node'unun içinden gönderilir:

1. Aracı ekleyin ve WhatsApp hesabınızı seçin.
2. Send Flow işlemini etkinleştirin.
3. Select Flow'dan flow'u seçin. Yalnızca yayınlanmış flow'ları göndermek güvenlidir — listede her flow'un durumu yazar.
4. Flow Button Label (CTA)'yı yazın — formu açan butonun metni; en fazla 30 karakter, emoji yok (örn. Randevu al).
5. Flow Message Text'i yazın — butonun üstünde görünen mesaj.

Hepsi bu. Gerisi — hangi sürümün açılacağı, cevapların bu akışa nasıl geri döneceği — sizin için halledilir.

Ücretlendirme

Flow mesajları istek bazlı WhatsApp gönderimi olarak ücretlendirilir (token bazlı değildir). Flowera fiyatlandırmasında sendFlowMessage, whatsapp_send_flow_message tooltype'ını kullanır ve fiyatı bilinçli olarak whatsapp_send_template_message ile aynı tutulur.

Cevapları alma

Gönderilen bir form, normal bir mesaj olarak değil, kendi olay türüyle gelir. Start node'unuzdaki WhatsApp trigger'ında Form Responses 📝'yi etkinleştirin — yalnızca metin, buton veya liste dinleyen bir akış form gönderimlerini asla görmez.

Trigger size şunları verir:

Değişken	İçeriği
{{$webhook.<name>.formResponse}}	Cevaplar, nesne olarak — müşterinin doldurduğu her alan için bir giriş
{{$webhook.<name>.formResponseText}}	Aynı cevaplar, okunabilir etiket: değer satırları olarak — doğrudan bir yanıta veya prompt'a koyabilirsiniz
{{$webhook.<name>.flowToken}}	Form oturumunun token'ı
{{$webhook.<name>.flowChatflowId}}	Formu hangi akışın gönderdiği — aynı numaradan birden fazla akış form gönderiyorsa işe yarar

Tipik devamı: prompt'unda {{$webhook.whatsapp.formResponseText}} bulunan bir LLM node'u ("müşteriye teşekkür et ve bu bilgileri onayla") ve cevapları tuttuğunuz yere yazan bir Tool node'u.

Statik ve endpoint destekli flow'lar

Bir flow oluştururken türünü seçersiniz:

• Statik (navigate) — her ekran, seçenek ve doğrulama kuralı yayınlandığında sabitlenir. Form tamamen müşterinin telefonunda çalışır. Formların çoğu bu türdür ve yayınlamak dışında kurulum gerektirmez.
• Endpoint (data exchange) — her adım sunucunuza gider; böylece bir ekran canlı veriyle kurulabilir (bugünkü boş randevu saatleri, güncel fiyatlar, önceki cevaba bağlı seçenekler).

Endpoint flow'ları için numara başına bir kez şifreleme kurulur: flow builder'daki Endpoint encryption (Tier 2) bölümünü açıp Generate & upload public key'e tıklayın. Flowera anahtar çiftini üretir, özel anahtarı şifreli saklar ve açık anahtarı Meta'ya yükler. Buton eksik yapılandırma bildiriyorsa yöneticinize danışın — sunucu tarafı anahtarlarına ihtiyaç duyar.

Flow durumları

Durum	Anlamı
Draft	Düzenlenebilir, gönderilemez.
Published	Yayında ve gönderilebilir. Formun kendisi dondurulmuştur.
Deprecated	Emekliye ayrılmış. Açık formlar tamamlanabilir, yeni gönderimler reddedilir.
Blocked / Throttled	Meta tarafından politika veya kalite nedeniyle geçici olarak gönderilemez yapılmış.

Sorun giderme

Müşteri formu gönderdi ama hiç cevap gelmedi

Formun gönder butonu alanlarını eşlemiyor; bu yüzden WhatsApp'ın geri gönderecek bir şeyi olmadı. Flow'u açın — bir uyarı eksik alanları söyler — sonra kaydedin ve yeniden yayınlayın. Yalnızca kaydetmek yetmez; yeniden yayınlayana kadar WhatsApp eski sürümü sunmaya devam eder.

Flow mesajı reddediliyor

Ya 24 saatlik pencere kapanmıştır (önce onaylı bir şablon gönderin) ya da flow Published değildir.

Gönderirken "Parameter value is not valid" hatası

İlk ekran, gönderimde verilmeyen bir veri bekliyor. Ya o ekranı statik hale getirin ya da ekranın müşteri açtığında doldurulması için endpoint destekli bir flow kullanın.

Cevaplar yanlış akışa gidiyor

Form oturumları 24 saat sonra geçersizleşir. Müşteri eski bir formu gönderdiyse flowChatflowId ile hangi akışa ait olduğuna bakın ve yeni bir oturum başlatmak için formu tekrar gönderin.

İlgili sayfalar

• WhatsApp aracı — flow, şablon ve mesaj gönderme
• WhatsApp trigger — mesaj ve form yanıtı alma
• Değişkenler — webhook alanlarının tam listesi