> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/chat/broadcasts/whatsapp-media-carousel.md).

# WhatsApp Media Carousel

WhatsApp Carousel adalah template pesan marketing yang berisi satu pesan utama diikuti 2 sampai 10 card yang bisa digeser ke samping. Setiap card punya media (gambar atau video), teks, dan tombol sendiri. Dengan satu template, bisnis bisa menampilkan beberapa produk atau promo dalam satu pesan, tanpa perlu mengirim beberapa template terpisah.

***

### Sebelum Memulai

* Nomor WhatsApp yang dipakai harus sudah memiliki metode pembayaran. Pengingat beserta link **Add payment method** tampil di bagian atas form template dan form campaign.
* Kategori template carousel selalu **Marketing** dan tidak bisa diubah.
* Template harus berstatus **Approved** dari Meta sebelum bisa dikirim.
* Cekat mendukung **Media Card Carousel**, yaitu carousel dengan card berisi gambar atau video. Product Card Carousel tidak didukung.

***

### Membuat Template Carousel

Template carousel dibuat dari **Broadcast Settings > Template Message**.

1. Klik **Add Template**, lalu pilih **New Carousel Template**. Pilihan **New Custom Template** tetap membuka form template biasa dan tidak berubah.
2. Isi **Template Data** dan **Message Body**.
3. Atur **Carousel Card Layout**, yaitu hal-hal yang harus sama di semua card.
4. Lengkapi isi setiap card.
5. Cek hasilnya di **Preview**, lalu klik **Add Template**.

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FqLI5RAJujje8S7YRFRkw%2Fimage.png?alt=media&amp;token=826a23cf-f8d8-43d9-9ff6-aff0b6f995ff" alt=""><figcaption></figcaption></figure>

#### Template Data

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FuGrwfWL4pzLYy1TuXhcY%2Fimage.png?alt=media&amp;token=18afbc06-b65f-4d68-a395-967fdf71af03" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="171.15234375">Field</th><th>Keterangan</th></tr></thead><tbody><tr><td><strong>Template Name</strong></td><td>Wajib</td></tr><tr><td><strong>Channel</strong></td><td>Wajib, Channel WhatsApp tempat template didaftarkan ke Meta</td></tr><tr><td><strong>Language</strong></td><td>Wajib, Bahasa template</td></tr><tr><td><strong>Category</strong></td><td>Otomatis <strong>Marketing</strong>, tidak bisa diubah</td></tr><tr><td><strong>Message Body</strong></td><td>Wajib, teks utama yang tampil di atas card, dapat menggunakan berbagai format dan tambahan variable</td></tr></tbody></table>

#### Carousel Card Layout

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FXSd7G5i0rilr33KT5Fs2%2Fimage.png?alt=media&amp;token=9c8a11d1-cc6e-40ec-bfc0-1926cd987dae" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="177.63671875">Setting</th><th>Keterangan</th></tr></thead><tbody><tr><td><strong>Card Header</strong></td><td>Pilih <strong>Image</strong> atau <strong>Video</strong>. Mengubah format akan menghapus media yang sudah diunggah di semua card.</td></tr><tr><td><strong>Card Body</strong></td><td>Toggle <strong>Show on all cards</strong>. Kalau aktif, setiap card punya teks body dan wajib diisi. Kalau dimatikan, tidak ada card yang punya teks body, dan teks yang sudah ditulis akan dihapus dari semua card (Anda diberi peringatan lebih dulu).</td></tr><tr><td><strong>Card Buttons</strong></td><td>Wajib. Pilih jenis tombol lewat <strong>Select button type</strong>, lalu klik <strong>Add button</strong>. Maksimal 2 tombol.</td></tr></tbody></table>

**Jenis tombol**

