Integrasi Kirimdev

Hubungkan akun Kirimdev Anda dengan Konektor agar setiap pesan WhatsApp yang masuk dari pelanggan otomatis tersimpan sebagai Leads, sekaligus 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 menu Integrations > Partner Integrations.
3. Klik tombol + Add Integration lalu pilih Kirimdev.
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 Save.

2. Verifikasi Status Aktif

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

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

3. Tes Koneksi (Inbound)

1. Pastikan status integrasi sudah Active.
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 WhatsApp > Rules, 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 Verify pada kartu integrasi untuk mencoba mendaftarkan ulang webhook.

Pesan Masuk Tidak Jadi Lead

1. Pastikan status integrasi Active.
2. Pastikan pesan berasal dari pelanggan (event message.received), bukan sekadar update status.
3. Cek lastError pada kartu 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 Active.

Next Steps

• Buat Automation Rules
• Lihat Data Leads