kirem.coDokumentasi API
Dokumentasi/Recipes/Resep: Membangun Bot WhatsApp dengan n8n
Recipes

Resep: Membangun Bot WhatsApp dengan n8n

Ringkasan Teknis (TL;DR)

Panduan membangun chatbot WhatsApp otomatis menggunakan n8n workflow automation dan Kirem node.

#recipes#n8n#bot#automation#chatbot

Resep: Membangun Bot WhatsApp dengan n8n

Panduan ini akan membantu Anda membangun chatbot WhatsApp otomatis tanpa menulis kode, menggunakan n8n workflow automation dan Kirem node. Bot akan menerima pesan masuk, mencocokkan kata kunci, dan membalas secara otomatis.


๐ŸŽฏ Yang Akan Anda Capai

Setelah mengikuti panduan ini:

  • Bot WhatsApp yang dapat menerima pesan pelanggan secara real-time
  • Balasan otomatis berdasarkan kata kunci (misal: "Halo" โ†’ pesan sambutan)
  • Workflow visual yang dapat dikustomisasi tanpa coding

๐Ÿ“‹ Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  • n8n instance โ€” bisa self-hosted di server Anda atau gunakan n8n.cloud
  • Kirem node terinstal di n8n (lihat Langkah 1)
  • API Key Kirem (live key) โ€” dapatkan dari Dasbor Kirem
  • Webhook URL publik โ€” agar Meta dapat mengirimkan pesan masuk ke n8n Anda (gunakan ngrok untuk development lokal)
  • Nomor WhatsApp terdaftar di Kirem yang sudah aktif

๐Ÿ”ง Langkah 1: Instal Kirem Community Node di n8n

  1. Buka n8n instance Anda
  2. Masuk ke Settings > Community Nodes
  3. Klik Install a community node
  4. Masukkan nama package: n8n-nodes-kirem (atau nama package Kirem node yang tersedia)
  5. Klik Install dan tunggu proses selesai

Setelah terinstal, node Kirem akan muncul di panel node sebelah kiri.


๐Ÿ”ง Langkah 2: Buat Webhook Trigger Node

