Ücretsiz araç

WhatsApp Flows JSON Şablonları ve Önizleyici

İngilizce, Arapça, Fransızca, İspanyolca, Almanca ve Portekizce on iki kopyalamaya hazır WhatsApp Flow şablonu: potansiyel müşteri toplama ve randevu rezervasyonundan NPS anketlerine, KYC kontrol listelerine ve Ramazan teklifi kayıtlarına kadar. Her ekranı telefon çerçevesinde önizleyin, Flow JSON'ını kopyalayın veya indirin ve kendi JSON'ınızı Meta'nın belgelediği kurallara göre kontrol edin.

Ücretsiz · kayıt gerektirmez · tarayıcınızda çalışır

Şunlar için şablonları göster

Flow JSON (sürüm 7.3)

{
  "version": "7.3",
  "screens": [
    {
      "id": "CONTACT",
      "title": "Your details",
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Tell us about you"
          },
          {
            "type": "TextBody",
            "text": "It takes less than a minute. We only use these details to reply to your request."
          },
          {
            "type": "TextInput",
            "name": "full_name",
            "label": "Full name",
            "input-type": "text",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "company",
            "label": "Company",
            "input-type": "text",
            "required": false
          },
          {
            "type": "TextInput",
            "name": "email",
            "label": "Email",
            "input-type": "email",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "phone",
            "label": "Mobile number",
            "input-type": "phone",
            "required": true,
            "helper-text": "Include the country code, for example +971"
          },
          {
            "type": "Footer",
            "label": "Continue",
            "on-click-action": {
              "name": "navigate",
              "next": {
                "type": "screen",
                "name": "NEEDS"
              },
              "payload": {}
            }
          }
        ]
      }
    },
    {
      "id": "NEEDS",
      "title": "Your request",
      "terminal": true,
      "success": true,
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "RadioButtonsGroup",
            "name": "interest",
            "label": "What are you interested in?",
            "required": true,
            "data-source": [
              {
                "id": "demo",
                "title": "A product demo"
              },
              {
                "id": "pricing",
                "title": "Pricing"
              },
              {
                "id": "partnership",
                "title": "Partnership"
              },
              {
                "id": "other",
                "title": "Something else"
              }
            ]
          },
          {
            "type": "Dropdown",
            "name": "timeline",
            "label": "When do you start?",
            "required": true,
            "data-source": [
              {
                "id": "now",
                "title": "Right away"
              },
              {
                "id": "one_three",
                "title": "In 1 to 3 months"
              },
              {
                "id": "later",
                "title": "Later this year"
              },
              {
                "id": "exploring",
                "title": "Just exploring"
              }
            ]
          },
          {
            "type": "RadioButtonsGroup",
            "name": "call_time",
            "label": "Best time to call",
            "required": false,
            "data-source": [
              {
                "id": "morning",
                "title": "Morning"
              },
              {
                "id": "afternoon",
                "title": "Afternoon"
              },
              {
                "id": "evening",
                "title": "Evening"
              }
            ]
          },
          {
            "type": "TextArea",
            "name": "message",
            "label": "Message",
            "required": false,
            "helper-text": "Anything we should know before we call"
          },
          {
            "type": "OptIn",
            "name": "marketing_opt_in",
            "label": "Send me product news and offers on WhatsApp. I can reply STOP at any time.",
            "required": false
          },
          {
            "type": "Footer",
            "label": "Send request",
            "on-click-action": {
              "name": "complete",
              "payload": {
                "full_name": "${screen.CONTACT.form.full_name}",
                "company": "${screen.CONTACT.form.company}",
                "email": "${screen.CONTACT.form.email}",
                "phone": "${screen.CONTACT.form.phone}",
                "interest": "${form.interest}",
                "timeline": "${form.timeline}",
                "call_time": "${form.call_time}",
                "message": "${form.message}",
                "marketing_opt_in": "${form.marketing_opt_in}"
              }
            }
          }
        ]
      }
    }
  ]
}

