Guardar mensajes y contactos de WhatsApp en Google Sheets automáticamente
Para guardar automáticamente los mensajes de WhatsApp Business en Google Sheets, envíalos como POST HTTP firmados a una herramienta de automatización como n8n, Make o Zapier, y deja que su paso de Google Sheets añada una fila por mensaje: hora, sentido, número de teléfono, nombre, texto e id del mensaje. Una segunda pestaña con el número de teléfono como clave mantiene una fila por contacto, que se actualiza cuando ese contacto vuelve a escribir.
easyCoexistence conecta el número de WhatsApp Business que sigues usando en la app con la Cloud API de Meta mediante Coexistencia.
Las entregas reenviadas se reintentan aproximadamente a los 1, 5, 30, 120, 360 y 1440 minutos cuando tu URL falla.
Cuánto espera un POST reenviado una respuesta 2xx antes de que se reintente esa entrega.
Peticiones de escritura a la API de Google Sheets permitidas por minuto, por usuario y por proyecto; 300 por proyecto.
La salida de una web app de Apps Script se redirige a una URL de un solo uso en script.googleusercontent.com.
El objeto de evento de doPost en Apps Script expone el cuerpo y los parámetros, no las cabeceras de la petición HTTP.
¿Qué ruta debe llenar la hoja?
Un número cuyos mensajes pasan por easyCoexistence tiene dos rutas, y cada una cubre una necesidad distinta. La Forward URL, que se configura una vez por número, reenvía los eventos originales de Meta tanto si una automatización responde como si no: los mensajes de los clientes, las respuestas que tu equipo escribe en la app de WhatsApp Business y los estados de entrega. Es la ruta para un registro completo de mensajes. Un paso Call my webhook dentro de una automatización solo se dispara con los mensajes que esa automatización recoge, y lleva el chat reciente, con la respuesta que la automatización acaba de enviar. Encaja con una hoja de leads, pedidos o solicitudes que gestiona una sola automatización. Las dos rutas van firmadas, con secretos distintos.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
¿Qué campos llegan y qué columnas debe tener la hoja?
Un POST reenviado envuelve un cambio de Meta: id (el de la entrega), event (el nombre de campo de Meta, como messages o smb_message_echoes), received_at, connection (el id de tu número, phone y phone_number_id) y value, tal como lo envió Meta. Dentro de value, messages contiene lo que escribieron los clientes y message_echoes lo que tu equipo escribió en el teléfono. Los números de teléfono llegan como dígitos con el código de país y sin el signo más; guarda esa columna como texto plano para que Sheets no la convierta en número. Un usuario con nombre de usuario de WhatsApp puede llegar con un ID de usuario de ámbito empresarial junto al número, o en lugar de él, así que reserva una columna para ese ID.
¿Cómo se crea el registro de mensajes en n8n?
Con tres nodos. Un nodo Webhook con HTTP Method en POST, Respond en Immediately y su Production URL guardada como Forward URL del número. Un nodo Code que verifica X-EC-Signature con el secreto de reenvío y convierte el evento en filas, descartando los estados de entrega. Un nodo de Google Sheets con la operación Append or Update Row y Column to match on en Message id, para que una entrega reintentada sobrescriba la misma fila en lugar de añadir otra.
El secreto de reenvío se muestra una sola vez, al guardar la Forward URL; si lo pierdes, haz clic en New secret y pega el nuevo. n8n Cloud permite el módulo crypto en los nodos Code; n8n autoalojado necesita NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));¿Cómo se mantiene una fila por contacto?
Añade un segundo nodo de Google Sheets sobre una pestaña Contacts, también con Append or Update Row y coincidencia por Phone. Mapea el teléfono, el nombre de perfil, el ID de usuario, la hora y el texto del último mensaje. El primer mensaje de un número crea su fila; los siguientes actualizan el nombre y las columnas de último contacto, así que la pestaña sirve también como lista de quién escribió y cuándo. Guarda las notas manuales en otra pestaña, enlazadas por teléfono, para que el workflow nunca las sobrescriba.
Los contactos guardados en la agenda del teléfono no llegan por esta vía. Meta los envía, junto con hasta 6 meses de chats, solo a un destino de webhook directo guardado en las 24 horas siguientes a conectar el número.
¿Puede Apps Script recibir los mensajes directamente?
No de forma limpia, así que pon una herramienta de workflows delante de la hoja. Google sirve la respuesta de una web app de Apps Script mediante una redirección a una URL de un solo uso en script.googleusercontent.com, y easyCoexistence no sigue redirecciones. El 302 cuenta como entrega fallida: un reenvío se reintenta hasta 7 veces, y cada reintento vuelve a ejecutar doPost y escribe otra fila, mientras que un paso Call my webhook falla y te avisa por correo. Además, doPost no puede leer las cabeceras de la petición, así que ahí es imposible verificar X-EC-Signature.
Apps Script sigue siendo una buena opción para el sentido contrario, enviar plantillas aprobadas a partir de las filas de una hoja, que la página de la integración con Google Sheets explica con código.
¿Se puede llenar la hoja con Make o Zapier?
Sí. En Make, empieza el escenario con Webhooks > Custom webhook y añade Google Sheets > Add a Row; en Zapier, usa Webhooks by Zapier con Catch Raw Hook, que conserva las cabeceras, y después Google Sheets > Create Spreadsheet Row. Ambos responden al POST al instante con un 2xx, que es lo que un reenvío necesita dentro de sus 10 segundos. Mapea los mismos campos de arriba desde value.messages y filtra los eventos cuyo value trae statuses en lugar de messages.
Trata la URL del hook como una contraseña, porque cualquiera que la tenga puede enviar filas. Si tu plan incluye un paso de código, verifica ahí X-EC-Signature con la misma receta HMAC del nodo de n8n.
¿Cómo se evitan filas duplicadas o que falten filas?
Los duplicados vienen de los reintentos. Un reenvío que no recibió un 2xx en 10 segundos se vuelve a enviar con la misma cabecera X-EC-Delivery y el mismo id en el cuerpo, y los mensajes que contiene conservan su wamid, así que hacer coincidir por Message id vuelve inofensivo un reintento. En la ruta del paso webhook, las pruebas lanzadas desde Try it llegan con dry_run true: llévalas a una pestaña de pruebas o descártalas.
Las filas que faltan vienen de la cuota de escritura de Google. La API de Sheets permite 60 peticiones de escritura por minuto, por usuario y por proyecto, y una credencial de n8n equivale a un usuario; una ráfaga de respuestas tras una campaña de plantillas puede superarla y recibir un HTTP 429. Activa Retry On Fail en los ajustes del nodo de Google Sheets, o agrupa los mensajes durante unos segundos y añádelos en una sola petición.
Cómo configurarlo
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
Errores comunes
- Verificar un reenvío con el Signing secret de una automatización, o al revés. La Forward URL se firma con el secreto de reenvío del número y Call my webhook con el secreto propio de la automatización; elige el secreto según la cabecera X-EC-Event.
- Añadir una fila por cada POST sin clave. Una entrega reintentada tras una respuesta lenta escribe dos veces el mismo mensaje; usa Append or Update Row con coincidencia por el id del mensaje.
- Escribir los estados de entrega como si fueran mensajes. El evento messages también trae los estados sent, delivered y read en value.statuses, que no tienen texto y generan filas vacías.
- Guardar la URL de una web app de Apps Script como Forward URL. Su redirección cuenta como fallo, así que cada uno de los 7 intentos vuelve a ejecutar doPost y añade una fila duplicada.
Con las automatizaciones activadas, una Forward URL reenvía a tu workflow los eventos originales de Meta, firmados con un secreto que solo tú tienes y reintentados cuando tu URL no responde, y un paso Call my webhook envía lo que gestionó una automatización, junto con su respuesta. Ambos 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
¿La hoja recibe los mensajes que mi equipo escribe desde el teléfono?
Sí, a través de la Forward URL. Las respuestas escritas en la app de WhatsApp Business llegan como eventos smb_message_echoes, con el número del cliente en to. Las respuestas enviadas por automatizaciones solo vuelven como estados de entrega, así que registra su texto con un paso Call my webhook colocado después de la respuesta.
¿Puedo pasar mis chats anteriores a la hoja?
No en un número cuyos mensajes pasan por easyCoexistence. Meta envía hasta 6 meses de chats individuales solo a un destino de webhook directo guardado en las 24 horas siguientes a la conexión, una vez por conexión. Un número que pasa por easyCoexistence registra desde el momento en que se guarda la Forward URL.
¿easyCoexistence guarda una copia de los mensajes?
Parcialmente. En un número enrutado por easyCoexistence con las automatizaciones activadas, el texto de los mensajes se conserva durante el plazo que elijas, 30, 90 o 365 días (90 por defecto), y se muestra en Conversaciones; las entregas reenviadas se retienen hasta 7 días para reintentos, y los registros de ejecución 30 días. La hoja es tu copia permanente.
¿Puede mi IA consultar la hoja para responder a los clientes?
No desde un paso Reply with AI, que solo lee sus Instructions y el chat. Un agente de IA puede consultar datos mediante una herramienta HTTP personalizada, y un paso Call my webhook o Call an API puede enviar la pregunta a un workflow que busque la respuesta en la hoja y la devuelva para enviarla como respuesta.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el