Webhook Trigger akan menerima pesan masuk dari Kirem.

  1. Tambahkan node Webhook ke canvas

  2. Konfigurasi:

    • HTTP Method: POST
    • Path: /whatsapp-bot
    • Response Mode: Last Node
    • Response Data: All Entries
  3. Klik Execute Node untuk mengaktifkan webhook

  4. Salin Production URL yang muncul (contoh: https://your-n8n.example.com/webhook/whatsapp-bot)

Konfigurasi Webhook di Dasbor Kirem

  1. Buka Dasbor Kirem > Webhooks
  2. Tambahkan webhook baru dengan URL production n8n Anda
  3. Verifikasi webhook (Kirem akan mengirimkan challenge)

๐Ÿ”ง Langkah 3: Tambahkan Node Switch untuk Pencocokan Kata Kunci

  1. Tambahkan node Switch setelah Webhook
  2. Konfigurasi:
    • Mode: Rules
    • Input: {{ $json.body.entry[0].changes[0].value.messages[0].text.body }} (path ke isi pesan)
    • Tambahkan aturan (rules):
Aturan Operator Nilai Output
contains Halo 1 (Sambutan)
contains Hai 1 (Sambutan)
contains or matches Harga 2 (Harga)
contains or matches Bantuan 3 (Bantuan)
contains or matches Jam 4 (Jam Operasional)

๐Ÿ”ง Langkah 4: Tambahkan Node Kirem untuk Membalas

Untuk setiap output Switch, tambahkan node Kirem:

Output 1 โ€” Balasan Sambutan "Halo/Hai"

  1. Tambahkan node Kirem setelah output 1 Switch
  2. Konfigurasi:
    • Resource: Message
    • Operation: Send
    • Phone Number ID: (ID nomor WhatsApp Anda dari Dasbor Kirem)
    • To: {{ $json.body.entry[0].changes[0].value.messages[0].from }}
    • Message Type: Text
    • Body:
      Halo! ๐Ÿ‘‹ Selamat datang di layanan kami.
      
      Berikut yang bisa saya bantu:
      - Ketik *Harga* untuk info produk & harga
      - Ketik *Bantuan* untuk bantuan pelanggan
      - Ketik *Jam* untuk jam operasional
      

Output 2 โ€” Balasan Info Harga

  1. Tambahkan node Kirem setelah output 2 Switch
  2. Konfigurasi:
    • To: {{ $json.body.entry[0].changes[0].value.messages[0].from }}
    • Message Type: Text
    • Body:
      ๐Ÿ“‹ Daftar Harga Produk Kami:
      
      - Paket Basic: Rp 99.000/bulan
      - Paket Pro: Rp 249.000/bulan
      - Paket Enterprise: Rp 499.000/bulan
      
      Kunjungi https://kirem.co.id/harga untuk detail lengkap!
      

Output 3 โ€” Balasan Bantuan

  1. Tambahkan node Kirem setelah output 3 Switch
  2. Isi body dengan informasi kontak support Anda

Output 4 โ€” Balasan Jam Operasional

  1. Tambahkan node Kirem setelah output 4 Switch
  2. Isi body dengan jam operasional bisnis Anda

๐Ÿ”ง Langkah 5: Tambahkan Fallback untuk Pesan Tidak Dikenal

Tambahkan satu node Kirem lagi untuk menangani pesan yang tidak cocok dengan kata kunci apa pun:

  1. Sambungkan output Fallback Switch ke node Kirem baru
  2. Konfigurasi:
    {
      "body": "Maaf, saya belum mengerti pesan Anda. Ketik *Bantuan* untuk melihat menu yang tersedia."
    }
    

๐Ÿ“ฆ Struktur Workflow Lengkap

[Webhook Trigger]
      โ”‚
      โ–ผ
[Switch โ€” Pencocokan Kata Kunci]
      โ”‚
      โ”œโ”€โ”€ Output 1: "Halo/Hai" โ”€โ”€โ–ถ [Kirem: Balasan Sambutan]
      โ”œโ”€โ”€ Output 2: "Harga"    โ”€โ”€โ–ถ [Kirem: Info Harga]
      โ”œโ”€โ”€ Output 3: "Bantuan"  โ”€โ”€โ–ถ [Kirem: Bantuan]
      โ”œโ”€โ”€ Output 4: "Jam"      โ”€โ”€โ–ถ [Kirem: Jam Operasional]
      โ””โ”€โ”€ Fallback             โ”€โ”€โ–ถ [Kirem: Pesan Tidak Dikenal]

๐Ÿงช Uji Coba

  1. Aktifkan workflow di n8n (toggle Active)
  2. Kirim pesan WhatsApp ke nomor bisnis Anda:
    • Kirim "Halo" โ†’ bot membalas dengan pesan sambutan
    • Kirim "Harga" โ†’ bot membalas dengan daftar harga
    • Kirim "Tes" โ†’ bot membalas dengan pesan fallback
  3. Periksa Executions di n8n untuk melihat log workflow

๐ŸŽจ Kustomisasi Lanjutan

Menambahkan Tombol Interaktif (Quick Reply)

Alih-alih teks biasa, gunakan pesan interaktif:

{
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": {
      "text": "Halo! Apa yang bisa saya bantu?"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "harga",
            "title": "๐Ÿ’ฐ Harga"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "bantuan",
            "title": "๐Ÿ†˜ Bantuan"
          }
        }
      ]
    }
  }
}

Menyimpan Data Pelanggan ke Database

Tambahkan node Google Sheets atau PostgreSQL setelah Webhook untuk mencatat setiap interaksi:

  • Nomor telepon pelanggan
  • Isi pesan
  • Waktu pesan diterima
  • Balasan yang dikirim

Menambahkan AI/NLP

Gunakan node OpenAI untuk memproses bahasa alami sehingga bot dapat memahami maksud pelanggan tanpa pencocokan kata kunci eksak.


โš ๏ธ Catatan Penting

  • Pastikan URL webhook n8n Anda dapat diakses publik. Untuk development lokal, gunakan ngrok: ngrok http 5678
  • Jangan lupa mengaktifkan workflow (toggle Active) setelah selesai konfigurasi
  • WhatsApp membatasi balasan dalam jendela 24 jam. Untuk membalas pesan di luar jendela, gunakan templat yang sudah disetujui
  • Gunakan node Wait jika Anda perlu jeda antar pesan (rate limiting)

Butuh bantuan integrasi lanjutan?

Hubungi tim developer Kirem melalui tiket bantuan.

Buka Tiket Bantuan