Alat gratis

Template JSON WhatsApp Flows dan Previewer

Dua belas template WhatsApp Flow siap salin dalam bahasa Inggris, Arab, Prancis, Spanyol, Jerman, dan Portugis, mulai dari pengumpulan lead dan booking janji temu hingga survei NPS, daftar periksa KYC, dan pendaftaran penawaran Ramadan. Pratinjau setiap layar dalam bingkai ponsel, salin atau unduh Flow JSON, lalu periksa JSON Anda sendiri terhadap aturan yang didokumentasikan Meta.

Gratis · tanpa pendaftaran · berjalan di browser Anda

Tampilkan template untuk

Flow JSON (versi 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}"
              }
            }
          }
        ]
      }
    }
  ]
}

Tempel ke editor Flow di WhatsApp Manager, atau unggah melalui Flows API. Ganti contoh URL kebijakan privasi dengan URL Anda. Template ini berjalan tanpa data endpoint, sehingga tidak memerlukan data_api_version maupun routing_model.

Pesan yang membuka Flow (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"
        }
      }
    }
  }
}

Pesan interaktif hanya dapat dikirim dalam jendela layanan pelanggan 24 jam. Untuk memulai percakapan sendiri, lampirkan Flow ke template pesan yang sudah disetujui dengan tombol Flow.

Aturan WhatsApp Flows yang diikuti template ini

Flow JSON 7.3 adalah versi yang direkomendasikan Meta untuk memublikasikan Flow baru.
Flow tanpa data endpoint hanya memerlukan version dan screens; Meta membuat routing model-nya.
Setiap Flow berakhir di layar terminal dengan Footer yang menjalankan aksi complete.
Batas per layar: 50 komponen, 1 Footer, 2 tautan tersemat, 3 gambar, dan 5 opt-in.
Label dibuat singkat: 20 karakter untuk kolom teks dan dropdown, 30 untuk grup radio dan checkbox, 35 untuk tombol Footer.
Id layar hanya memakai huruf dan garis bawah, dan SUCCESS adalah kata yang dicadangkan.

Aturan diperiksa terhadap dokumentasi WhatsApp Flows dari Meta pada 2026-10-10.

Kami membangun dan meng-host Flow dengan data endpoint Anda

Butuh slot, harga, atau data akun secara langsung di dalam Flow? Tim kami merancang layar, membangun dan meng-host data endpoint terenkripsi, serta menghubungkan jawaban ke CRM Anda. Hubungi tim penjualan untuk penawaran harga sesuai lingkup proyek.

Data yang Anda ketik di sini tidak dikirim ke server kami.

Jawaban singkat

WhatsApp Flow adalah rangkaian layar di dalam chat yang didefinisikan dengan Flow JSON. Flow valid yang paling sederhana memiliki version, misalnya 7.3, dan array screens. Setiap layar punya id yang terdiri dari huruf dan garis bawah, SingleColumnLayout berisi komponen, serta satu tombol Footer. Layar berpindah ke layar berikutnya lewat aksi navigate, sedangkan layar terakhir ditandai terminal dan menjalankan complete, yang mengirim jawaban ke webhook Anda.

Infrastruktur tepercayaMeta Business Solution Provider resmi Mitra Google RBM Anggota GSMA ISO/IEC 27001:2022 ISO/IEC 27018 ISO 9001:2015 ISO 22301 SOC 2 Type II Sesuai GDPR

Cara menggunakan template WhatsApp Flow

1
Pilih template
Pilih kasus penggunaan seperti pengumpulan lead, reservasi meja, atau tiket dukungan, lalu beralih antarversi bahasa.
2
Pratinjau layar
Ketuk tombol di pratinjau ponsel untuk berpindah antarlayar, persis sesuai urutan yang akan dilihat pelanggan.
3
Salin atau unduh JSON
Tempelkan Flow JSON ke editor Flow di WhatsApp Manager atau unggah lewat Flows API, lalu publikasikan.
4
Validasi hasil edit Anda
Tempelkan JSON yang sudah Anda ubah ke validator untuk menemukan rute yang rusak, kolom yang hilang, dan label yang melebihi batas karakter Meta.

Isi file Flow JSON WhatsApp

Flow JSON memiliki dua properti wajib: version dan screens. Setiap layar memiliki id, title opsional yang tampil di bilah atas, dan layout bertipe SingleColumnLayout yang berisi komponen: teks, input, daftar pilihan, pemilih tanggal, opt-in, dan satu tombol Footer.

Navigasi diatur lewat aksi. Footer dengan navigate membuka layar berikutnya; pada layar terakhir yang ditandai terminal, Footer dengan complete menutup Flow dan mengirim payload ke bisnis Anda beserta flow token. Sejak Flow JSON 4.0, setiap layar dapat membaca kolom dari layar sebelumnya dengan ${screen.SCREEN_ID.form.field}, sehingga template ini membiarkan payload navigate kosong dan mengumpulkan semua jawaban di payload complete terakhir.

version: versi Flow JSON, yaitu "7.3" di setiap template.
screens: daftar layar berurutan; layar pertama yang tidak memiliki rute masuk adalah layar awal.
routing_model dan data_api_version: hanya untuk Flow yang memanggil data endpoint Anda.
terminal dan success: menandai layar terakhir dan apakah menyelesaikan Flow di layar tersebut dihitung sebagai berhasil.

Flow dengan atau tanpa data endpoint

Kedua belas template ini tanpa endpoint. Template berjalan tanpa server: pilihan ditulis langsung di JSON, Meta membuat routing model, dan Anda menerima jawaban di webhook saat pelanggan menyelesaikan Flow. Meta merekomendasikan Flow tanpa endpoint selama data real-time tidak diperlukan, karena Flow terbuka lebih cepat dan lebih singkat dibuat.

Tambahkan data endpoint jika layar bergantung pada data real-time: slot janji temu yang tersedia, harga yang berubah, stok, atau pengecekan akun pelanggan. Dalam kasus itu, layar menggunakan data_exchange, Flow memerlukan data_api_version dan routing_model, dan endpoint Anda harus mendekripsi setiap permintaan serta menjawab dalam batas waktu Meta. Bagian inilah yang kami bangun dan kelola untuk klien.

Batas karakter dan aturan komponen yang perlu dipatuhi

Sebagian besar Flow ditolak karena aturan kecil. Label dibatasi singkat: 20 karakter untuk input teks, text area, atau dropdown, 30 untuk grup radio atau checkbox, 40 untuk pemilih tanggal, dan 35 untuk tombol Footer. Judul opsi dibatasi 30 karakter dan deskripsi 300. Heading menampung 80 karakter dan teks isi 4.096.

Per layar Anda dapat menggunakan hingga 50 komponen, satu Footer, dua tautan tersemat, tiga gambar, dan lima opt-in. Id layar hanya boleh berisi huruf dan garis bawah, dan SUCCESS dicadangkan. Label bahasa Arab dihitung per karakter, bukan per byte, sehingga label Arab 20 karakter tidak masalah. Validator memeriksa semua aturan ini dan menunjukkan layar yang perlu diperbaiki.

Flow Arab dan RTL untuk pelanggan negara Teluk (GCC)

Setiap template memiliki versi bahasa Arab asli dengan layar dan nama kolom yang sama, sehingga kode webhook Anda menangani kedua bahasa tanpa perubahan. WhatsApp menampilkan Flow berbahasa Arab dari kanan ke kiri di ponsel pelanggan; pratinjau menampilkan arah yang sama.

Pustaka ini mencakup kasus penggunaan yang penting di kawasan Teluk: pendaftaran penawaran Ramadan dan Idul Fitri dengan waktu pesan setelah buka puasa (iftar), reservasi meja restoran, permintaan kunjungan properti, dan daftar periksa dokumen KYC yang meminta pelanggan tidak mengirim foto KTP atau ID di chat.

Cara mengirim Flow ke pelanggan

Setelah Anda mempublikasikan Flow, kirim sebagai pesan flow interaktif dengan Flow ID, flow token yang Anda buat, teks tombol singkat, dan layar pertama. Pustaka ini menyediakan payload pesan untuk setiap template. Pesan interaktif hanya berfungsi dalam jendela layanan pelanggan 24 jam; untuk menjangkau pelanggan lebih dulu, lampirkan Flow ke template pesan yang sudah disetujui dengan tombol Flow.

Saat pelanggan selesai, WhatsApp menampilkan ringkasan jawaban mereka dan Anda menerima payload lengkap di webhook. Balas dengan pesan konfirmasi yang menjelaskan langkah selanjutnya serta cara mengubah atau membatalkan.

JSON WhatsApp Flows: pertanyaan umum

Versi Flow JSON mana yang sebaiknya saya gunakan?

Gunakan 7.3, versi yang direkomendasikan Meta untuk mempublikasikan Flow baru saat kami memeriksa changelog-nya. Versi lama seperti 5.0 sudah dibekukan: Flow di versi tersebut masih bisa dikirim tetapi tidak bisa dipublikasikan.

Apakah saya memerlukan server atau data endpoint untuk template ini?

Tidak. Semua template tanpa endpoint. Pilihan ditulis di JSON dan jawaban sampai ke webhook Anda saat pelanggan mengetuk tombol terakhir. Anda hanya memerlukan endpoint untuk data real-time seperti slot yang tersedia atau harga.

Bagaimana cara menggunakan template di WhatsApp Manager?

Buat Flow di WhatsApp Manager, buka editor JSON, ganti isinya dengan template, periksa pratinjau, lalu publikasikan. Anda juga dapat membuat dan mempublikasikan Flow lewat Flows API.

Bisakah saya mengedit label dan pilihan?

Bisa. Ubah teks apa pun, tambah atau hapus pilihan dan kolom, lalu tempelkan JSON ke validator. Validator memperingatkan Anda saat label melebihi batas karakter atau rute mengarah ke layar yang sudah tidak ada.

Mengapa Flow saya gagal dipublikasikan?

Penyebab umumnya adalah label melebihi batas, id layar yang mengandung angka atau tanda hubung, layar terminal tanpa Footer, aksi complete di layar non-terminal, dan data_exchange tanpa data_api_version serta routing model.

Apakah template bahasa Arab ditampilkan dari kanan ke kiri?

Ya. Template ditulis dalam bahasa Arab, dan WhatsApp menampilkannya dari kanan ke kiri. Nama kolom dan id opsi tetap dalam bahasa Inggris, sehingga kode webhook yang sama berfungsi untuk kedua bahasa.

Bisakah Flow mengumpulkan dokumen identitas?

Flow memiliki komponen pemilih foto dan dokumen, tetapi unggahan sensitif perlu penanganan yang hati-hati. Template KYC hanya memeriksa dokumen apa yang dimiliki pelanggan dan menjadwalkan pengiriman yang aman, sehingga gambar identitas tidak masuk ke chat.

Apakah validator ini sama dengan milik Meta?

Tidak. Validator ini menjalankan pemeriksaan statis dasar yang mengacu pada error yang didokumentasikan Meta. Validator Meta di WhatsApp Manager juga memeriksa ekspresi dan model data, jadi publikasikan hanya setelah validator tersebut tidak melaporkan error.