Integrasi Kirimdev

Hubungkan akun Kirimdev Anda dengan Konektor agar pesan WhatsApp pelanggan yang membawa kode pengunjung [K-...] atau data iklan Click-to-WhatsApp otomatis tersimpan sebagai Leads. Pesan dari lead yang sudah ada tercatat pada lead itu. Anda juga bisa mengirim pesan WhatsApp keluar (text & template) langsung dari Konektor.

Tentang Kirimdev

Kirimdev (api.kirimdev.com) adalah platform WhatsApp Cloud API untuk developer dengan REST API yang rapi dan webhook bawaan. Berbeda dari partner lain, Kirimdev mendukung dua arah:

• Inbound — pesan pelanggan masuk menjadi lead otomatis (webhook terverifikasi HMAC).
• Outbound — kirim pesan text atau template ke pelanggan, lewat Rules maupun tombol manual di halaman lead.

Prasyarat

Sebelum mulai, pastikan Anda sudah memiliki:

1. Akun Kirimdev yang aktif dengan nomor WhatsApp Business yang sudah terhubung.
2. API Key berformat kdv_live_….
3. Phone Number ID dari akun WhatsApp Anda.

Cara Integrasi

1. Tambahkan Integrasi di Konektor

1. Login ke Dashboard Konektor.
2. Buka Pengaturan > Lainnya > Integrasi.
3. Klik kartu Kirimdev di bagian Tersedia untuk dihubungkan.
4. Isi form:
   • Nama integrasi: contoh "Kirimdev WhatsApp".
   • API Key: tempel API Key Anda (kdv_live_…).
   • Phone Number ID: tempel Phone Number ID Anda.
5. Klik Hubungkan.

2. Verifikasi Status Aktif

Setelah disimpan, Konektor otomatis mendaftarkan webhook ke Kirimdev dan menangkap signing secret-nya.

• Jika berhasil, status integrasi menjadi Terhubung.
• Jika gagal (mis. API Key salah), status menjadi Bermasalah dengan pesan penyebabnya. Perbaiki API Key, lalu coba lagi.

3. Tes Koneksi (Inbound)

1. Pastikan status integrasi sudah Terhubung.
2. Kirim pesan WhatsApp dari nomor pelanggan ke nomor bisnis Kirimdev Anda.
3. Buka halaman Leads untuk memastikan pesan masuk sebagai lead/interaksi baru.

Mengirim Pesan Keluar (Outbound)

Kirimdev dapat mengirim pesan WhatsApp keluar melalui dua cara.

A. Otomatis lewat Rules

Buat aturan otomatis: ketika kondisi tertentu terpenuhi, kirim pesan WhatsApp.

1. Buka Otomatisasi & AI > Aturan Otomatisasi, lalu buat rule baru.
2. Pada Action, pilih Send WhatsApp (Kirimdev).
3. Pilih integrasi Kirimdev yang aktif.
4. Pilih tipe pesan:
   • Text — isi pesan langsung.
   • Template — isi nama template yang sudah disetujui dan kode bahasa (mis. id_ID).
5. Simpan rule. Pesan terkirim otomatis saat kondisi rule terpenuhi.

B. Manual dari Halaman Lead

1. Buka halaman Leads.
2. Pada baris lead yang memiliki nomor telepon, klik tombol Kirim WhatsApp (ikon pesawat kertas).
3. Pilih integrasi, tipe pesan (text/template), tulis pesan, lalu klik Kirim.

Event yang Diproses

Data yang Disinkronkan

Informasi Pelanggan

Pesan

Signature Verification

Kirimdev menandatangani setiap webhook dengan HMAC-SHA256:

X-Kirim-Signature: t=<unix>,v1=<hex>

Konektor memverifikasi tanda tangan ini secara otomatis menggunakan signing secret yang ditangkap saat registrasi, termasuk proteksi replay (toleransi 5 menit) dan rotasi secret. Anda tidak perlu mengonfigurasi apa pun.

Troubleshooting

Status Error setelah Save

1. Pastikan API Key benar dan masih aktif (belum di-revoke di dashboard Kirimdev).
2. Pastikan Phone Number ID sesuai dengan akun WhatsApp Anda.
3. Klik Verifikasi Koneksi pada baris integrasi untuk mencoba mendaftarkan ulang webhook.

Pesan Masuk Tidak Jadi Lead

1. Pastikan status integrasi Terhubung.
2. Pastikan pesan berasal dari pelanggan (event message.received), bukan sekadar update status.
3. Baca pesan peringatan pada baris integrasi.

Pesan Keluar Gagal Terkirim

1. Pastikan lead memiliki nomor telepon yang valid (format internasional, mis. +628…).
2. Untuk template, pastikan nama template sudah disetujui di Kirimdev dan kode bahasa benar.
3. Pastikan integrasi yang dipilih berstatus Terhubung.

Next Steps

• Buat Automation Rules
• Buka menu Leads di dashboard.