Integrasi

Integrasi n8n

Copy page

Hubungkan KirimChat dengan n8n untuk membuat workflow automation yang powerful. Kirim pesan otomatis, sinkronisasi data, dan buat chatbot dengan visual workflow builder.

Instalasi

Install dari Community Nodes

1. Buka n8n dashboard
2. Pergi ke Settings > Community Nodes
3. Klik Install
4. Masukkan nama package:

Code
 
@kichat/n8n-nodes-kirimchat

5. Konfirmasi instalasi

Setup Credentials

1. Di n8n, buka Credentials
2. Klik Add Credential
3. Cari KirimChat API
4. Masukkan:
   • API Key: Key dari dashboard KirimChat (format kc_live_xxx)
   • API Base URL: https://api-prod.kirim.chat/api/v1/public (default)
5. Klik Save

Operasi yang Tersedia

KirimChat node menyediakan 6 operasi utama:

Operasi	Deskripsi
Send Message	Kirim pesan ke customer via WhatsApp, Instagram, atau Messenger
List Templates	Ambil daftar template WhatsApp
Get Template	Ambil detail template tertentu
Mark as Read	Tandai pesan sebagai sudah dibaca
Send Typing Indicator	Kirim indikator typing ke customer
Get Message Status	Cek status pengiriman pesan

Send Message

Kirim pesan ke customer melalui berbagai channel dan tipe pesan.

Identifikasi Customer

Pilih salah satu metode untuk mengidentifikasi penerima:

Metode	Contoh	Keterangan
Customer ID	cust_abc123	ID unik customer dari KirimChat
Phone Number	628123456789	Nomor telepon (format internasional)
Instagram Username	johndoe	Username Instagram customer

Channel & Tipe Pesan

WhatsApp

Tipe Pesan	Parameter	Keterangan
Text	content	Pesan teks biasa
Image	media_url, caption	Gambar (JPEG, PNG, max 5MB)
Document	media_url, filename, caption	Dokumen (PDF, DOC, max 100MB)
Audio	media_url	Audio (MP3, OGG, max 16MB)
Video	media_url, caption	Video (MP4, max 16MB)
Template	template	Template yang sudah di-approve Meta
Interactive	interactive	Tombol, list menu, atau CTA URL

Instagram

Tipe Pesan	Parameter	Keterangan
Text	content	Pesan teks
Image	media_url	Gambar (JPEG, PNG)
Media Share	media_url	Share media

Messenger

Tipe Pesan	Parameter	Keterangan
Text	content	Pesan teks
Image	media_url	Gambar (JPEG, PNG, GIF)
Video	media_url	Video (MP4)
Audio	media_url	Audio (MP3, WAV)
File	media_url, filename	File apapun

Template Message

Untuk mengirim template WhatsApp:

1. Mode Dropdown - Pilih template dari daftar yang sudah di-approve

   • Template otomatis dimuat dari akun Anda
   • Jumlah variable ditampilkan (contoh: [2 var])
   • Isi setiap variable ({{1}}, {{2}}, dst.)

2. Mode Manual - Masukkan nama dan bahasa template secara manual

   • Template Name: Nama template (contoh: order_confirmation)
   • Language: Kode bahasa (contoh: id, en_US)
   • Components (opsional): JSON array untuk header media dan buttons

Code
 
[
  {
    "type": "body",
    "parameters": [
      { "type": "text", "text": "John Doe" },
      { "type": "text", "text": "INV-12345" }
    ]
  }
]

Interactive Message (WhatsApp)

CTA URL Button

Kirim pesan dengan tombol yang mengarah ke URL.

Parameter	Wajib	Batas	Keterangan
Body Text	Ya	1024 karakter	Teks utama pesan
Button Text	Ya	20 karakter	Teks pada tombol
Button URL	Ya	-	URL yang dibuka saat tombol diklik
Header Text	Tidak	60 karakter	Teks header opsional
Footer Text	Tidak	60 karakter	Teks footer opsional

Reply Buttons

Kirim pesan dengan 1-3 tombol quick reply.

Parameter	Wajib	Batas	Keterangan
Body Text	Ya	1024 karakter	Teks utama pesan
Buttons	Ya	1-3 tombol	Setiap tombol: id (max 256 char) + title (max 20 char)
Header Text	Tidak	60 karakter	Teks header opsional
Footer Text	Tidak	60 karakter	Teks footer opsional

Mode Simple - Isi form per tombol

Mode Advanced (JSON):

Code
 
[
  { "id": "yes", "title": "Ya, Setuju" },
  { "id": "no", "title": "Tidak" },
  { "id": "later", "title": "Nanti" }
]

List Menu

Kirim pesan dengan menu list yang bisa dipilih customer.