WhatsApp Manager'daki Flow düzenleyicisine yapıştırın veya Flows API ile yükleyin. Örnek gizlilik URL'sini kendinizinkiyle değiştirin. Bu şablonlar bir veri uç noktası olmadan çalışır; bu yüzden data_api_version ve routing_model gerektirmez.

Flow'u açan mesaj (Cloud API)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "interactive",
  "interactive": {
    "type": "flow",
    "header": {
      "type": "text",
      "text": "Talk to our team"
    },
    "body": {
      "text": "Share a few details and the right person will contact you within one business day."
    },
    "action": {
      "name": "flow",
      "parameters": {
        "flow_message_version": "3",
        "flow_token": "<UNIQUE_FLOW_TOKEN>",
        "flow_id": "<FLOW_ID>",
        "flow_cta": "Get in touch",
        "flow_action": "navigate",
        "flow_action_payload": {
          "screen": "CONTACT"
        }
      }
    }
  }
}

Etkileşimli bir mesaj yalnızca 24 saatlik müşteri hizmetleri penceresi içinde gönderilebilir. Görüşmeyi kendiniz başlatmak için Flow'u, Flow düğmeli onaylı bir mesaj şablonuna ekleyin.

Bu şablonların uyduğu WhatsApp Flows kuralları

Flow JSON 7.3, Meta'nın yeni Flow'ları yayımlamak için önerdiği sürümdür.
Veri uç noktası olmayan bir Flow yalnızca version ve screens gerektirir; yönlendirme modelini Meta oluşturur.
Her Flow, complete eylemini çalıştıran bir Footer'a sahip bir bitiş ekranıyla sona erer.
Ekran başına sınırlar: 50 bileşen, 1 Footer, 2 gömülü bağlantı, 3 görsel ve 5 açık rıza.
Etiketler kısadır: metin girişleri ve açılır listeler için 20, radyo ve onay kutusu grupları için 30, Footer düğmesi için 35 karakter.
Ekran id'leri yalnızca harf ve alt çizgi kullanır; SUCCESS ayrılmıştır.

Kurallar, Meta'nın WhatsApp Flows belgelerine göre 2026-10-10 tarihinde kontrol edildi.

Flow'ları veri uç noktanızla birlikte biz kuruyor ve barındırıyoruz

Bir Flow içinde canlı randevu saatlerine, fiyatlara veya hesap verilerine mi ihtiyacınız var? Ekibimiz ekranları tasarlar, şifreli veri uç noktasını kurar ve barındırır, yanıtları CRM'inize bağlar. Kapsamı belirlenmiş bir teklif için satışla iletişime geçin.

Buraya yazdığınız hiçbir şey sunucularımıza gönderilmez.

Kısa yanıt

WhatsApp Flow, Flow JSON ile tanımlanan bir dizi sohbet içi ekrandır. En basit geçerli Flow'un 7.3 gibi bir sürümü ve bir screens dizisi vardır. Her ekranın harf ve alt çizgiden oluşan bir id'si, bileşenli bir SingleColumnLayout'u ve bir Footer düğmesi vardır. Ekranlar navigate eylemleriyle ilerler; son ekran terminal olarak işaretlenir ve cevapları webhook'unuza gönderen complete eylemini çalıştırır.

Güvenilir altyapıResmî Meta Business Solution Provider Google RBM iş ortağı GSMA üyesi ISO/IEC 27001:2022 ISO/IEC 27018 ISO 9001:2015 ISO 22301 SOC 2 Type II GDPR uyumlu

WhatsApp Flow şablonu nasıl kullanılır

1
Bir şablon seçin
Potansiyel müşteri toplama, masa rezervasyonu veya destek talebi gibi bir kullanım senaryosu seçin, ardından dil sürümleri arasında geçiş yapın.
2
Ekranları önizleyin
Telefon önizlemesindeki düğmeye dokunarak her ekranı müşterinin göreceği sırayla gezin.
3
JSON'ı kopyalayın veya indirin
Flow JSON'ını WhatsApp Manager'daki Flow düzenleyicisine yapıştırın veya Flows API ile yükleyin, ardından yayımlayın.
4
Düzenlemelerinizi doğrulayın
Değiştirdiğiniz JSON'ı doğrulayıcıya yapıştırarak bozuk yönlendirmeleri, eksik alanları ve Meta'nın karakter sınırlarını aşan etiketleri yakalayın.

