Log masukMulakan percubaan percuma
Meta Tech Provider

Hantar perbualan WhatsApp ke CRM anda secara automatik

Untuk menghantar perbualan WhatsApp ke CRM secara automatik, hantar mesej masuk sebagai webhook bertandatangan ke backend anda atau alat aliran kerja, cari atau cipta kenalan mengikut nombor telefon, dan rekodkan mesej sebagai aktiviti pada kenalan itu. Gunakan ID mesej WhatsApp sebagai kunci unik aktiviti, supaya penghantaran yang dicuba semula mengemas kini rekod yang sama dan tidak mencipta rekod kedua.

easyCoexistence menghubungkan nombor perniagaan WhatsApp yang anda simpan dalam aplikasi kepada Cloud API Meta melalui Coexistence.

X-EC-Delivery

Header pada POST yang dimajukan membawa ID penghantaran, sama bagi setiap cubaan semula penghantaran itu.

About 33 hours

Tempoh 7 percubaan penghantaran semula, selepas kira-kira 1, 5, 30, 120, 360 dan 1,440 minit.

1 attempt

Langkah Call my webhook memanggil URL anda sekali; tamat masa atau ralat menggagalkan larian dan menghantar e-mel kepada anda.

BSUID

ID pengguna dalam skop perniagaan, contohnya US.13491208655302741918, dihantar dalam user_id dan from_user_id di sebelah atau sebagai ganti nombor telefon.

30 days

Tempoh log larian automasi menyimpan mesej pencetus, balasan dan setiap langkah.

Acara mana yang perlu sampai ke CRM?

Tiga jenis mesej membentuk satu perbualan pada nombor Coexistence, dan dua laluan membawanya. Forward URL, ditetapkan bagi setiap nombor, menghantar apa yang pelanggan tulis dan apa yang pasukan anda taip dalam aplikasi WhatsApp Business, sebagai acara asal Meta, dan dicuba semula sehingga CRM anda menjawab. Balasan yang dihantar oleh automasi sampai ke Meta melalui API, yang hanya melaporkannya sebagai status penghantaran tanpa teks; untuk merekod kandungannya, tamatkan automasi dengan langkah Call my webhook, yang sejarahnya merangkumi balasan yang baru dihantar. Satu endpoint boleh menerima kedua-duanya: header X-EC-Event membaca automation.step bagi langkah dan nama medan Meta bagi forward.

Customer messagesForward URL, event messages, in value.messages
Replies typed on the phoneForward URL, event smb_message_echoes, in value.message_echoes
Automated repliesCall my webhook as the last step: history entries with direction out
Lead detailsSaved by an agent or an AI saves details step, or extracted by your workflow from the chat; see lead qualification

Bagaimana anda memadankan pengirim WhatsApp dengan kenalan CRM?

Mengikut nombor telefon, selepas dinormalkan. WhatsApp menghantar digit dengan kod negara tanpa tanda plus, contohnya 5511987654321, dalam messages[].from pada forward dan dalam contact.wa_id pada langkah webhook. Rekod CRM yang ditaip oleh orang menyimpan +55 11 98765-4321 atau (11) 98765-4321, jadi simpan satu sifat khusus dalam bentuk digit sahaja dan cari berdasarkannya. Apabila tiada padanan, cipta kenalan dengan nama profil WhatsApp dan nombor.

Simpan juga ID pengguna dalam skop perniagaan. Pengguna yang mempunyai nama pengguna WhatsApp dan tidak berhubung dengan nombor anda selama 30 hari mungkin tiba hanya dengan BSUID dalam from_user_id dan contacts[].user_id. Forward membawanya; langkah webhook membawa nombor telefon.

Apa yang perlu ada dalam setiap rekod CRM?

Satu kenalan dengan pengenal, dan satu aktiviti bagi setiap mesej dengan arah, teks, masa dan kunci unik. Peta di bawah menunjukkan kedudukan setiap nilai pada kedua-dua laluan. Masa mesej pada forward ialah saat Unix daripada Meta; langkah webhook menghantar tarikh ISO. Media tiba sebagai jenis dan ID pada forward, dan sebagai pemegang tempat seperti [image] dengan kapsyen pada langkah webhook, jadi rekodkan label ringkas dan bukan cuba menyimpan fail itu.

Forwarded event (value is Meta's)Call my webhook step
Contact phonemessages[].fromcontact.wa_id
Contact namecontacts[].profile.namecontact.name
BSUIDcontacts[].user_id, messages[].from_user_idNot sent
Activity texttext.body, or the media typemessage.text and history[].text
Directionmessages = in, smb_message_echoes = outhistory[].direction: in, out or echo
Timetimestamp, Unix secondsmessage.at and history[].at, ISO 8601
Unique keymessages[].id (wamid)message.id; run_id for history entries

Bagaimana anda mengelak penghantaran semula daripada mencipta pendua?

Jawab dengan cepat, kemudian kunci semuanya. Forward yang tidak menerima 2xx dalam 10 saat dicuba semula dengan X-EC-Delivery ID yang sama, sehingga 7 percubaan; panggilan CRM yang mengambil masa 12 saat oleh itu berjalan dua kali melainkan aktiviti di-upsert pada wamid. Balas 200 dahulu dan jalankan kerja CRM dalam barisan gilir atau tugas latar belakang.

Langkah webhook tidak dicuba semula, dan penghantaran berulang Meta sendiri ditapis sebelum automasi berjalan, jadi ia memanggil anda paling banyak sekali bagi setiap mesej. Entri sejarahnya tidak membawa ID mesej: kunci balasan automatik pada run_id ditambah kedudukannya. Ujian daripada Try it tiba dengan dry_run true dan kenalan contoh 15550000000; abaikannya supaya larian ujian tidak pernah mencipta rekod CRM.

Bagaimana penerima kelihatan dalam Node.js?

Satu laluan Express menerima kedua-dua jenis acara. Ia membaca badan mentah, memilih rahsia mengikut header X-EC-Event, mengesahkan X-EC-Signature, menjawab 200 serta-merta dan menyerahkan kerja kepada fungsi latar belakang. Objek crm mewakili klien API CRM anda: upsert kenalan mengikut telefon digit sahaja, dan upsert aktiviti mengikut kunci uniknya. Bentuk yang sama juga boleh digunakan dalam aliran kerja n8n, dengan nod Code untuk tandatangan dan nod CRM anda selepasnya.

Express receiver: forwards and Call my webhook steps into a CRM
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);

