Copy page

Agent

Quick Replies

Quick Replies

Quick replies adalah balasan teks yang sering Anda gunakan (salam, terima kasih, permintaan maaf standar) yang dapat Anda sisipkan ke pesan dengan satu perintah. Alih-alih mengetik ulang, Anda cukup mengetik / diikuti nama quick reply dan menekan Enter.

Rute frontend: /inbox (ikon Zap di kotak input), /quick-replies (halaman pengelolaan)

Ringkasan

Setiap workspace memiliki daftar quick reply bersama. Agent dapat menggunakan, menandai favorit, dan (jika diizinkan) membuat quick reply baru. Daftar master tersimpan di tabel PostgreSQL quick_replies dan favorit per-agent di agent_favorite_replies.

Menggunakan quick reply saat mengetik pesan

Mode picker (ikon Zap)

1. Buka percakapan dari inbox.
2. Klik ikon Zap di kiri textarea input.
3. Daftar quick reply muncul di atas kotak input.
4. Ketik di kotak pencarian untuk mem-filter berdasarkan nama.
5. Klik quick reply yang diinginkan — isi teks akan muncul di textarea.
6. Edit bila perlu, lalu klik Send.

Mode slash (/)

1. Di kotak input, ketik karakter / sebagai karakter pertama.
2. Daftar quick reply yang cocok muncul di atas kursor.
3. Gunakan panah atas/bawah untuk memilih.
4. Tekan Enter untuk menyisipkan.
5. Edit bila perlu, lalu kirim.

Mode slash lebih cepat untuk agent yang sudah hafal nama quick reply. Mode picker lebih ramah untuk agent baru yang masih menjelajah pilihan.

Mengelola quick reply

Untuk membuat, mengedit, atau menghapus quick reply, buka halaman /quick-replies.

Pada halaman ini Anda dapat:

• Tambah quick reply baru dengan nama pendek (slug), isi teks, dan kategori. Endpoint: POST /api/quick-replies.
• Edit quick reply yang sudah ada: PATCH /api/quick-replies/{id}.
• Hapus quick reply: DELETE /api/quick-replies/{id}.
• Tandai favorit dengan ikon bintang — favorit Anda akan muncul di bagian atas picker di inbox.
• Filter berdasarkan kategori (sales, support, billing, dll).

Catatan: Hanya peran Admin atau Supervisor yang dapat menghapus quick reply milik workspace. Agent reguler dapat membuat quick reply baru, mengedit miliknya sendiri, dan menandai favorit.

Variabel template

Quick reply mendukung variabel sederhana yang akan diganti saat pesan dikirim:

Variabel	Ganti menjadi
{{contact.name}}	Nama kontak pelanggan
{{contact.first_name}}	Nama depan pelanggan
{{agent.name}}	Nama agent yang sedang login
{{now.date}}	Tanggal hari ini (YYYY-MM-DD)

Contoh isi quick reply /salam:

Code
Halo {{contact.first_name}}, saya {{agent.name}} dari OmniStream.
Ada yang bisa saya bantu hari ini?

Saat Anda menyisipkan /salam pada percakapan dengan kontak bernama "Budi Santoso", teks akan menjadi:

Code
Halo Budi, saya Siti dari OmniStream.
Ada yang bisa saya bantu hari ini?

Favorit agent

Setiap agent dapat menandai hingga 20 quick reply sebagai favorit. Favorit disimpan per-agent dan muncul di bagian atas picker untuk akses cepat.

• Tambah favorit: klik ikon bintang pada halaman /quick-replies atau di dalam picker.
• Hapus favorit: klik ikon bintang sekali lagi.

Endpoint yang dipanggil: POST /api/agents/me/favorite-replies dan DELETE /api/agents/me/favorite-replies/{quick_reply_id}.

Praktik terbaik

• Gunakan slug pendek dan mudah diingat (/tq, /salam, /cek).
• Kelompokkan berdasarkan kategori supaya pencarian cepat.
• Tinjau ulang daftar quick reply setiap kuartal — buang yang jarang dipakai.
• Untuk balasan dengan data yang selalu sama (jam operasional, alamat), quick reply lebih efisien daripada mengetik ulang.

Langkah kerja khas

1. Buka percakapan.
2. Ketik / untuk memanggil daftar.
3. Pilih /salam → tekan Enter.
4. Tambahkan informasi spesifik bila perlu.
5. Klik Send.

Baca selanjutnya: Catatan internal.