> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dripsender.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Chat AI

> Solusi untuk masalah umum yang ditemui saat menggunakan Chat AI DripSender

Temukan solusi cepat untuk masalah yang paling sering ditemui saat menggunakan Chat AI DripSender.

***

## Masalah Umum & Solusi

### 🔌 Aktivasi & Koneksi

<AccordionGroup>
  <Accordion title="Chat AI tidak merespons sama sekali" icon="circle-xmark">
    **Cek urutan berikut:**

    1. **Toggle Chat AI aktif?** — Pastikan toggle "Chat AI" di bagian atas halaman dalam posisi **ON**
    2. **WhatsApp terhubung?** — Cek status device di menu WhatsApp > Device
    3. **Token tersedia?** — Cek saldo token di halaman Chat AI. Jika kosong, beli token terlebih dahulu
    4. **Activation Mode sesuai?** — Jika mode "Using Keyword", pesan harus diawali keyword yang benar
    5. **Nomor di Exclude List?** — Pastikan nomor test tidak masuk dalam exclude list
    6. **Engine V2: Reindex sudah dilakukan?** — Jika menggunakan V2, Reindex wajib setelah setup awal
  </Accordion>

  <Accordion title="Chat AI aktif tapi respons sangat lambat (>30 detik)" icon="clock">
    **Kemungkinan penyebab:**

    * **Reindex sedang berjalan** — Tunggu proses reindex selesai sebelum test
    * **Context length terlalu tinggi** — Turunkan context length di AI Response Settings (coba 5-10 pesan)
    * **File training data terlalu banyak/besar** — Optimasi, gunakan maksimal 5 file dengan total *20MB*
    * **Website sync sedang berjalan** — Tunggu proses sync selesai
    * **Menggunakan Engine V2** — V2 sedikit lebih lambat tapi lebih hemat token

    <Tip>
      Untuk respons lebih cepat, gunakan Engine V1 atau turunkan context length menjadi 5-8 pesan.
    </Tip>
  </Accordion>

  <Accordion title="AI aktif tapi hanya respons di personal chat, tidak di grup" icon="users">
    **Cek pengaturan:**

    * Buka tab **General** > **Scope Chat AI**
    * Set ke **All** atau **Group** sesuai kebutuhan
    * Jika sudah All/Group tapi masih tidak bekerja: cek apakah grup tersebut ada di **Exclude List**
  </Accordion>

  <Accordion title="Toggle Chat AI tidak bisa diaktifkan (greyed out)" icon="toggle-off">
    **Syarat yang belum terpenuhi:**

    <Check>Token AI harus tersedia minimal beberapa unit</Check>
    <Check>WhatsApp device harus terhubung (status Connected)</Check>
    <Check>Konfigurasi General sudah disimpan (klik Save)</Check>
    <Check>Company Name sudah diisi</Check>
  </Accordion>
</AccordionGroup>

***

### 📚 Training Data & Respons AI