Parameter	Wajib	Batas	Keterangan
Body Text	Ya	1024 karakter	Teks utama pesan
Button Text	Ya	20 karakter	Teks tombol untuk membuka list
Sections	Ya	1-10 section	Setiap section: 1-10 item
Header Text	Tidak	60 karakter	Teks header opsional
Footer Text	Tidak	60 karakter	Teks footer opsional

Mode Simple - Isi form per item (1 section)

Mode Advanced (JSON) - Multiple sections:

Code
 
[
  {
    "title": "Layanan Rambut",
    "rows": [
      { "id": "haircut", "title": "Potong Rambut", "description": "Potong rambut standar" },
      { "id": "coloring", "title": "Pewarnaan", "description": "Pewarnaan rambut full" }
    ]
  },
  {
    "title": "Layanan Spa",
    "rows": [
      { "id": "massage", "title": "Pijat", "description": "Pijat relaksasi 60 menit" }
    ]
  }
]

Multi-Account Support

Jika Anda memiliki beberapa akun Instagram atau Facebook Page:

• Instagram Account ID - Pilih akun Instagram yang akan digunakan (auto-detect jika hanya 1 akun)
• Facebook Page ID - Pilih Facebook Page yang akan digunakan (auto-detect jika hanya 1 page)

List Templates

Ambil daftar template WhatsApp dari akun Anda.

Parameter	Default	Keterangan
Status	All	Filter: APPROVED, PENDING, REJECTED
Category	All	Filter: MARKETING, UTILITY, AUTHENTICATION
Limit	100	Maksimal template yang dikembalikan (max 500)

Get Template

Ambil detail template tertentu berdasarkan Template ID.

Parameter	Wajib	Keterangan
Template ID	Ya	ID template (contoh: tpl_abc123)

Mark as Read

Tandai pesan masuk sebagai sudah dibaca dan kirim read receipt ke customer.

Parameter	Wajib	Keterangan
Message ID	Ya	ID pesan yang akan ditandai (contoh: msg_xyz789)

Send Typing Indicator

Kirim indikator "sedang mengetik..." ke customer sebelum mengirim pesan.

Parameter	Wajib	Keterangan
Customer	Ya	Customer ID, phone number, atau Instagram username
Channel	Tidak	auto-detect, whatsapp, instagram, atau messenger

Get Message Status

Cek status pengiriman pesan yang sudah dikirim.

Parameter	Wajib	Keterangan
Message ID	Ya	ID pesan dari hasil operasi Send Message

Status yang dikembalikan:

Status	Keterangan
sent	Pesan berhasil dikirim ke server
delivered	Pesan sampai ke device penerima
read	Pesan sudah dibaca
failed	Pengiriman gagal

Contoh Workflow

Auto-Reply dari Google Sheets

1. Google Sheets Trigger - Mendeteksi baris baru
2. KirimChat: Send Message - Kirim pesan template ke nomor dari spreadsheet

Notifikasi Order dari WooCommerce

1. WooCommerce Trigger - Order baru dibuat
2. KirimChat: Send Typing - Kirim typing indicator
3. Wait - Tunggu 2 detik
4. KirimChat: Send Message - Kirim template konfirmasi order

Webhook ke WhatsApp

1. Webhook Trigger - Menerima data dari sistem eksternal
2. IF - Cek kondisi (contoh: status pembayaran)
3. KirimChat: Send Message - Kirim notifikasi ke customer

Status Tracking

1. KirimChat: Send Message - Kirim pesan
2. Wait - Tunggu 30 detik
3. KirimChat: Get Message Status - Cek status pengiriman
4. IF - Jika failed, kirim ulang atau notifikasi admin

Tips & Best Practices

Error Handling

• Aktifkan Continue on Fail di node settings untuk menangani error tanpa menghentikan workflow
• Gunakan IF node setelah KirimChat untuk mengecek response status
• Log error ke Google Sheets atau database untuk monitoring

Rate Limiting

Perhatikan batas rate limit per channel:

Channel	Batas	Window
WhatsApp	60 pesan	per menit
Instagram	180 pesan	per jam
Messenger	180 pesan	per jam

Gunakan Wait node di antara batch pengiriman untuk menghindari rate limiting.

24-Hour Messaging Window

• WhatsApp, Instagram, dan Messenger memiliki jendela 24 jam untuk pesan non-template
• Gunakan Template Message untuk mengirim pesan di luar jendela 24 jam (hanya WhatsApp)
• Cek status window sebelum mengirim pesan non-template

Performance

• Proses batch messages dengan Split In Batches node
• Tambahkan Wait node (1-2 detik) di antara batch untuk menghindari rate limit
• Gunakan Get Message Status untuk memverifikasi pengiriman penting