Copy page

Fitur Utama

Conversation Templates

Conversation template (template percakapan) adalah skrip langkah-demi-langkah yang sudah disiapkan untuk memandu agent menjalankan alur percakapan yang berulang — misalnya onboarding pelanggan baru, verifikasi identitas, atau penanganan komplain standar. Berbeda dari balasan satu kali, sebuah template berisi beberapa langkah (steps) yang dijalankan berurutan.

Rute frontend: /conversation-templates (halaman pengelolaan)

Conversation Templates vs Quick Replies vs WhatsApp Templates

Ketiganya sama-sama "template", tapi peran dan penyimpanannya berbeda. Jangan sampai tertukar:

Aspek	Conversation Template	Quick Reply	WhatsApp Template
Tujuan	Skrip multi-langkah untuk memandu satu alur percakapan	Satu potongan teks balasan standar	Pesan resmi yang disetujui Meta untuk WhatsApp Business
Isi	Array steps (beberapa langkah)	Satu content teks	Body + header/footer + variabel {{1}}, {{2}}
Disetujui Meta?	Tidak	Tidak	Ya — wajib lolos review Meta
Penyimpanan	Tabel conversation_templates	Tabel quick_replies	Tabel wa_templates
Endpoint dasar	/api/conversation-templates	/api/quick-replies	/api/wa-templates

Singkatnya:

• Quick reply = teks tunggal yang Anda sisipkan saat itu juga (lihat Quick Replies).
• WhatsApp template = pesan yang harus disetujui Meta, dipakai untuk memulai percakapan WhatsApp di luar jendela 24 jam.
• Conversation template = panduan internal berisi banyak langkah agar agent menjalankan alur yang konsisten. Tidak dikirim sebagai satu pesan resmi dan tidak butuh persetujuan Meta.

Struktur sebuah template

Setiap template tersimpan di tabel PostgreSQL conversation_templates dengan field berikut:

Field	Tipe	Keterangan
name	teks	Wajib. Nama template (akan ditolak jika kosong).
description	teks	Opsional. Penjelasan singkat kegunaan template.
category	teks	Opsional. Pengelompokan, mis. onboarding, support.
steps	JSON array	Daftar langkah. Disimpan apa adanya sebagai JSONB.
is_active	boolean	Default true. Nonaktifkan tanpa menghapus.

steps adalah array JSON bebas — backend menyimpannya tanpa memaksakan skema langkah tertentu. Pada form pengelolaan, kolom Steps (JSON) diedit langsung sebagai teks JSON.

Membuat template

1. Buka halaman /conversation-templates.
2. Klik New Template.
3. Isi Name (wajib).
4. Isi Category bila perlu (mis. onboarding, support).
5. Isi Description singkat.
6. Pada kolom Steps (JSON), masukkan array langkah dalam format JSON.
7. Klik Create.

Contoh isi kolom Steps (JSON):

Code
[
  { "type": "message", "text": "Halo {{contact.first_name}}, selamat datang di OmniStream." },
  { "type": "message", "text": "Boleh saya minta nomor pesanan Anda untuk verifikasi?" },
  { "type": "message", "text": "Terima kasih, sedang saya cek sekarang." }
]

Permintaan yang dikirim ke API kira-kira seperti ini:

Code
POST /api/conversation-templates
Authorization: Bearer <JWT>
Content-Type: application/json

{
  "name": "Onboarding Pelanggan Baru",
  "category": "onboarding",
  "description": "Alur sambutan untuk kontak yang baru pertama kali chat",
  "steps": [
    { "type": "message", "text": "Halo {{contact.first_name}}!" }
  ],
  "is_active": true
}

Variabel / placeholder

Field steps adalah teks bebas, jadi Anda bisa menulis placeholder di dalam teks langkah sebagai pengingat data yang perlu diisi, misalnya {{contact.first_name}} atau {{order.id}}.

Kategori

category adalah label teks opsional untuk mengelompokkan template (mis. onboarding, support, billing).

• Saat membuat/mengedit, isi kolom Category dengan teks bebas.
• Daftar template dapat difilter per kategori lewat parameter category pada endpoint list. Filter menggunakan kecocokan persis (exact match), jadi konsistenlah dalam penamaan (mis. selalu support, bukan kadang Support).

Code
GET /api/conversation-templates?category=onboarding

Anda juga dapat memfilter berdasarkan status aktif:

Code
GET /api/conversation-templates?is_active=true

Mengaktifkan / menonaktifkan

Setiap template punya flag is_active. Menonaktifkan template (is_active: false) menyembunyikannya dari penggunaan tanpa menghapus datanya — berguna untuk skrip musiman atau yang sedang direvisi. Pada daftar, status ditampilkan lewat ikon toggle (hijau = aktif).

Memakai di inbox

Conversation template berfungsi sebagai panduan alur: agent membuka template, lalu menjalankan langkah-langkahnya satu per satu di percakapan. Untuk setiap langkah, ketik (atau salin) teksnya ke kotak input di inbox, ganti placeholder bila ada, lalu kirim.

Pola kerja khas:

1. Buka percakapan dari inbox.
2. Buka template yang relevan dari /conversation-templates.
3. Jalankan Step 1 → ketik/salin teksnya, ganti placeholder, Send.
4. Lanjut ke step berikutnya sesuai respons pelanggan.
5. Selesaikan seluruh langkah hingga alur tuntas.

Mengelola template (endpoint)

Aksi	Endpoint
List template	GET /api/conversation-templates
Detail template	GET /api/conversation-templates/{id}
Buat template	POST /api/conversation-templates
Ubah template	PATCH /api/conversation-templates/{id}
Hapus template	DELETE /api/conversation-templates/{id}

Skema lengkap request/response ada di API Reference.

Praktik terbaik

• Beri nama yang jelas sesuai alurnya (mis. "Verifikasi Pesanan", bukan "Template 1").
• Kelompokkan dengan kategori yang konsisten agar mudah difilter.
• Tulis langkah seringkas mungkin; satu langkah = satu pesan.
• Tandai placeholder dengan format yang seragam (mis. {{...}}) agar agent ingat mana yang harus diganti manual.
• Nonaktifkan template lama lewat is_active daripada langsung menghapus, supaya riwayat tetap ada.

Baca juga: Quick Replies · Inbox.