Integrasi Kirimdev: API, Webhook, SDK, dan n8n untuk WhatsApp

Ringkasan singkat:

• Public API /v1 Kirimdev kompatibel Meta Cloud API — payload sama, hanya ganti host
• Webhook dikirim dengan tanda tangan HMAC-SHA256; verifikasi wajib di produksi
• SDK TypeScript resmi menangani retry, idempotency, dan pagination secara otomatis
• Node n8n resmi untuk otomasi visual; MCP Server untuk akses lewat AI agent; Hermes untuk akses lewat chat WhatsApp
• Biaya platform Kirimdev mulai Rp 25.000/bulan; tarif Meta ditagih terpisah langsung ke akun WhatsApp Business Anda

---

Kirimdev bukan hanya dashboard chat — ada Public API untuk sistem Anda, webhook untuk event real-time, dan konektor n8n untuk otomasi tanpa kode berat.

Artikel ini adalah ringkasan jalur integrasi yang paling sering dipakai.

Apa itu integrasi API dan webhook di WhatsApp?

Integrasi API memungkinkan backend Anda mengirim pesan WhatsApp secara terprogram — misalnya notifikasi order otomatis saat status di sistem berubah, atau OTP saat pengguna login. Sistem Anda memanggil endpoint HTTP Kirimdev, Kirimdev meneruskannya ke Meta, pesan sampai ke pelanggan.

Webhook adalah arah sebaliknya. Saat ada event di WhatsApp — pesan masuk dari pelanggan, status pengiriman berubah menjadi terbaca, kontak baru terbentuk — Kirimdev mengirim payload JSON ke endpoint HTTPS yang Anda daftarkan. Kombinasi API + webhook membentuk integrasi dua arah yang lengkap.

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 dokumentasi Meta sering bisa dipakai dengan mengganti host
• Cursor pagination, 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 pelanggan
• message.status — terkirim, dibaca, gagal
• Perubahan kontak dan subscription lainnya

Setiap request ditandatangani HMAC-SHA256 — verifikasi signature wajib di produksi. Lihat Verifying Signatures dan fitur Webhooks untuk penjelasan lengkap.

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. 24 tools: kirim pesan, cek inbox, kelola kontak. Satu API key bersama 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

Kapan pakai jalur mana

Skenario	Rekomendasi
Backend produksi kirim notifikasi order/OTP	Public API + SDK — retry dan idempotency siap pakai
CRM lokal mencatat chat masuk	Webhook message.received ke endpoint HTTPS Anda
Workflow tanpa kode / low-code	n8n — visual, cepat, tidak perlu deploy backend
Prototyping via AI agent (Claude, Cursor)	MCP Server — tools eksplisit tanpa curl
Owner ingin akses lewat chat WhatsApp	Hermes Agent self-hosted
Traffic ratusan pesan per menit	Public API, bukan MCP atau n8n

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 tools
Owner akses Kirimdev lewat chat WA	Hermes + plugin kirimdev-hermes

Biaya: apa yang Anda bayar dan ke siapa

Komponen	Ditagih oleh	Estimasi
Langganan platform Kirimdev	Kirimdev	Mulai Rp 25.000/bulan
Tarif template & pesan WhatsApp	Meta (langsung ke WhatsApp Business Account)	Sesuai tarif Meta

Semua jalur integrasi (API, webhook, n8n, MCP, Hermes) memakai kuota yang sama sesuai paket berlangganan Anda.

Sebelum produksi

1. Simpan API key di secret manager — jangan di frontend
2. Verifikasi signature webhook
3. Tangani idempotency & retry (SDK sudah membantu)
4. Pantau rate limits — terpisah dari kuota pesan WhatsApp

Baca berikutnya: Fitur API & SDK · Fitur Webhooks · Persiapan sebelum pakai Kirimdev

Pertanyaan yang sering muncul

Apa itu integrasi API dan webhook di WhatsApp? Integrasi API mengizinkan backend Anda mengirim pesan WhatsApp secara terprogram lewat endpoint HTTP. Webhook adalah kebalikannya — Kirimdev mengirim event (pesan masuk, status pengiriman) ke endpoint HTTPS Anda secara real-time. Kombinasi keduanya membentuk integrasi dua arah antara sistem Anda dan WhatsApp Business API.

Apakah Public API Kirimdev kompatibel dengan Meta Cloud API? Ya. Payload endpoint kirim pesan dirancang kompatibel 1:1 dengan Meta Cloud API — contoh dari dokumentasi Meta sering bisa dipakai langsung dengan hanya mengganti host. Ini mempermudah migrasi dari BSP lain atau setup direct-to-Meta.

Bagaimana cara verifikasi webhook Kirimdev? Setiap request webhook ditandatangani dengan HMAC-SHA256 memakai secret yang Anda dapatkan saat mendaftarkan endpoint. Verifikasi signature wajib di produksi untuk memastikan request memang dari Kirimdev. Panduan lengkap ada di dokumentasi Verifying Signatures.