Integrasi Kirimdev — API, Webhook, SDK, dan n8n
Cara menghubungkan Kirimdev ke backend, CRM eksternal, atau workflow no-code lewat Public API, webhook bertanda tangan, dan node n8n.
Kirimdev bukan cuma dashboard chat — ada Public API untuk sistem Anda, webhook untuk event real-time, dan konektor n8n untuk otomasi tanpa kode berat.
Artikel ini ringkasan jalur integrasi yang paling sering dipakai.
Public API /v1
REST API dengan autentikasi Bearer API key (kdv_live_...).
- Buat key di Developers → API Keys (
/developers/api-keys) - Base URL:
https://api.kirimdev.com/v1/{phone_number_id}/... - Payload kirim pesan kompatibel Meta Cloud API — contoh dari docs Meta sering bisa dipakai dengan ganti host
- Pagination cursor, idempotency key, rate limit per organisasi
Mulai dari Quickstart atau API Reference.
TypeScript SDK
import { Kirim } from '@kirimdev/sdk'
const kirim = new Kirim({ apiKey: process.env.KIRIM_KEY! })
const phone = kirim.phoneNumbers(process.env.PHONE_ID!)
await phone.messages.send({
messaging_product: 'whatsapp',
to: '+628123456789',
type: 'text',
text: { body: 'Pesanan #12345 dikirim.' },
})SDK menangani retry, error mapping, dan pagination. Detail: TypeScript SDK.
Webhook — event masuk ke sistem Anda
Daftarkan endpoint HTTPS di Developers → Webhooks (/developers/webhooks). Kirimdev push event seperti:
message.received— pesan masuk dari pelangganmessage.status— terkirim, dibaca, gagal- Perubahan kontak dan subscription lainnya
Setiap request ditandatangani HMAC-SHA256 — verifikasi signature wajib di production. Lihat Verifying Signatures.
Log delivery & replay manual: Developers → Deliveries.
n8n — otomasi visual
Node resmi Kirimdev di n8n untuk kirim pesan, baca conversation, trigger dari webhook — cocok untuk notifikasi order, alert internal, atau bot sederhana tanpa deploy backend sendiri.
Detail: fitur n8n · Support bot recipe
MCP Server — tools untuk AI agents
MCP Server Kirimdev (https://api.kirimdev.com/mcp) — server tools untuk AI agents di Claude, ChatGPT, Cursor, OpenCode, dan client MCP lain. 18 tools: kirim pesan, cek inbox, kelola kontak. Satu API key dengan REST.
Detail: artikel MCP · fitur MCP · setup docs
Hermes Agent — integrasi Kirimdev lewat chat WhatsApp
Owner chat ke nomor bisnis, AI menjalankan Public API Kirimdev — kirim template, cek inbox, tanpa buka dashboard. Install & deploy di kirimdev-hermes.
Detail: artikel Hermes · setup docs
Pola integrasi umum
| Skenario | Pola |
|---|---|
| Backend kirim notifikasi order | API POST /messages + template |
| Sistem CRM catat chat masuk | Webhook message.received → DB Anda |
| Workflow tanpa kode | n8n trigger webhook → action Kirimdev |
| Akses Kirimdev lewat AI agent (MCP) | MCP tools |
| Owner akses Kirimdev lewat chat WA | Hermes + plugin kirimdev-hermes |
Sebelum production
- Simpan API key di secret manager — jangan di frontend
- Verifikasi signature webhook
- Tangani idempotency & retry (SDK sudah bantu)
- Pantau rate limits — terpisah dari kuota pesan WhatsApp