Bir WhatsApp Flow JSON dosyasında neler var

Flow JSON'ın iki zorunlu özelliği vardır: version ve screens. Her ekranın bir id'si, üst çubukta gösterilen isteğe bağlı bir başlığı ve alt öğeleri bileşenler olan SingleColumnLayout türünde bir düzeni vardır: metin, girdiler, seçim listeleri, tarih seçiciler, izin kutuları ve bir Footer düğmesi.

Gezinme eylemlerde yaşar. navigate'li bir Footer sonraki ekranı açar; terminal olarak işaretlenmiş son ekranda complete'li bir Footer Flow'u kapatır ve yükü flow token ile birlikte işletmenize gönderir. Flow JSON 4.0'dan itibaren her ekran, önceki bir ekranın alanlarını ${screen.SCREEN_ID.form.field} ile okuyabilir; bu yüzden şablonlar navigate yüklerini boş tutar ve tüm cevapları son complete yükünde toplar.

version: Flow JSON sürümü; tüm şablonlarda "7.3".
screens: ekranların sıralı listesi; gelen yönlendirmesi olmayan ilk ekran giriş ekranıdır.
routing_model ve data_api_version: yalnızca veri uç noktanızı çağıran Flow'lar için.
terminal ve success: son ekranı ve orada bitirmenin başarı sayılıp sayılmadığını işaretler.

Veri uç noktalı ve uç noktasız Flow'lar

On iki şablonun hepsi uç noktasızdır. Sunucu olmadan çalışırlar: seçenekler JSON'a yazılır, Meta yönlendirme modelini oluşturur ve müşteri Flow'u tamamladığında cevapları webhook'unuzda alırsınız. Meta, canlı veri gerekmediği sürece uç noktasız Flow'ları önerir; çünkü daha hızlı açılır ve daha çabuk hazırlanır.

Ekran canlı veriye bağlıysa bir veri uç noktası ekleyin: uygun randevu saatleri, değişen bir fiyat, stok veya müşterinin hesabına karşı bir kontrol. O zaman ekranlar data_exchange kullanır, Flow'un data_api_version ve routing_model değerlerine ihtiyacı olur ve uç noktanızın her isteğin şifresini çözüp Meta'nın zaman aşımı içinde yanıtlaması gerekir. Müşteriler için kurup barındırdığımız kısım budur.

Uyulması gereken karakter sınırları ve bileşen kuralları

Reddedilen Flow'ların çoğu küçük kurallarda takılır. Etiketler kısadır: metin girişi, metin alanı veya açılır liste için 20 karakter, radyo veya onay kutusu grubu için 30, tarih seçici için 40 ve Footer düğmesi için 35. Seçenek başlıkları 30 karakterle, açıklamalar 300 karakterle sınırlıdır. Başlıklar 80, gövde metni 4.096 karakter alır.

Ekran başına en fazla 50 bileşen, bir Footer, iki gömülü bağlantı, üç görsel ve beş izin kutusu kullanabilirsiniz. Ekran id'leri yalnızca harf ve alt çizgi içerebilir; SUCCESS ayrılmıştır. Arapça etiketler bayt değil karakter sayar; yani 20 karakterlik bir Arapça etiket sorun değildir. Doğrulayıcı bunların hepsini kontrol eder ve düzeltilmesi gereken ekranı gösterir.

Körfez müşterileri için Arapça ve sağdan sola Flow'lar

Her şablonun aynı ekranlara ve alan adlarına sahip yerel bir Arapça sürümü vardır; böylece webhook kodunuz iki dili de değişiklik yapmadan işler. WhatsApp, Arapça Flow'ları müşterinin telefonunda sağdan sola yerleştirir; önizleme de aynı yönü gösterir.

Kütüphane Körfez için önemli kullanım senaryoları içerir: iftardan sonra mesaj saatli Ramazan ve Bayram teklifi kayıtları, restoran masa rezervasyonu, gayrimenkul görme talepleri ve müşterilerden kimlik fotoğraflarını sohbette göndermemelerini isteyen bir KYC belge kontrol listesi.

Flow müşterilere nasıl gönderilir

Bir Flow'u yayımladıktan sonra onu, Flow ID'si, oluşturduğunuz bir flow token, kısa bir düğme metni ve ilk ekranla etkileşimli bir flow mesajı olarak gönderin. Kütüphane her şablon için mesaj yükünü verir. Etkileşimli mesajlar yalnızca 24 saatlik müşteri hizmetleri penceresi içinde çalışır; müşterilere ilk siz ulaşmak için Flow'u Flow düğmeli onaylı bir mesaj şablonuna ekleyin.

Müşteri bitirdiğinde WhatsApp ona cevaplarının bir özetini gösterir ve tam yükü webhook'unuzda alırsınız. Sonrasında ne olacağını ve nasıl değiştirileceğini ya da iptal edileceğini söyleyen bir onay mesajıyla yanıt verin.

WhatsApp Flows JSON: sık sorulan sorular

Hangi Flow JSON sürümünü kullanmalıyım?

7.3'ü kullanın; değişiklik günlüğünü kontrol ettiğimizde Meta'nın yeni Flow'ları yayımlamak için önerdiği sürüm buydu. 5.0 gibi eski sürümler dondurulmuştur: bunlardaki Flow'lar gönderilebilir ama yayımlanamaz.

Bu şablonlar için sunucuya veya veri uç noktasına ihtiyacım var mı?

Hayır. Tüm şablonlar uç noktasızdır. Seçenekler JSON'a yazılır ve müşteri son düğmeye dokunduğunda cevaplar webhook'unuza ulaşır. Uç noktaya yalnızca uygun saatler veya fiyatlar gibi canlı veriler için ihtiyacınız olur.

Bir şablonu WhatsApp Manager'da nasıl kullanırım?

WhatsApp Manager'da bir Flow oluşturun, JSON düzenleyicisini açın, içeriği şablonla değiştirin, önizlemeyi kontrol edin ve yayımlayın. Flow'u Flows API ile de oluşturup yayımlayabilirsiniz.

Etiketleri ve seçenekleri düzenleyebilir miyim?

Evet. Herhangi bir metni değiştirin, seçenek ve alan ekleyin veya çıkarın, ardından JSON'ı doğrulayıcıya yapıştırın. Bir etiket karakter sınırını aştığında veya bir yönlendirme artık var olmayan bir ekrana işaret ettiğinde sizi uyarır.

Flow'um neden yayımlanamıyor?

Yaygın nedenler: sınırı aşan bir etiket, rakam veya tire içeren bir ekran id'si, Footer'ı olmayan bir terminal ekran, terminal olmayan bir ekranda complete eylemi ve data_api_version ile yönlendirme modeli olmayan data_exchange.

Arapça şablonlar sağdan sola mı?

Evet. Arapça yazılmışlardır ve WhatsApp bunları sağdan sola gösterir. Alan adları ve seçenek id'leri İngilizce kalır; böylece aynı webhook kodu iki dilde de çalışır.

Bir Flow kimlik belgesi toplayabilir mi?

Flow'larda fotoğraf ve belge seçici bileşenleri vardır ama hassas yüklemeler dikkatli ele alınmalıdır. KYC şablonu yalnızca müşterinin hangi belgelere sahip olduğunu kontrol eder ve güvenli bir gönderim planlar; böylece kimlik görselleri sohbetin dışında kalır.

Bu doğrulayıcı Meta'nınkiyle aynı mı?

Hayır. Meta'nın belgelediği hatalara göre modellenmiş temel statik kontroller yapar. WhatsApp Manager'daki Meta doğrulayıcısı ifadeleri ve veri modellerini de kontrol eder; bu yüzden yalnızca hata bildirmediğinde yayımlayın.