<AccordionGroup>
  <Accordion title="AI memberikan informasi yang salah atau tidak akurat" icon="triangle-exclamation">
    **Penyebab paling umum:**

    1. **Data di training tidak akurat** — Periksa dan koreksi informasi di Training Data
    2. **AI "halusinasi"** — Tambahkan instruksi di AI Behaviour: `"Jika tidak ada informasi di training data, katakan tidak tahu dan jangan mengarang jawaban"`
    3. **Informasi duplikat/kontradiktif** — Cari dan hilangkan informasi yang saling bertentangan
    4. **Reindex belum dilakukan** — Jika menggunakan Engine V2, klik **Reindex** setelah update training data
    5. **Training data tidak terstruktur** — Gunakan heading dan format yang jelas

    ```
    # Tambahkan ke AI Behaviour:
    # BATASAN
    - JANGAN mengarang informasi yang tidak ada di training data
    - Jika tidak tahu: "Maaf, saya tidak memiliki informasi mengenai hal tersebut.
      Silakan hubungi tim kami di [kontak] untuk informasi lebih lanjut."
    ```
  </Accordion>

  <Accordion title="AI tidak bisa membaca file yang sudah diupload" icon="file-xmark">
    **Cek status file:**

    1. Status harus **Completed** (bukan Pending/Processing/Failed)
    2. Jika status **Failed**: hapus dan upload ulang file
    3. Pastikan format file adalah **PDF atau DOCX** (bukan .txt, .xlsx, dll)
    4. Pastikan ukuran file **di bawah 5MB**
    5. Setelah upload berhasil, wajib klik **Reindex**

    <Warning>
      File Training Data hanya dapat digunakan dengan **Engine V2**. Jika menggunakan V1, berdampak pada fitur ini tidak tersedia.
    </Warning>
  </Accordion>

  <Accordion title="Website Sync tidak berjalan / konten tidak terupdate" icon="rotate">
    **Langkah troubleshoot:**

    1. **Website bisa diakses publik?** — Buka URL website di browser incognito. Jika tidak bisa diakses (butuh login/VPN), Website Sync tidak akan berhasil
    2. **URL sudah benar?** — Pastikan menyertakan `https://` dan tidak ada trailing slash yang berlebihan
    3. **Sync Type sesuai?** — Gunakan "Single Page" untuk halaman spesifik, "All Pages" untuk seluruh domain
    4. **Trigger manual sync** — Klik tombol sync ulang secara manual
    5. **Lakukan Reindex** setelah sync selesai
  </Accordion>

  <Accordion title="AI mengabaikan instruksi di AI Behaviour" icon="sliders">
    **Kemungkinan penyebab:**

    * **Instruksi terlalu ambigu** — Buat lebih spesifik dan gunakan contoh konkret
    * **Instruksi kontradiktif** — Periksa apakah ada instruksi yang saling bertentangan
    * **AI Behaviour terlalu panjang** — Fokus pada 5-7 instruksi paling penting, hapus yang tidak kritis
    * **Training data override behaviour** — Informasi di training data mungkin konflik dengan instruksi behaviour

    <Tip>
      Gunakan kata-kata tegas di AI Behaviour: `SELALU`, `JANGAN`, `WAJIB` untuk instruksi yang kritikal.
    </Tip>
  </Accordion>

  <Accordion title="AI menjawab pertanyaan di luar topik bisnis" icon="compass">
    **Tambahkan batasan di AI Behaviour:**

    ```
    # BATASAN
    - HANYA jawab pertanyaan yang berkaitan dengan [nama bisnis] dan layanan kami
    - Jika ada pertanyaan di luar topik (cuaca, politik, gosip, dll):
      "Maaf, saya hanya bisa membantu pertanyaan seputar [nama bisnis].
       Ada yang bisa saya bantu terkait produk/layanan kami?"
    ```
  </Accordion>

  <Accordion title="AI tidak mengenali produk/jasa yang sudah diinput" icon="box">
    **Cek hal berikut:**

    1. **Engine V2:** Pastikan sudah klik **Reindex** setelah menambahkan produk
    2. **Format training data** — Gunakan heading yang jelas seperti `# PRODUK` atau `# LAYANAN`
    3. **Informasi lengkap** — Pastikan nama produk, deskripsi, dan harga jelas tertulis
    4. **Contoh pertanyaan** — Tambahkan contoh pertanyaan dan jawaban di training data

    ```
    # PRODUK
    ## Nama Produk
    - Harga: Rp XXX.XXX
    - Deskripsi: [detail produk]
    - Fitur: [fitur utama]
    ```
  </Accordion>
</AccordionGroup>

***

### 🛒 Merchant Mode