<table><thead><tr><th width="91.7734375">Jenis</th><th width="170.5390625">Fungsi</th><th width="205.71875">Cara mengisi</th><th></th></tr></thead><tbody><tr><td><strong>Quick Reply</strong></td><td>Customer membalas dengan satu ketukan.</td><td>Label diisi di setiap card.</td><td><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FTPJ1v3LYMTT4XZoRRtfp%2Fimage.png?alt=media&amp;token=c5055fa6-5d17-4ef7-847c-30a5ad9cc006" alt=""></td></tr><tr><td><strong>Visit Website</strong></td><td>Mengarahkan customer ke sebuah website.</td><td><strong>Button Text</strong> dan <strong>Website URL</strong> (base URL) diisi sekali dan sama untuk semua card. Bagian akhir URL (URL tail) diisi per card saat campaign atau saat kirim.</td><td><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2F85EQg8usvU46SWdyAeWY%2Fimage.png?alt=media&amp;token=dacdc504-f962-4f63-8139-ee1e246214c1" alt=""></td></tr><tr><td><strong>Call Phone Number</strong></td><td>Customer memulai panggilan telepon.</td><td><strong>Button Text</strong> dan <strong>Phone Number</strong> diisi sekali dan sama untuk semua card. Tidak ada yang perlu diisi saat campaign atau saat kirim.</td><td><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FBezYDMmWGSUgAMCXo2hp%2Fimage.png?alt=media&amp;token=52de5820-e135-4571-b2de-b1aec68e86ca" alt=""></td></tr></tbody></table>

#### Mengisi Card Carousel

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FkumlizLpKImalPglLs5e%2Fimage.png?alt=media&amp;token=3d412b03-166a-4223-8073-2da5dc101ded" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="156.31640625">Elemen</th><th>Keterangan</th></tr></thead><tbody><tr><td><strong>Tab card</strong></td><td>Klik tab untuk berpindah card. Klik <strong>+</strong> untuk menambah card. Card minimal 2 dan maksimal 10. Geser ikon titik di tab untuk mengubah urutan card.</td></tr><tr><td><strong>Status card</strong></td><td>Setiap tab dan editor card menampilkan <strong>Incomplete</strong> atau <strong>Completed</strong>. Di header form, penghitung seperti <strong>2 cards incomplete</strong> berubah menjadi <strong>All cards completed</strong> setelah semua card lengkap.</td></tr><tr><td><strong>Delete</strong></td><td>Menghapus card yang sedang diedit. Card tidak bisa dikurangi di bawah 2.</td></tr><tr><td><strong>Card Header</strong></td><td>Wajib. Unggah media dengan drag and drop atau klik <strong>Browse</strong>. Media ini bisa diganti lagi saat campaign atau saat kirim.</td></tr><tr><td><strong>Card Body</strong></td><td>Wajib kalau toggle <strong>Show on all cards</strong> aktif. Mendukung <strong>Bold</strong>, <strong>Italic</strong>, <strong>Strikethrough</strong>, dan <strong>Add variable</strong>.</td></tr><tr><td><strong>Card Buttons</strong></td><td>Isi tombol yang diatur per card, misalnya label <strong>Quick Reply</strong>.</td></tr></tbody></table>

#### Mengirim Template ke Meta

Klik **Add Template** setelah semua card lengkap. Template tidak akan dikirim kalau ada aturan yang dilanggar, misalnya jumlah card kurang dari 2, ada card tanpa media, teks body card tidak konsisten di semua card, atau nilai tombol belum diisi. Sistem menyebutkan card atau field yang bermasalah.

Perubahan status template setelah berhasil dikirim ke Meta

* **Pending** menunggu review template oleh Meta
* **Approved** template sudah disetujui oleh Meta dan dapat digunakan untuk Campaign, New Chat, Reopen Chat, dan Send Template
* **Rejected** jika template ditolah oleh Meta

#### Mengedit dan Menghapus Template

* **Edit:** Message Body, teks card, media card, dan nilai tombol bisa diubah. Jumlah card dan Category tidak bisa diubah pada template yang sudah disetujui. Mengedit template yang sudah **Approved** mengembalikannya ke review Meta, dan template tidak bisa dikirim sampai disetujui lagi. Anda diberi tahu hal ini sebelum perubahan disimpan.
* **Delete:** Penghapusan meminta konfirmasi dengan menyebut nama template, dan template ikut dihapus di Meta. Campaign yang sudah selesai memakai template tersebut tetap ada di daftar campaign, tetapi template yang dihapus tidak bisa dipilih lagi untuk pengiriman baru.

***

