# 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)

![Quick reply picker](/screenshots/quick-replies.png)

## 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`.

![Halaman quick replies](/screenshots/quick-replies.png)

Pada halaman ini Anda dapat:

- **Tambah** quick reply baru dengan nama pendek (slug), isi teks, dan kategori.
- **Edit** quick reply yang sudah ada.
- **Hapus** quick reply.
- **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`:

```
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:

```
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.

Favorit disimpan per-agent dan muncul di bagian atas picker untuk akses cepat.

## 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](/panduan/agent/catatan-internal).