<AccordionGroup>
  <Accordion title="Produk tidak muncul saat pelanggan tanya katalog" icon="box-open">
    **Cek urutan:**

    1. **Merchant Mode aktif?** — Toggle harus dalam posisi ON
    2. **Produk sudah ditambahkan?** — Cek di **Merchant** > **Pengaturan** > **Daftar Produk**
    3. **Stok produk = 0?** — Produk dengan stok 0 tidak akan ditawarkan AI. Update stok
    4. **Merchant Type sesuai?** — Pastikan tipe produk (fisik/digital) sesuai dengan merchant type yang dipilih
    5. **Badge "Tidak Didukung"?** — Edit produk dan pastikan tipe produk sesuai dengan merchant type
  </Accordion>

  <Accordion title="Ongkos kirim tidak terhitung / selalu 0" icon="truck">
    **Checklist shipping:**

    <Check>Origin data (kota asal) sudah diatur di Shipping Configuration</Check>
    <Check>Berat produk sudah diisi (dalam gram, angka > 0, termasuk kemasan)</Check>
    <Check>Minimal 1 kurir sudah dipilih</Check>
    <Check>Merchant Type diatur ke "Produk Fisik" atau "Kombinasi"</Check>
    <Check>Alamat tujuan pelanggan sudah diinput dalam format yang bisa dipahami sistem</Check>
  </Accordion>

  <Accordion title="Order dibuat tapi status tidak berubah ke Paid" icon="credit-card">
    **Untuk Manual Transfer:**

    * Konfirmasi pembayaran harus dilakukan secara manual oleh admin
    * Masuk ke **Merchant** > **Pesanan** > klik **"Tandai Dibayar"**

    **Untuk Payment Gateway:**

    * Payment Gateway masih dalam mode **Sandbox** — tidak ada uang yang diproses secara nyata
    * Untuk production, hubungi DripSender untuk aktivasi
  </Accordion>

  <Accordion title="Badge 'Tidak Didukung' muncul di produk" icon="ban">
    Terjadi ketika jenis produk tidak sesuai dengan merchant type.

    **Solusi:**

    * Buka produk tersebut > edit tipe produk
    * Atau ubah Merchant Type di pengaturan agar mendukung jenis produk tersebut
  </Accordion>

  <Accordion title="Pelanggan tidak bisa melakukan checkout" icon="cart-shopping">
    **Cek konfigurasi:**

    1. **Payment method aktif?** — Pastikan minimal 1 metode pembayaran diaktifkan
    2. **Data kontak lengkap?** — Pelanggan harus mengisi nama dan kontak
    3. **Alamat lengkap?** — Untuk produk fisik, alamat pengiriman harus lengkap
    4. **Stok masih tersedia?** — Cek apakah stok produk masih ada
  </Accordion>
</AccordionGroup>

***

### 💰 Token & Billing

<AccordionGroup>
  <Accordion title="Token habis lebih cepat dari perkiraan" icon="coins">
    **Faktor yang mempengaruhi konsumsi token:**

    | Faktor                          | Dampak       | Solusi                           |
    | ------------------------------- | ------------ | -------------------------------- |
    | Context length tinggi           | Token boros  | Turunkan ke 5-10 pesan           |
    | Response length panjang         | Token boros  | Turunkan ke 500-1000 karakter    |
    | Banyak percakapan pendek        | Normal       | Gunakan Chatbot Limit            |
    | Engine V1 vs V2                 | V2 hemat 40% | Migrasi ke V2                    |
    | Nomor test tidak di-exclude     | Buang token  | Tambahkan ke Exclude List        |
    | Training data tidak terstruktur | Token boros  | Gunakan heading dan format jelas |

    **Tips optimasi:**

    * Gunakan Engine V2 untuk hemat 40%
    * Set Chatbot Limit: 30-50 respons/hari per kontak
    * Exclude nomor internal dan test
  </Accordion>

  <Accordion title="Pembelian token tidak masuk ke akun" icon="receipt">
    1. Cek email konfirmasi pembayaran
    2. Tunggu 5-15 menit (proses otomatis)
    3. Refresh halaman Chat AI
    4. Jika lebih dari 30 menit dan belum masuk: hubungi support DripSender dengan bukti pembayaran
  </Accordion>
</AccordionGroup>

***

### 🔄 Fallback & Handover

