AccediInizia la prova gratuita
Meta Tech Provider

Invia automaticamente le conversazioni WhatsApp al tuo CRM

Per inviare automaticamente le conversazioni WhatsApp a un CRM, fai recapitare i messaggi in arrivo come webhook firmati al tuo backend o a uno strumento di workflow, trova o crea il contatto tramite numero di telefono e registra il messaggio come attività su quel contatto. Usa l'id messaggio WhatsApp come chiave univoca dell'attività: una consegna ripetuta aggiorna così lo stesso record invece di crearne un secondo.

easyCoexistence collega il numero WhatsApp Business che tieni nell'app all'API Cloud di Meta tramite Coexistence.

X-EC-Delivery

Intestazione su ogni POST inoltrato con l'id della consegna, identico a ogni nuovo tentativo di quella consegna.

About 33 hours

Intervalli dei 7 tentativi di inoltro, dopo circa 1, 5, 30, 120, 360 e 1.440 minuti.

1 attempt

Il passaggio Call my webhook chiama il tuo URL una sola volta; un timeout o un errore fa fallire l'esecuzione e ti invia un'e-mail.

BSUID

ID utente nell'ambito dell'azienda, come US.13491208655302741918, inviato in user_id e from_user_id accanto al numero di telefono o al posto di esso.

30 days

Per quanto tempo il registro dell'esecuzione dell'automazione conserva il messaggio che la attiva, la risposta e ogni passaggio.

Quali eventi devono arrivare al CRM?

Una conversazione su un numero Coexistence è composta da tre tipi di messaggio, e due percorsi li trasportano. La Forward URL, impostata per ciascun numero, invia ciò che scrivono i clienti e ciò che il tuo team digita nell'app WhatsApp Business, come eventi originali di Meta, con nuovi tentativi finché il CRM non risponde. Le risposte inviate dalle automazioni raggiungono Meta tramite l'API, che le segnala solo come stati di consegna senza testo; per registrarne le parole, concludi l'automazione con un passaggio Call my webhook, la cui cronologia include la risposta appena inviata dall'esecuzione. Un solo endpoint può ricevere entrambi: l'intestazione X-EC-Event riporta automation.step per il passaggio e il nome del campo di Meta per gli inoltri.

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

Come abbini un mittente WhatsApp a un contatto CRM?

Per numero di telefono, normalizzato. WhatsApp invia le cifre con il prefisso internazionale e senza il segno più, come 5511987654321, in messages[].from negli inoltri e in contact.wa_id nel passaggio webhook. I record del CRM inseriti dalle persone riportano +55 11 98765-4321 oppure (11) 98765-4321, quindi conserva una proprietà dedicata con la forma solo cifre e cerca su quella. Se nessun contatto corrisponde, crea il contatto con il nome del profilo WhatsApp e il numero.

Memorizza anche l'ID utente nell'ambito dell'azienda. Un utente con un nome utente WhatsApp che non ha scritto al tuo numero da 30 giorni può arrivare con il solo BSUID in from_user_id e contacts[].user_id. Gli inoltri lo contengono; il passaggio webhook contiene il numero di telefono.

Cosa deve contenere ogni record del CRM?

Un contatto con gli identificatori, e un'attività per ogni messaggio con direzione, testo, orario e una chiave univoca. La mappa qui sotto mostra dove si trova ciascun valore su entrambi i percorsi. Gli orari dei messaggi negli inoltri sono secondi Unix forniti da Meta; il passaggio webhook invia date ISO. I file multimediali arrivano come tipo e id negli inoltri e come segnaposto, come [image] con la didascalia, nel passaggio webhook; quindi registra un'etichetta breve invece di provare a memorizzare il file.

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

Come evitare che i nuovi tentativi creino duplicati?

Rispondi subito, poi usa una chiave per tutto. Un inoltro che non riceve un 2xx entro 10 secondi viene ritentato con lo stesso id X-EC-Delivery, fino a 7 tentativi; una chiamata al CRM che impiega 12 secondi quindi viene eseguita due volte, a meno che l'attività non venga inserita o aggiornata tramite upsert sul wamid. Rispondi 200 per primo e svolgi il lavoro sul CRM in una coda o in un job in background.

Il passaggio webhook non viene ritentato, e le consegne ripetute di Meta vengono filtrate prima che un'automazione venga eseguita, quindi ti chiama al massimo una volta per messaggio. Le voci della cronologia non portano un id messaggio: identifica le risposte automatiche con run_id più la loro posizione. I test di Try it arrivano con dry_run true e il contatto di esempio 15550000000; scartali, così i test non creano mai record nel CRM.