### Membuat Campaign dengan Template Carousel

Template carousel yang sudah **Approved** bisa dikirim ke satu daftar recipient lewat campaign. Form campaign tetap sama dengan campaign biasa, dengan tambahan pengaturan card setelah template carousel dipilih.

1. Buka **Broadcast Settings > Campaign**, lalu klik **Add Campaign**.
2. Isi **Campaign Name**, **Sender**, **Recipient List**, dan **Label** (opsional).
3. Pilih **Template**. Hanya template Approved yang sesuai dengan channel atau WABA ID **Sender** yang muncul. Template carousel ditandai dengan jumlah card, contoh `testing_carousel (2 cards)`.
4. Lengkapi setiap card (lihat Mengisi Card saat Mengirim).
5. Cek **Preview**.
6. Aktifkan **Set a schedule** kalau campaign ingin dijadwalkan.
7. Cek **Prepaid Balance** dan **Estimated Cost** di footer, lalu klik **Add Campaign**.

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FiHMtUg5lFj7eqSpiFffP%2Fimage.png?alt=media&amp;token=f87ca4e8-016e-4183-87fc-171bcb2f6320" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="140.75390625">Bagian</th><th>Keterangan</th></tr></thead><tbody><tr><td><strong>Message Body Variables</strong></td><td>Muncul kalau Message Body memiliki variabel. Wajib diisi satu nilai per variabel.</td></tr><tr><td><strong>Card Header</strong></td><td>Secara default memakai media dari template. Unggah media lain untuk mengganti media <strong>hanya pada pengiriman ini</strong>. Template tidak berubah.</td></tr><tr><td><strong>Card Body</strong></td><td>Teks card dari template, tampil dalam mode baca saja.</td></tr><tr><td><strong>Card Body Variables</strong></td><td>Wajib diisi satu nilai per variabel di Card Body.</td></tr><tr><td><strong>Card Buttons</strong></td><td><ul><li><strong>Quick Reply</strong>: label tampil dalam mode baca saja.<br><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FXkADg8W2cucSIH2uXISr%2Fimage.png?alt=media&amp;token=785257d5-0b72-4a00-88ce-62a0e662b6cb" alt=""></li><li><strong>Visit Website</strong>: label dan base URL tampil dalam mode baca saja, sedangkan <strong>Website URL</strong> (URL tail) wajib diisi per card dan ditambahkan di akhir base URL. <br><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FNsuJfHGkIJmNv0euGCi0%2Fimage.png?alt=media&amp;token=2d9ee297-b0c8-4c61-a3e4-7048db5e3cc8" alt=""></li><li><strong>Call Phone Number</strong>: label dan nomor tampil dalam mode baca saja, tidak ada yang perlu diisi.<br><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2F4bwRqnXfQIkGpiyew5Ed%2Fimage.png?alt=media&amp;token=987d1f0e-dad1-4a68-9215-02c7e079481b" alt=""></li></ul></td></tr><tr><td><strong>Status card</strong></td><td>Setiap tab menampilkan <strong>Incomplete</strong> atau <strong>Completed</strong>, dan footer menampilkan penghitung seperti <strong>2 cards incomplete</strong> atau <strong>All cards completed</strong>. Pengiriman tidak bisa dilakukan sampai semua card lengkap.</td></tr></tbody></table>

***

### Membuat New Chat dengan Template Carousel

New Chat dipakai untuk memulai percakapan baru ke satu nomor dengan template carousel, tanpa membuat campaign.

1. Di daftar chat, klik ikon plus lalu pilih **Start new chat**.
2. Isi **Name** dan **Phone Number**. Pilih kode negara pada kolom nomor.
3. Pilih **Channel**. Daftar template menyesuaikan channel yang dipilih.
4. Pilih **Template**. Template carousel ditandai dengan jumlah card, contoh `testing_carousel (2 cards)`.
5. Isi **Message Body Variables** kalau ada, lalu lengkapi setiap card (lihat Mengisi Card saat Mengirim).
6. Cek **Preview**, lalu klik **Send**.

