Registrar mensajes de WhatsApp en HubSpot desde un número con Coexistencia

¿Cómo llega un mensaje de WhatsApp a un contacto de HubSpot?

En tres pasos. Meta entrega el mensaje al destino del webhook que configuraste para el número, que aquí es un nodo Webhook de n8n. El flujo busca en HubSpot un contacto con el teléfono del remitente y crea uno si no hay coincidencia. Después crea un registro de comunicación con el texto del mensaje y lo asocia a ese contacto.

HubSpot creó el objeto Communications para este caso. Representa un mensaje de WhatsApp, LinkedIn o SMS enviado o recibido fuera de HubSpot, y se muestra en la cronología del registro como una llamada o un correo registrados. Las propiedades obligatorias son el tipo de canal, hs_communication_logged_from con el valor CRM, el cuerpo, un propietario y una marca de tiempo.

Nada de esto requiere una app del marketplace de HubSpot. El nodo HTTP Request de n8n puede reutilizar la credencial de HubSpot que ya configuraste para el nodo de HubSpot, y la llamada es un único POST por mensaje.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

¿También se registran los mensajes escritos desde el teléfono?

Pueden registrarse, y eso es lo que aporta un número con Coexistencia. Cuando alguien del equipo responde desde la app de WhatsApp Business, Meta envía un eco de ese mensaje saliente al mismo destino del webhook. Un flujo que gestione tanto los mensajes entrantes como los ecos escribe ambos lados de la conversación en la cronología, así que un vendedor que abre el contacto en HubSpot ve lo que preguntó el cliente y lo que respondió la tienda.

Separa las ramas según el campo del webhook. Los mensajes entrantes llegan en messages y las respuestas del teléfono llegan en smb_message_echoes. Registra el primero como recibido y el segundo como enviado, y la cronología se lee en orden.

Las respuestas que el propio flujo envía por la Cloud API ya las conoce, así que regístralas en el momento del envío en lugar de esperar un webhook.

¿Y el canal de bandeja de WhatsApp de HubSpot?

Es otra integración. La bandeja de conversaciones de HubSpot conecta un número de WhatsApp al propio HubSpot, y su base de conocimiento indica que el número no debe estar conectado a otra integración de WhatsApp. Está disponible en Marketing Hub o Service Hub Professional y Enterprise.

Un número conectado a través de EasyCoexistence funciona al revés: Meta dirige sus webhooks a una URL tuya y HubSpot recibe registros por su API. La conversación se responde desde el teléfono o desde tu flujo, y HubSpot es el sistema de registro que guarda el historial en el contacto, la operación o el ticket.

La llamada necesita un permiso de escritura de contactos en la app privada o la credencial que la realiza, el mismo permiso que el flujo ya necesita para crear el contacto.

¿Cómo debe el flujo asociar un remitente con un contacto?

Por número de teléfono, normalizado antes de la búsqueda. Meta envía el remitente como dígitos con el código de país y sin signo más, como 14155550188. Los contactos de HubSpot se escriben a mano, así que la misma persona puede estar guardada como +1 415 555 0188 o (415) 555-0188.

El patrón fiable es mantener una propiedad de contacto dedicada con el número solo en dígitos, rellenarla cuando el flujo crea un contacto y buscar por esa propiedad. Buscar directamente en el campo de teléfono de texto libre funciona con los contactos que creó el flujo y falla con muchos de los que creó una persona, lo que genera duplicados.

Cuando una búsqueda no devuelve nada, crea el contacto con el nombre del perfil del payload del webhook como nombre y el número solo en dígitos en ambos campos. Una persona puede fusionarlo o renombrarlo después, y la conversación ya queda adjunta.

Errores comunes

• Registrar solo los mensajes entrantes. La cronología muestra entonces preguntas sin respuestas, porque las respuestas escritas desde el teléfono llegan como eventos smb_message_echoes.
• Dejar hs_communication_logged_from sin definir. HubSpot exige que sea CRM al crear una comunicación por la API.
• Buscar contactos por el campo de teléfono sin normalizar. El formato de solo dígitos de Meta rara vez coincide con lo que escribió una persona, y cada fallo crea un contacto duplicado.

Preguntas frecuentes

Sigue leyendo