Come appare il ricevitore in Node.js?

Una sola route Express accetta entrambi i tipi di evento. Legge il corpo grezzo, sceglie il segreto in base all'intestazione X-EC-Event, verifica X-EC-Signature, risponde 200 immediatamente e passa il lavoro a una funzione in background. L'oggetto crm rappresenta il client API del tuo CRM: un upsert del contatto sul numero di telefono solo cifre e un upsert dell'attività sulla sua chiave univoca. La stessa struttura funziona per un workflow n8n, con un nodo Code per la firma e i nodi del tuo CRM subito dopo.

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);

Il CRM può aggiornare il lead in base a ciò che ha appreso l'AI?

Sì, nel tuo workflow. La chat che arriva con un passaggio Call my webhook contiene le domande che la tua AI ha posto e le risposte del cliente, quindi un nodo modello in n8n o una chiamata nel tuo backend può estrarre bisogno, budget, tempistiche o posizione e scriverli nei campi del lead, poi spostarne lo stato. Non restituire alcuna risposta, perché il cliente ha già ricevuto il messaggio dell'AI. Quando il workflow stabilisce che un lead vale una chiamata, può creare un'attività per un venditore o avvisare il team. Oppure lascia che sia easyCoexistence a estrarli: un agente o un passaggio AI saves details scrive bisogno, budget e tempistiche nei campi del contatto, e un passaggio Call an API può inviarli al tuo CRM con token in stile {{contact.budget}} nel corpo. La pagina sulla qualificazione dei lead contiene le istruzioni per l'intervista e il payload per questa configurazione.

Come configurarlo

  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.

Errori comuni

  • Cercare nel CRM sul campo telefono in testo libero. Il formato solo cifre di WhatsApp raramente coincide con quanto digitato da una persona, e ogni mancata corrispondenza crea un contatto duplicato; cerca su una proprietà normalizzata solo cifre.
  • Chiamare il CRM prima di rispondere all'inoltro. Un CRM che impiega più di 10 secondi fa sì che easyCoexistence riprovi, e senza un upsert sul wamid l'attività viene registrata due volte.
  • Registrare solo l'inoltro e aspettarsi di trovarvi le risposte automatiche. Gli invii via API tornano come stati senza testo; un passaggio Call my webhook dopo la risposta contiene le parole.
  • Lasciare che i test raggiungano il CRM. Try it chiama davvero il tuo URL con dry_run true e il contatto di esempio 15550000000; scarta questi eventi prima di qualsiasi upsert.
Farlo con EasyCoexistence

La sua Forward URL passa i messaggi dei clienti e le risposte telefoniche al tuo CRM come eventi originali di Meta, firmati per ogni numero e ritentati per circa 33 ore quando il CRM non è raggiungibile, e un passaggio Call my webhook aggiunge le risposte automatiche. Inoltro e automazioni sono inclusi nel piano. Da US$ 9 a US$ 0,75 per numero al mese, con prezzo che scende man mano che aggiungi numeri, e 3 giorni di prova gratuita.

Domande frequenti

Con quali CRM funziona?

Con qualsiasi CRM dotato di API, sia tramite il tuo backend sia tramite uno strumento di workflow come n8n, Make o Zapier che abbia dei nodi per esso. HubSpot ha un oggetto Communications con un tipo di canale WhatsApp pensato per registrare questi messaggi; la pagina HubSpot mostra la chiamata.

Il tuo team può rispondere ai clienti dal CRM?

Solo se il CRM invia tramite l'API Cloud di Meta, con l'endpoint di invio del numero e il token ottenuto da get_api_credentials: testo libero entro 24 ore dall'ultimo messaggio del cliente, un template approvato dopo. Questi messaggi compaiono anche nella chat dell'app sul telefono.

Si possono caricare nel CRM le conversazioni passate?

Solo tramite l'importazione della cronologia di Meta, che invia fino a 6 mesi di chat one-to-one a una destinazione webhook diretta salvata entro 24 ore dalla connessione, una volta per connessione. Un numero impostato su Tramite easyCoexistence registra dal momento in cui parte l'inoltro.

Cosa conserva easyCoexistence nel frattempo?

Le modifiche inoltrate vengono messe in coda per i nuovi tentativi e rimosse dopo 7 giorni. Su un numero che passa da easyCoexistence, il testo dei messaggi resta anche per Conversazioni e per il contesto dell'AI per il periodo che scegli, 30, 90 o 365 giorni, e i registri delle esecuzioni sono conservati per 30 giorni. Il registro permanente è nel CRM.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il