Integrasi kirim.chat
Hubungkan akun kirim.chat Anda dengan Konektor agar setiap pesan yang masuk dari pelanggan otomatis tersimpan sebagai Leads di database Konektor.
Tentang kirim.chat
kirim.chat adalah platform multi-channel messaging yang mendukung:
- WhatsApp Business API (WABA) - Official API dari Meta
- COEX - WhatsApp tanpa verifikasi bisnis
- Instagram - Direct Message
- Messenger - Facebook Messenger
Prasyarat
Sebelum mulai, pastikan Anda sudah memiliki:
- Akun kirim.chat yang aktif.
Belum punya akun kirim.chat?
Daftar kirim.chat melalui tautan berikut: Daftar kirim.chat
Cara Integrasi
1. Buat Integrasi di Konektor
- Login ke Dashboard Konektor.
- Buka menu Integrations > Partner Integrations.
- Klik tombol + Add Integration dan pilih kirim.chat.
- Masukkan nama integrasi (contoh: "kirim.chat WhatsApp").
- Jangan isi Webhook Secret dulu - biarkan kosong.
- Klik Save.
2. Salin Webhook URL
Setelah integrasi dibuat, akan muncul popup instruksi dengan Webhook URL:
- Klik tombol Salin pada URL yang ditampilkan.
- URL berformat:
https://[domain]/api/webhooks/partners/kirimchat/[integrationId]
Anda juga bisa melihat URL kapan saja dengan mengklik tombol View Webhook (ikon link) pada kartu integrasi.
3. Konfigurasi Webhook di kirim.chat
- Login ke dashboard kirim.chat.
- Buka menu Developers > Webhooks.
- Klik Create Webhook.
- Isi form:
- Name:
Konektor - URL: Paste webhook URL dari Konektor
- Permissions / Izin: Centang semua izin yang tersedia
- Events: Centang semua (Message Received, Sent, Delivered, Read, Failed)
- Channels: Pilih WhatsApp
- Name:
- Klik Create Webhook.
- Salin Webhook Secret yang ditampilkan setelah webhook dibuat.
4. Masukkan Webhook Secret di Konektor
- Kembali ke Dashboard Konektor.
- Klik ikon edit (pensil) pada integrasi kirim.chat.
- Masukkan Webhook Secret yang Anda dapatkan dari dashboard kirim.chat.
- Klik Save.
5. Tes Koneksi
- Pastikan integrasi kirim.chat sudah berstatus Active setelah Webhook Secret disimpan.
- Kirim pesan test dari WhatsApp ke nomor kirim.chat Anda.
- Buka halaman Leads untuk memastikan pesan masuk sebagai lead/interaksi.
- Jika status masih Pending, buka kartu integrasi lalu klik Isi Secret.
Event yang Diproses
| Event | Aksi |
|---|---|
message.received | Diproses - inbound, membuat/update lead, dan evaluasi rules |
message.sent | Diproses - outbound, update interaksi/rules (tidak membuat lead baru) |
message.delivered | Diproses - outbound, diperlakukan seperti message.sent untuk kompatibilitas |
message.read | Diabaikan (not_a_message) |
message.failed | Diabaikan (not_a_message) |
Data yang Disinkronkan
Informasi Pelanggan
| Field | Deskripsi |
|---|---|
customer_phone | Nomor pelanggan |
customer_name | Nama pelanggan (jika tersedia) |
customer_id | ID pelanggan di kirim.chat |
Pesan
| Field | Deskripsi |
|---|---|
content | Isi pesan |
message_type | Tipe pesan (text, image, video, audio, document, location) |
channel | Channel (whatsapp, instagram, messenger) |
timestamp | Waktu pesan diterima |
Signature Verification
kirim.chat menggunakan HMAC-SHA256 untuk memverifikasi webhook:
X-KirimChat-Signature: sha256=xxxxxx
Konektor akan memverifikasi signature ini menggunakan Webhook Secret yang Anda masukkan untuk memastikan webhook berasal dari kirim.chat.
Troubleshooting
Invalid Signature
Jika muncul error Invalid signature:
- Pastikan Webhook Secret di Konektor sama dengan yang ada di dashboard kirim.chat.
- Jika tidak yakin, buat webhook baru di kirim.chat dan update secret di Konektor.
Pesan Tidak Masuk
Jika pesan tidak masuk ke Konektor:
- Pastikan webhook URL sudah benar di dashboard kirim.chat.
- Pastikan channel yang dipilih adalah WhatsApp.
- Pastikan Webhook Secret sudah disimpan di kartu integrasi.
- Cek log error di kartu integrasi.
Status Error
Jika status berubah menjadi Error:
- Update Webhook Secret dengan yang baru.
- Simpan ulang integrasi, lalu kirim pesan test dari WhatsApp.
Next Steps
Butuh Bantuan Lebih Lanjut?
Tim kami siap membantu Anda memaksimalkan tracking iklan dan atribusi bisnis.
© 2026 Konektor. Seluruh hak cipta dilindungi.
