Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Envía automáticamente las conversaciones de WhatsApp a tu CRM

Para enviar automáticamente las conversaciones de WhatsApp a un CRM, haz que los mensajes entrantes lleguen como webhooks firmados a tu backend o a una herramienta de automatización de flujos, busca o crea el contacto por número de teléfono y registra el mensaje como una actividad de ese contacto. Usa el id del mensaje de WhatsApp como clave única de la actividad, para que una entrega reintentada actualice el mismo registro en lugar de crear uno nuevo.

easyCoexistence conecta el número de WhatsApp Business que sigues usando en la app con la Cloud API de Meta mediante Coexistencia.

X-EC-Delivery

Encabezado de un POST reenviado que lleva el id de la entrega, idéntico en cada reintento de esa entrega.

About 33 hours

Duración total de los 7 intentos de reenvío, hechos tras unos 1, 5, 30, 120, 360 y 1440 minutos.

1 attempt

Un paso Call my webhook llama a tu URL una sola vez; un tiempo de espera agotado o un error hace que la ejecución falle y te avisa por correo.

BSUID

ID de usuario con alcance de negocio, como US.13491208655302741918, enviado en user_id y from_user_id junto al número de teléfono o en su lugar.

30 days

Tiempo durante el que el registro de ejecuciones de la automatización conserva el mensaje que la activó, la respuesta y cada paso.

¿Qué eventos deberían llegar al CRM?

Una conversación en un número con Coexistencia se compone de tres tipos de mensaje, y dos rutas los transportan. La Forward URL, configurada por número, envía lo que escriben los clientes y lo que tu equipo escribe en la app de WhatsApp Business, como eventos originales de Meta, y los reintenta hasta que tu CRM responde. Las respuestas enviadas por automatizaciones llegan a Meta a través de la API, que solo las notifica como estados de entrega sin texto; para registrar lo que dicen, termina la automatización con un paso Call my webhook, cuyo historial incluye la respuesta que la ejecución acaba de enviar. Un mismo endpoint puede recibir ambas rutas: el encabezado X-EC-Event lleva automation.step para el paso y el nombre de campo de Meta para los reenvíos.

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

¿Cómo se asocia un remitente de WhatsApp con un contacto del CRM?

Por número de teléfono, normalizado. WhatsApp envía dígitos con el código de país y sin el signo +, como 5511987654321, en messages[].from en los reenvíos y en contact.wa_id en el paso de webhook. Los registros del CRM introducidos a mano contienen +55 11 98765-4321 o (11) 98765-4321, así que guarda una propiedad dedicada con el número solo en dígitos y busca por ella. Si no hay coincidencia, crea el contacto con el nombre de perfil de WhatsApp y el número.

Guarda también el ID de usuario con alcance de negocio. Un usuario con nombre de usuario de WhatsApp que lleva 30 días sin contacto con tu número puede llegar solo con el BSUID en from_user_id y contacts[].user_id. Los reenvíos lo incluyen; el paso de webhook incluye el número de teléfono.

¿Qué debe contener cada registro del CRM?

Un contacto con los identificadores y una actividad por mensaje con dirección, texto, hora y una clave única. El mapa de abajo muestra dónde está cada valor en cada ruta. En los reenvíos, la hora de los mensajes viene de Meta en segundos Unix; el paso de webhook envía fechas ISO. Los archivos multimedia llegan como un tipo y un id en los reenvíos, y como marcadores de posición como [image] con el pie de foto en el paso de webhook, así que registra una etiqueta corta en lugar de intentar guardar el archivo.

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

¿Cómo evitar que los reintentos creen duplicados?

Responde rápido y asigna una clave a todo. Un reenvío que no recibe un 2xx en 10 segundos se reintenta con el mismo id X-EC-Delivery, hasta 7 intentos; por eso, una llamada al CRM que tarda 12 segundos se ejecuta dos veces, salvo que la actividad se guarde con un upsert sobre el wamid. Responde 200 primero y haz el trabajo del CRM en una cola o en un proceso en segundo plano.

El paso de webhook no se reintenta, y las entregas repetidas del propio Meta se filtran antes de que se ejecute una automatización, así que te llama como máximo una vez por mensaje. Sus entradas de historial no llevan id de mensaje: usa como clave de las respuestas automáticas el run_id más su posición. Las pruebas desde Try it llegan con dry_run true y el contacto de muestra 15550000000; descártalas para que las ejecuciones de prueba nunca creen registros en el CRM.

