Integrasi kirim.chat

Hubungkan akun kirim.chat Anda dengan Konektor agar pesan pelanggan yang membawa kode pengunjung [K-...] atau data iklan Click-to-WhatsApp otomatis tersimpan sebagai Leads di Konektor. Pesan dari lead yang sudah ada tercatat pada lead itu. Aturan Otomatisasi berjalan pada pesan kirim.chat.

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:

1. Akun kirim.chat yang aktif.

Cara Integrasi

1. Buat Integrasi di Konektor

1. Login ke Dashboard Konektor.
2. Buka Pengaturan > Lainnya > Integrasi.
3. Klik kartu kirim.chat di bagian Tersedia untuk dihubungkan.
4. Masukkan nama integrasi (contoh: "kirim.chat WhatsApp").
5. Jangan isi Webhook Secret dulu - biarkan kosong.
6. Klik Hubungkan.

2. Salin Webhook URL

Setelah integrasi dibuat, akan muncul popup instruksi dengan Webhook URL:

1. Klik tombol Salin pada URL yang ditampilkan.
2. URL berformat:

   https://[domain]/api/webhooks/partners/kirimchat/[integrationId]

Anda juga bisa melihat URL kapan saja dengan mengklik tombol Lihat Webhook URL (ikon tautan) pada baris integrasi.

3. Konfigurasi Webhook di kirim.chat

1. Login ke dashboard kirim.chat.
2. Buka menu Developers > Webhooks.
3. Klik Create Webhook.
4. 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
5. Klik Create Webhook.
6. Salin Webhook Secret yang ditampilkan setelah webhook dibuat.

4. Masukkan Webhook Secret di Konektor

1. Kembali ke Dashboard Konektor.
2. Buka menu ⋮ pada integrasi kirim.chat, lalu pilih Isi Secret.
3. Masukkan Webhook Secret yang Anda dapatkan dari dashboard kirim.chat.
4. Klik Update.

5. Tes Koneksi

1. Pastikan integrasi kirim.chat sudah berstatus Terhubung setelah Webhook Secret disimpan.
2. Kirim pesan test dari WhatsApp ke nomor kirim.chat Anda.
3. Buka halaman Leads untuk memastikan pesan masuk sebagai lead/interaksi.
4. Jika status masih Menunggu, buka menu ⋮ pada integrasi lalu klik Isi Secret.

Balas dari Kotak Masuk Konektor

Anda bisa membalas chat kirim.chat langsung dari Kotak Masuk Konektor.

1. Di dashboard kirim.chat, buat API Key. Paket Free kirim.chat tidak bisa membuat API Key.
2. Di Konektor, buka menu ⋮ pada integrasi kirim.chat, lalu pilih Isi Secret.
3. Isi kolom API Key, lalu klik Update.
4. Buka Kotak Masuk, pilih percakapan kirim.chat, tulis balasan, lalu kirim.

• Konektor mengirim balasan teks. Balasan harus dikirim dalam 24 jam sejak pesan terakhir pelanggan. Setelah 24 jam, kirim template dari aplikasi kirim.chat, lalu lanjutkan di Konektor.
• Status Terkirim, Diterima, dan Dibaca tampil pada balasan di Kotak Masuk.
• Jika API Key kosong, Kotak Masuk menolak balasan dan meminta Anda melengkapi pengaturan integrasi.

Event yang Diproses

Lead, Aturan, dan Chat Lama

• Lead: Lead terbuat dari pesan yang membawa kode pengunjung [K-...] atau data iklan Click-to-WhatsApp. Pesan lain dari lead yang sudah ada tercatat pada lead itu.
• Aturan Otomatisasi: Aturan berjalan pada pesan kirim.chat, baik pesan pelanggan maupun pesan keluar dari tim. Baca Aturan Otomatisasi.
• Chat lama: Konektor hanya menerima pesan baru setelah webhook aktif. Chat lama di kirim.chat tidak diimpor.
• Session tidak perlu: Dengan integrasi kirim.chat yang aktif, Anda tidak perlu menyambungkan nomor yang sama lewat Sesi QR.

Iklan Click-to-WhatsApp (CTWA)

kirim.chat meneruskan data iklan dari chat iklan Click-to-WhatsApp, termasuk ctwa_clid. Konektor memakai ctwa_clid untuk mengirim konversi ke Meta, bukan fbclid. Atur CTWA dengan panduan Iklan Click-to-WhatsApp dari Nol.

Data yang Disinkronkan

Informasi Pelanggan

Pesan

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:

1. Pastikan Webhook Secret di Konektor sama dengan yang ada di dashboard kirim.chat.
2. Jika tidak yakin, buat webhook baru di kirim.chat dan update secret di Konektor.

Pesan Tidak Masuk

Jika pesan tidak masuk ke Konektor:

1. Pastikan webhook URL sudah benar di dashboard kirim.chat.
2. Pastikan channel yang dipilih adalah WhatsApp.
3. Pastikan Webhook Secret sudah disimpan di kartu integrasi.
4. Baca pesan peringatan pada baris integrasi.

Sync Terakhir: Belum Pernah

Sinkron terakhir: Belum pernah di baris integrasi berarti belum ada pesan dari kirim.chat yang sampai dan diproses Konektor.

1. Kirim satu pesan test dari WhatsApp ke nomor kirim.chat Anda.
2. Pastikan webhook di kirim.chat memakai URL dari Konektor dan channel WhatsApp.
3. Pastikan Webhook Secret sudah disimpan di kartu integrasi.

Chat lama di kirim.chat tidak dikirim ulang. Hanya pesan baru yang muncul.

Status Error

Jika status berubah menjadi Bermasalah:

1. Update Webhook Secret dengan yang baru.
2. Simpan ulang integrasi, lalu kirim pesan test dari WhatsApp.

Next Steps

• Buat Automation Rules
• Buka menu Leads di dashboard.