Tombol **Send** aktif setelah footer menampilkan **All cards completed**. Percakapan baru dibuat dan pesan carousel dikirim ke nomor tersebut. Pesan muncul di thread percakapan (lihat Tampilan Carousel di Chat Room).

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2Fyg456aSEECHwQ3FxHWnv%2FScreenshot%202026-10-14%20at%2014.34.27.png?alt=media&amp;token=4ff9327c-626b-4a46-88ef-defa925e9eb4" alt=""><figcaption></figcaption></figure>

***

### Reopen Chat dengan Template Carousel

WhatsApp hanya mengizinkan balasan bebas dalam 24 jam setelah pesan terakhir customer. Setelah jendela itu tertutup, composer diganti card **Time Limit Exceeded**, dan percakapan hanya bisa dibuka kembali dengan template.

1. Di chat room, klik **Choose a Template to Reopen Chat** pada card **Time Limit Exceeded**.
2. Pilih template carousel dari daftar template.
3. Isi variabel dan lengkapi setiap card, sama seperti pada New Chat.
4. Cek **Preview**, lalu klik **Send**.

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FqGbwafpHpApip1RXG5ee%2FScreenshot%202026-10-14%20at%2014.37.22.png?alt=media&amp;token=0d818d4b-cf3f-4a37-ac1a-057ecbd0f0d4" alt=""><figcaption></figcaption></figure>

***

### Mengirim Template Carousel dari Chat Room

Selama percakapan masih berjalan, agent bisa mengirim template carousel ke contact yang sedang diajak bicara.

1. Di composer chat room, klik **Template** untuk membuka modal **Send Template**.
2. Pilih template di kolom **Template**. Hanya template Approved untuk channel percakapan tersebut yang ditampilkan, dan template carousel ditandai dengan jumlah card, contoh `carousel_template_satu (3 cards)`.
3. Isi **Message Body Variables** kalau ada, lalu lengkapi setiap card (lihat Mengisi Card saat Mengirim).
4. Cek **Preview**, lalu klik **Send**.

Tombol **Send** nonaktif selama masih ada card yang belum lengkap. Setelah footer menampilkan **All cards completed**, tombol aktif dan pesan carousel terkirim ke contact serta muncul di thread percakapan.

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2F2eKk2YOhIUR22RpCz25Y%2FScreenshot%202026-10-14%20at%2014.37.51.png?alt=media&amp;token=455bf8b3-5970-440d-86d6-7169e61b67a2" alt=""><figcaption></figcaption></figure>

***

### Tampilan Carousel di Chat Room

Carousel yang sudah dikirim, baik lewat campaign, New Chat, Reopen Chat, maupun Send Template, tampil di thread percakapan sebagai pesan keluar.

<table><thead><tr><th width="157.85546875">Elemen</th><th>Keterangan</th></tr></thead><tbody><tr><td><strong>Message Body</strong></td><td>Teks utama pesan, ditampilkan di atas card.</td></tr><tr><td><strong>Card</strong></td><td>Setiap card menampilkan media header (gambar atau video), teks body, dan tombolnya. Geser ke samping untuk melihat card lainnya.</td></tr><tr><td><strong>Info pengiriman</strong></td><td>Di bawah pesan: status pengiriman (contoh: Read), waktu, nama channel, asal pengiriman (contoh: Campaign), serta nama template beserta jumlah card (contoh: <code>testing_carousel (2 cards)</code>).</td></tr></tbody></table>

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2Fhi2ToSPkrPGz07DIudYH%2FScreenshot%202026-10-14%20at%2014.04.23.png?alt=media&amp;token=648411dd-b56e-46bf-bd08-c7cad10dd0a3" alt=""><figcaption></figcaption></figure>

#### Tampilan penuh dan ringkas

Agar thread tidak penuh ketika carousel dipakai sering, pesan carousel punya dua tampilan:

* **Penuh:** card tampil lengkap dan bisa digeser.
* **Ringkas:** pesan diciutkan menjadi satu kartu ringkasan berisi ikon, judul **Carousel Template Sent**, jumlah card, dan nama template.

Ganti tampilan lewat kontrol di atas carousel (contoh: **Hide carousel**) atau dengan mengklik pesannya.

***

### Tampilan Carousel di WhatsApp Customer

Customer menerima satu pesan WhatsApp yang berisi teks utama dan deretan card. Customer menggeser ke samping untuk melihat card lainnya.

<table><thead><tr><th width="250.8359375">Elemen</th><th>Yang dilihat customer</th></tr></thead><tbody><tr><td><strong>Teks utama</strong></td><td>Message Body, tampil di atas card.</td></tr><tr><td><strong>Media</strong></td><td>Gambar atau video di bagian atas setiap card.</td></tr><tr><td><strong>Teks card</strong></td><td>Card Body, dengan variabel yang sudah terisi (contoh: <code>Ini Baju adalah cekat 1</code>).</td></tr><tr><td><strong>Tombol Quick Reply</strong></td><td>Saat diketuk, WhatsApp mengirim balasan berisi label tombol dan mengutip card yang dipilih.</td></tr><tr><td><strong>Tombol Visit Website</strong></td><td>Membuka tautan tujuan, yaitu base URL ditambah URL tail card tersebut.</td></tr><tr><td><strong>Tombol Call Phone Number</strong></td><td>Memulai panggilan ke nomor yang diatur di template.</td></tr></tbody></table>

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FW7bqLHh6aEP8ckeqfIIG%2FUntitled%20design.png?alt=media&amp;token=4cdb4ead-6c98-42e0-ac58-5afef218069f" alt="" width="375"><figcaption></figcaption></figure>

Beberapa catatan:

* Tampilan akhir diatur oleh WhatsApp. Misalnya, WhatsApp bisa menampilkan nama dan domain tujuan di bawah media pada card yang memiliki tombol **Visit Website**, dan media bisa terpotong sesuai ukuran layar.
* Beri label **Quick Reply** yang berbeda di setiap card, misalnya dengan menyebut nama produk. Dengan begitu balasan customer langsung menunjukkan card mana yang dipilih.

***

### Aturan Penting

* **Jumlah card ditentukan saat template dibuat.** Template punya 2 sampai 10 card, dan jumlahnya tidak bisa ditambah atau dikurangi setelah template disetujui Meta.
* **Format header dan tombol harus sama di semua card.** Pilihan **Image** atau **Video**, serta jenis, jumlah, dan urutan tombol, berlaku untuk semua card sekaligus.
* **Card Body berlaku untuk semua card atau tidak sama sekali.** Teks body card tidak bisa aktif hanya di sebagian card.
* **Label, nomor telepon, dan base URL tombol sama di semua card.** Pada tombol **Visit Website** dan **Call Phone Number**, semua card memakai satu set nilai yang sama. Hanya label **Quick Reply** dan URL tail yang berbeda per card.
* **Urutan card hanya bisa diatur di template.** Urutan tidak bisa diubah saat campaign atau saat kirim.
* **Mengedit template yang sudah Approved mengembalikannya ke review Meta.** Template tidak bisa dikirim sampai disetujui lagi.
* **Media pengganti hanya berlaku untuk satu pengiriman.** Saat campaign atau saat kirim, media card bisa diganti, tetapi template tidak berubah.
* **Semua recipient dalam satu campaign menerima isi card yang sama.** Isi card tidak bisa dibedakan per recipient.
* **Template carousel hanya bisa dibuat dari halaman Template Message.** **New Chat**, **Reopen Chat**, dan **Send Template** hanya memilih template yang sudah Approved.
* **Campaign tidak bisa diedit setelah dibuat.**
* **Carousel tidak bisa dikirim ke grup WhatsApp.** **Create Whatsapp Group** bukan jalur pengiriman carousel.
* **Hanya Media Card Carousel yang didukung.** Product Card Carousel tidak didukung.
* **Tampilan akhir diatur oleh WhatsApp.** Media bisa terpotong sesuai ukuran layar, jadi gunakan media berbentuk lebar dan jangan taruh elemen penting di tepi atas atau bawah. WhatsApp juga bisa menampilkan nama dan domain tujuan di bawah media pada card yang memiliki tombol **Visit Website**.
* **Beri label Quick Reply yang berbeda di setiap card.** Misalnya dengan menyebut nama produk, supaya balasan customer langsung menunjukkan card mana yang dipilih.