¿Cómo es el receptor en Node.js?

Una sola ruta de Express recibe los dos tipos de evento. Lee el cuerpo sin procesar, elige el secreto según el encabezado X-EC-Event, verifica X-EC-Signature, responde 200 de inmediato y pasa el trabajo a una función en segundo plano. El objeto crm representa el cliente de API de tu CRM: un upsert del contacto por el teléfono solo en dígitos y un upsert de la actividad por su clave única. La misma estructura sirve para un flujo de n8n, con un nodo Code para la firma y los nodos de tu CRM a continuación.

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

¿Puede el CRM actualizar el lead con lo que averiguó la IA?

Sí, en tu flujo. El chat que llega con un paso Call my webhook contiene las preguntas que hizo tu IA y las respuestas del cliente, así que un nodo de modelo en n8n o una llamada en tu backend puede extraer necesidad, presupuesto, plazo o ubicación, escribirlos en los campos del lead y después cambiar su etapa. No devuelvas ninguna respuesta, porque el cliente ya tiene el mensaje de la IA. Cuando el flujo decide que un lead merece una llamada, puede crear una tarea para un vendedor o avisar al equipo. O deja que easyCoexistence haga la extracción: un agente o un paso AI saves details escribe necesidad, presupuesto y plazo en los campos del contacto, y un paso Call an API puede enviarlos a tu CRM con tokens del estilo {{contact.budget}} en su cuerpo. La página de calificación de leads incluye las instrucciones de entrevista y el payload para esa configuración.

Cómo 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.

Errores comunes

  • Buscar en el CRM por el campo de teléfono de texto libre. El formato de WhatsApp, solo dígitos, rara vez coincide con lo que escribió una persona, y cada fallo crea un contacto duplicado; busca por una propiedad normalizada solo con dígitos.
  • Llamar al CRM antes de responder al reenvío. Si el CRM tarda más de 10 segundos, easyCoexistence reintenta, y sin un upsert sobre el wamid la actividad se registra dos veces.
  • Registrar solo el reenvío y esperar que incluya las respuestas automáticas. Los envíos por la API vuelven como estados sin texto; un paso Call my webhook después de la respuesta lleva lo que se dijo.
  • Dejar que las pruebas lleguen al CRM. Try it llama de verdad a tu URL con dry_run true y el contacto de muestra 15550000000; descarta esos eventos antes de cualquier upsert.
Hacerlo con EasyCoexistence

Su Forward URL pasa a tu CRM los mensajes de los clientes y las respuestas escritas desde el teléfono como eventos originales de Meta, firmados por número y reintentados durante unas 33 horas si el CRM está caído, y un paso Call my webhook añade las respuestas automáticas. El reenvío y las automatizaciones están incluidos en el plan. De US$ 9 a US$ 0.75 por número al mes, un precio que baja a medida que añades números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Con qué CRM funciona?

Con cualquier CRM que tenga API, ya sea a través de tu propio backend o de una herramienta de automatización como n8n, Make o Zapier que tenga nodos para él. HubSpot tiene un objeto Communications con un tipo de canal WhatsApp pensado para registrar estos mensajes; la página de HubSpot muestra la llamada.

¿Puede mi equipo responder a los clientes desde el CRM?

Solo si el CRM envía a través de la Cloud API de Meta con el endpoint de envío y el token del número obtenidos con get_api_credentials: texto libre dentro de las 24 horas posteriores al último mensaje del cliente y, después, una plantilla aprobada. Esos mensajes también aparecen en el chat de la app en el teléfono.

¿Se pueden importar al CRM las conversaciones antiguas?

Solo mediante la importación de historial de Meta, que envía hasta 6 meses de chats individuales a un destino de webhook directo guardado en las 24 horas posteriores a la conexión, una vez por conexión. Un número configurado como Through easyCoexistence registra desde el momento en que empieza el reenvío.

¿Qué guarda easyCoexistence por el camino?

Los cambios reenviados se ponen en cola para reintentos y se eliminan tras 7 días. En un número que pasa por easyCoexistence, el texto de los mensajes también se conserva para Conversaciones y como contexto para la IA durante el plazo que elijas, 30, 90 o 365 días, y los registros de ejecución se conservan 30 días. El registro permanente queda en el CRM.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el