Kirim percakapan WhatsApp ke CRM Anda secara otomatis
Agar percakapan WhatsApp terkirim ke CRM secara otomatis, minta pesan masuk dikirim sebagai webhook bertanda tangan ke backend Anda atau alat workflow, cari atau buat kontak berdasarkan nomor telepon, lalu catat pesan sebagai aktivitas pada kontak tersebut. Gunakan ID pesan WhatsApp sebagai kunci unik aktivitas, sehingga pengiriman yang dicoba kembali memperbarui rekaman yang sama alih-alih membuat rekaman kedua.
easyCoexistence menghubungkan nomor WhatsApp Business yang Anda simpan di aplikasi ke Cloud API Meta melalui Coexistence.
Header pada POST yang diteruskan memuat ID pengiriman, sama pada setiap percobaan ulang pengiriman tersebut.
Rentang 7 percobaan penerusan, setelah sekitar 1, 5, 30, 120, 360 dan 1,440 menit.
Langkah Call my webhook memanggil URL Anda sekali; timeout atau kesalahan menggagalkan eksekusi dan mengirim email kepada Anda.
ID pengguna dalam lingkup bisnis, seperti US.13491208655302741918, dikirim di user_id dan from_user_id di samping atau sebagai pengganti nomor telepon.
Lama log eksekusi otomasi menyimpan pesan pemicu, balasan, dan setiap langkah.
Event mana yang harus sampai ke CRM?
Tiga jenis pesan membentuk percakapan pada nomor Coexistence, dan dua rute membawanya. Forward URL, yang diatur per nomor, mengirim pesan yang ditulis pelanggan dan yang diketik tim Anda di aplikasi WhatsApp Business, sebagai event asli dari Meta, dan dicoba kembali hingga CRM Anda merespons. Balasan yang dikirim oleh otomasi sampai ke Meta lewat API, yang hanya melaporkannya sebagai status pengiriman tanpa teks; untuk mencatat isinya, akhiri otomasi dengan langkah Call my webhook, yang riwayatnya memuat balasan yang baru saja dikirim. Satu endpoint dapat menerima keduanya: header X-EC-Event berisi automation.step untuk langkah dan nama field Meta untuk penerusan.
Bagaimana mencocokkan pengirim WhatsApp dengan kontak CRM?
Berdasarkan nomor telepon yang dinormalisasi. WhatsApp mengirim digit dengan kode negara tanpa tanda plus, seperti 5511987654321, di messages[].from pada penerusan dan di contact.wa_id pada langkah webhook. Rekaman CRM yang diketik orang berisi +55 11 98765-4321 atau (11) 98765-4321, jadi simpan properti khusus dengan bentuk hanya digit dan cari berdasarkan properti itu. Jika tidak ada yang cocok, buat kontak dengan nama profil WhatsApp dan nomornya.
Simpan juga ID pengguna dalam lingkup bisnis. Pengguna dengan nama pengguna WhatsApp yang belum berkomunikasi dengan nomor Anda selama 30 hari mungkin hanya datang dengan BSUID di from_user_id dan contacts[].user_id. Penerusan membawanya; langkah webhook membawa nomor telepon.
Apa yang harus dimuat setiap rekaman CRM?
Sebuah kontak dengan identifiernya, dan satu aktivitas per pesan dengan arah, teks, waktu, dan kunci unik. Peta di bawah menunjukkan posisi setiap nilai pada kedua rute. Waktu pesan pada penerusan berupa detik Unix dari Meta; langkah webhook mengirim tanggal ISO. Media tiba sebagai tipe dan ID pada penerusan, dan sebagai placeholder seperti [image] dengan caption pada langkah webhook, jadi catat label singkat alih-alih mencoba menyimpan berkasnya.
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
Bagaimana mencegah percobaan ulang membuat duplikat?
Jawab dengan cepat, lalu beri kunci pada semuanya. Penerusan yang tidak mendapat 2xx dalam 10 detik dicoba kembali dengan ID X-EC-Delivery yang sama, hingga 7 percobaan; panggilan CRM yang memakan 12 detik karenanya berjalan dua kali kecuali aktivitas di-upsert berdasarkan wamid. Balas 200 terlebih dahulu dan kerjakan pekerjaan CRM dalam antrean atau proses latar belakang.
Langkah webhook tidak dicoba kembali, dan pengiriman berulang dari Meta disaring sebelum otomasi berjalan, sehingga langkah ini memanggil Anda paling banyak sekali per pesan. Entri riwayatnya tidak memuat ID pesan: beri kunci pada balasan otomatis dengan run_id ditambah posisinya. Uji dari Try it tiba dengan dry_run true dan kontak contoh 15550000000; lewati uji tersebut agar tidak pernah membuat rekaman CRM.
Seperti apa penerima di Node.js?
Satu rute Express menerima kedua jenis event. Ia membaca body mentah, memilih secret berdasarkan header X-EC-Event, memverifikasi X-EC-Signature, menjawab 200 seketika, dan menyerahkan pekerjaan ke fungsi latar belakang. Objek crm mewakili klien API CRM Anda: upsert kontak berdasarkan telepon yang hanya berisi digit, dan upsert aktivitas berdasarkan kunci uniknya. Bentuk yang sama juga berlaku untuk workflow n8n, dengan node Code untuk tanda tangan dan node CRM Anda setelahnya.
import express from "express";
import crypto from "node:crypto";
const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET; // the automation's Signing secret
function signed(req, secret) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
res.json({}); // no reply field: nothing is sent to the customer
handle(kind, JSON.parse(req.body)).catch(console.error);
});
async function handle(kind, body) {
if (kind === "messages") {
for (const m of body.value.messages ?? []) { // statuses are skipped
const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "smb_message_echoes") {
for (const m of body.value.message_echoes ?? []) {
const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "automation.step" && !body.dry_run) {
const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
for (const [i, h] of sentAfter.entries()) {
await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
}
}
}
app.listen(3000);Bisakah CRM memperbarui lead dari hasil yang dipelajari AI?
Bisa, di workflow Anda. Chat yang datang bersama langkah Call my webhook memuat pertanyaan yang diajukan AI dan jawaban pelanggan, sehingga node model di n8n atau panggilan di backend Anda dapat mengekstrak kebutuhan, anggaran, waktu, atau lokasi, lalu menuliskannya ke field lead dan memindahkan tahapnya. Jangan kembalikan balasan, karena pelanggan sudah menerima pesan dari AI. Ketika workflow memutuskan sebuah lead layak dihubungi, ia dapat membuat tugas untuk tenaga penjualan atau memberi tahu tim. Atau biarkan easyCoexistence yang mengekstrak: agen atau langkah AI saves details menuliskan kebutuhan, anggaran, dan waktu ke field kontak, dan langkah Call an API dapat mengirimkannya ke CRM Anda dengan token bergaya {{contact.budget}} di body-nya. Halaman kualifikasi lead memuat instruksi wawancara dan payload untuk penyiapan ini.
Cara mengonfigurasi
- Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
- Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.
Kesalahan umum
- Mencari di CRM menggunakan field telepon berbentuk teks bebas. Format hanya digit dari WhatsApp jarang cocok dengan apa yang diketik orang, dan setiap ketidakcocokan membuat kontak duplikat; cari properti hanya digit yang sudah dinormalisasi.
- Memanggil CRM sebelum menjawab penerusan. CRM yang membutuhkan lebih dari 10 detik membuat easyCoexistence mencoba kembali, dan tanpa upsert pada wamid, aktivitas tercatat dua kali.
- Hanya mencatat penerusan dan berharap balasan otomatis ada di dalamnya. Pengiriman API kembali sebagai status tanpa teks; langkah Call my webhook setelah balasan membawa isinya.
- Membiarkan uji menjangkau CRM. Try it benar-benar memanggil URL Anda dengan dry_run true dan kontak contoh 15550000000; buang event tersebut sebelum upsert apa pun.
Forward URL-nya meneruskan pesan pelanggan dan balasan telepon ke CRM Anda sebagai event asli Meta, ditandatangani per nomor dan dicoba kembali selama sekitar 33 jam saat CRM sedang tidak aktif, dan langkah Call my webhook menambahkan balasan otomatis. Penerusan dan otomasi termasuk dalam paket. US$ 9 turun hingga US$ 0.75 per nomor per bulan, makin murah seiring Anda menambah nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
CRM apa saja yang bisa digunakan dengan ini?
Setiap CRM yang memiliki API, baik melalui backend Anda sendiri maupun lewat alat workflow seperti n8n, Make, atau Zapier yang memiliki node untuknya. HubSpot memiliki objek Communications dengan tipe saluran WhatsApp yang dibuat untuk mencatat pesan-pesan ini; halaman HubSpot menunjukkan panggilannya.
Bisakah tim saya membalas pelanggan dari CRM?
Bisa, asalkan CRM mengirim melalui Cloud API Meta dengan endpoint kirim dan token nomor dari get_api_credentials: teks bebas dalam 24 jam sejak pesan terakhir pelanggan, dan template yang telah disetujui setelah itu. Pesan tersebut juga muncul di utas chat aplikasi di ponsel.
Bisakah percakapan lama dimuat ke CRM?
Hanya melalui impor riwayat Meta, yang mengirim hingga 6 bulan obrolan satu-ke-satu ke tujuan webhook langsung yang disimpan dalam 24 jam setelah menghubungkan, sekali per koneksi. Nomor yang diatur ke Through easyCoexistence mencatat sejak saat penerusan dimulai.
Apa yang disimpan easyCoexistence selama proses?
Perubahan yang diteruskan diantrekan untuk percobaan ulang dan dihapus setelah 7 hari. Pada nomor yang melalui easyCoexistence, teks pesan juga tersimpan untuk Conversations dan konteks AI selama waktu yang Anda pilih, 30, 90, atau 365 hari, dan log eksekusi disimpan selama 30 hari. CRM menyimpan catatan permanennya.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada