Panduan Pengaturan & Developer Tools

Panduan lengkap untuk mengelola profil, pengaturan akun, langganan, dan fitur developer.

Pengaturan Profil

Mengubah Informasi Profil

1. Buka menu Profile dari sidebar
2. Ubah Nama atau Email
3. Klik Save Changes

Jika mengubah email, sistem akan mengirim verifikasi ke alamat baru.

Mengubah Password

1. Scroll ke bagian Change Password
2. Isi: Current Password, New Password, Confirm New Password
3. Klik Change Password

Tips: Minimal 8 karakter dengan huruf besar, huruf kecil, dan angka.

Langganan & Pembayaran

Status Langganan

Pilihan Paket

Durasi Langganan

Cara Upgrade

1. Buka halaman Subscription
2. Pilih durasi (1, 3, 6, atau 12 bulan)
3. Klik Upgrade pada paket yang diinginkan
4. Pilih metode pembayaran: QRIS, ShopeePay, atau Virtual Account
5. Selesaikan pembayaran

Developer Tools

Catatan: API Keys dan Webhooks tersedia mulai paket LITE.

API Keys

API Keys digunakan untuk autentikasi saat mengakses Public API.

Membuat API Key

1. Buka Developers > API Keys
2. Klik Create API Key
3. Masukkan nama (contoh: “n8n Production”)
4. Klik Create Key
5. PENTING: Salin API key segera! Hanya ditampilkan sekali.

Menggunakan API Key

Authorization: Bearer kc_live_your_api_key_here

Contoh Request

curl -X POST https://api.kirim.chat/api/v1/public/messages/send \
  -H "Authorization: Bearer kc_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "channel": "whatsapp",
    "message_type": "text",
    "content": "Hello!"
  }'

Batasan API Keys

Webhooks

Menerima notifikasi real-time saat event terjadi.

Event yang Tersedia

Membuat Webhook

1. Buka Developers > Webhooks
2. Klik Add Webhook
3. Isi: Name, URL Endpoint (HTTPS), Events, Channels
4. Klik Create Webhook
5. PENTING: Salin Webhook Secret! Hanya ditampilkan sekali.

Format Payload

{
  "event": "message.received",
  "timestamp": "2025-01-05T10:30:00Z",
  "data": {
    "message_id": "msg_xyz789",
    "customer_phone": "6281234567890",
    "channel": "whatsapp",
    "direction": "inbound",
    "message_type": "text",
    "content": "Hello, I need help!"
  }
}

Verifikasi Signature (Node.js)

const crypto = require('crypto');

function verifyWebhookSignature(body, signature, secret) {
  const hash = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(hash),
    Buffer.from(signature)
  );
}

Batasan Webhooks

Integrasi n8n

1. Di n8n, buka Settings > Community Nodes
2. Install: @kichat/n8n-nodes-kirimchat
3. Buat credentials dengan API Key dari Kirim.Chat

Bantuan & Dukungan

Kontak Support

• Email: support@kirim.chat
• WhatsApp: Chat langsung dengan tim support
• Jam Operasional: Senin-Jumat (jam kerja)

Panduan Kepatuhan Policy WhatsApp

Penyebab Utama Banned:

• Spam dan pesan massal berlebihan
• Banyak user yang block/report
• Konten yang melanggar policy
• Bot yang terlalu robotik

Best Practices:

1. Warming up nomor baru (Minggu 1: max 50 pesan/hari, dst)
2. Batasi broadcast marketing: max 1-2 campaign/minggu
3. Prioritaskan customer support
4. Jangan beli database kontak

Status Quality Rating:

• GREEN: Aman
• YELLOW: Warning, kurangi aktivitas marketing
• RED: Berbahaya, hentikan semua pengiriman

Error Handling API

FAQ

Q: Lupa password? A: Gunakan “Forgot Password” di halaman login.

Q: API key expired? A: Buat key baru dan update di semua integrasi.

Q: Webhook tidak menerima event? A: Pastikan URL dapat diakses publik, server return status 200, cek Delivery Logs.

Dokumentasi ini terakhir diperbarui: Januari 2026