<AccordionGroup>
  <Accordion title="Fallback handover tidak terjadi meski AI tidak bisa menjawab" icon="user-headset">
    **Cek konfigurasi:**

    1. Toggle Fallback Handover sudah **ON**?
    2. **Admin number sudah diisi** dengan format yang benar (628xxxxxxxx)?
    3. Nomor admin sendiri ada di **Exclude List**? Jika ya, AI tidak akan kirim notifikasi ke nomor tersebut
    4. **Template pesan handover** sudah diatur?

    <Note>
      Handover terjadi ketika AI benar-benar tidak bisa menjawab setelah mencoba. Jika AI memberikan jawaban default/umum, handover tidak akan terpicu.
    </Note>
  </Accordion>

  <Accordion title="Mau pause AI untuk satu percakapan tanpa mematikan AI secara global" icon="pause">
    Gunakan fitur **Pause AI** dengan keyword:

    1. Buka tab **General** > **Pause AI**
    2. Tambahkan pause keyword (contoh: "pause", "stop ai", "hubungkan admin")
    3. Untuk resume: gunakan resume keyword (contoh: "resume", "lanjutkan")

    Atau aktifkan **"Disable Chatbot"** untuk kontak tertentu melalui tab History.
  </Accordion>

  <Accordion title="Admin tidak menerima notifikasi handover" icon="bell">
    **Cek hal berikut:**

    1. **Nomor admin benar?** — Format: 628xxxxxxxx (tanpa + atau spasi)
    2. **Nomor tidak di Exclude List?** — Jika admin ada di Exclude List, notifikasi tidak terkirim
    3. **Template pesan tidak kosong?** — Pastikan template handover diisi
    4. **WhatsApp device aktif?** — Cek status koneksi device
  </Accordion>
</AccordionGroup>

***

### ⚙️ Advanced Settings

<AccordionGroup>
  <Accordion title="Human Tone tidak berfungsi" icon="face-smile">
    **Cek pengaturan:**

    1. Human Tone sudah diaktifkan di tab **Advanced**?
    2. **Tone Style** sudah dipilih? (Professional, Casual, dll)
    3. **Temperature** diatur dengan benar? (0.7-1.0 untuk lebih kreatif)
    4. Jika menggunakan Engine V1, coba migrasi ke **Engine V2**
  </Accordion>

  <Accordion title="AI Vision / AI Whisper tidak bekerja" icon="eye">
    **Cek konfigurasi:**

    1. **AI Sensory Pack** aktif di tab Advanced?
    2. **Vision Enabled** dan/atau **Whisper Enabled** dalam posisi ON?
    3. Untuk Vision: pastikan gambar yang dikirim pelanggan jelas dan tidak blur
    4. Untuk Whisper: pastikan voice note tidak terlalu panjang (max 1-2 menit)

    <Note>
      AI Vision dan Whisper membutuhkan token tambahan untuk pemrosesan.
    </Note>
  </Accordion>

  <Accordion title="Structured Reply tidak berfungsi" icon="list-ul">
    **Cek pengaturan:**

    1. Structured Reply aktif di tab **Advanced**?
    2. **Max Bubble** diatur minimal 2?
    3. **Max Char Length** tidak terlalu tinggi?
    4. **Delay Per Message** diatur dengan benar (dalam ms)?
    5. Format media benar? Gunakan: `[[media=ID_MEDIA]]`
  </Accordion>
</AccordionGroup>

***

## Diagnosis Cepat

Gunakan checklist ini saat mengalami masalah:

```
⬜ Toggle Chat AI = ON
⬜ WhatsApp = Connected (status device)
⬜ Token > 0
⬜ Training Data sudah di-Save
⬜ AI Behaviour sudah di-Save
⬜ Untuk Engine V2: Reindex sudah dilakukan
⬜ Nomor yang bermasalah bukan di Exclude List
⬜ Activation Mode sesuai (All Messages / Using Keyword)
⬜ Scope sesuai (All / Personal / Group)
⬜ Company Name sudah diisi
⬜ Admin Number (untuk handover) format benar: 628xxxxxxxx
```

***

## Butuh Bantuan Lebih Lanjut?

Jika masalah tidak ditemukan di sini:

<CardGroup cols={2}>
  <Card title="Lihat FAQ" icon="circle-question" href="/chat-ai/faq">
    Pertanyaan umum tentang Chat AI
  </Card>

  <Card title="Lihat Best Practices" icon="star" href="/chat-ai/best-practices">
    Tips optimalisasi performa Chat AI
  </Card>

  <Card title="WhatsApp Support" icon="whatsapp">
    Chat langsung dengan tim DripSender
    **0813-7388-7727**
  </Card>

  <Card title="Email Support" icon="envelope">
    Kirim detail masalah + screenshot
    **[support@dripsender.com](mailto:support@dripsender.com)**
  </Card>
</CardGroup>

<Tip>
  Saat menghubungi support, sertakan: **nama akun**, **deskripsi masalah**, **langkah yang sudah dicoba**, dan **screenshot** jika ada pesan error.
</Tip>