Bolehkah CRM mengemas kini prospek daripada apa yang AI pelajari?

Boleh, dalam aliran kerja anda. Perbualan yang tiba bersama langkah Call my webhook mengandungi soalan yang ditanya AI anda dan jawapan pelanggan, jadi nod model dalam n8n atau panggilan dalam backend anda boleh mengekstrak keperluan, bajet, masa atau lokasi dan menulisnya ke medan prospek, kemudian memindahkan peringkatnya. Jangan pulangkan balasan, kerana pelanggan sudah menerima mesej AI itu. Apabila aliran kerja memutuskan prospek itu layak dihubungi, ia boleh mencipta tugas untuk jurujual atau memberi amaran kepada pasukan. Atau biarkan easyCoexistence yang mengekstrak: agen atau langkah AI saves details menulis keperluan, bajet dan masa ke dalam medan kenalan, dan langkah Call an API boleh menghantarnya ke CRM anda dengan token gaya {{contact.budget}} dalam badannya. Halaman kelayakan prospek mempunyai arahan temu bual dan payload untuk persediaan ini.

Cara menetapkannya

  1. 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.
  2. Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
  3. Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
  4. 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.
  5. 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.

Kesilapan biasa

  • Mencari CRM menggunakan medan telefon teks bebas. Format digit sahaja WhatsApp jarang sepadan dengan apa yang orang taip, dan setiap kegagalan padanan mencipta kenalan pendua; cari sifat digit sahaja yang telah dinormalkan.
  • Memanggil CRM sebelum menjawab forward. CRM yang mengambil masa lebih 10 saat menyebabkan easyCoexistence mencuba semula, dan tanpa upsert pada wamid aktiviti direkod dua kali.
  • Hanya merekod forward dan menjangka balasan automatik ada di dalamnya. Penghantaran API kembali sebagai status tanpa teks; langkah Call my webhook selepas balasan membawa kandungannya.
  • Membiarkan ujian sampai ke CRM. Try it sebenarnya memanggil URL anda dengan dry_run true dan kenalan contoh 15550000000; buang acara itu sebelum sebarang upsert.
Menggunakan EasyCoexistence untuk ini

Forward URL-nya menghantar mesej pelanggan dan balasan telefon ke CRM anda sebagai acara asal Meta, ditandatangani bagi setiap nombor dan dicuba semula selama kira-kira 33 jam ketika CRM tidak tersedia, dan langkah Call my webhook menambah balasan automatik. Penghantaran semula dan automasi termasuk dalam pelan. US$ 9 hingga US$ 0.75 setiap nombor sebulan, turun apabila anda menambah nombor, dengan 3 hari pertama percuma.

Soalan lazim

Apakah CRM yang serasi dengan ini?

Mana-mana CRM yang mempunyai API, sama ada melalui backend anda sendiri atau melalui alat aliran kerja seperti n8n, Make atau Zapier yang mempunyai nod untuknya. HubSpot mempunyai objek Communications dengan jenis saluran WhatsApp yang direka untuk merekod mesej ini; halaman HubSpot menunjukkan panggilannya.

Bolehkah pasukan saya membalas pelanggan daripada CRM?

Hanya jika CRM menghantar melalui Cloud API Meta dengan endpoint hantar nombor dan token daripada get_api_credentials: teks bebas dalam tempoh 24 jam selepas mesej terakhir pelanggan, dan template yang diluluskan selepas itu. Mesej tersebut juga muncul dalam urutan perbualan aplikasi di telefon.

Bolehkah perbualan lama dimuatkan ke dalam CRM?

Hanya melalui import sejarah Meta, yang menghantar sehingga 6 bulan perbualan satu-ke-satu ke destinasi webhook langsung yang disimpan dalam masa 24 jam selepas penyambungan, sekali bagi setiap sambungan. Nombor yang ditetapkan kepada Through easyCoexistence merekod dari saat penghantaran semula bermula.

Apakah yang disimpan oleh easyCoexistence sepanjang proses?

Perubahan yang dihantar semula disusun dalam baris gilir untuk percubaan semula dan dibuang selepas 7 hari. Pada nombor yang melalui easyCoexistence, teks mesej turut disimpan untuk Conversations dan konteks AI selama tempoh yang anda pilih, 30, 90 atau 365 hari, dan log larian disimpan selama 30 hari. CRM menyimpan rekod kekal.

Teruskan membaca

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada