📋 Requisitos Previos y Casos de Uso
Esta funcionalidad permite que Atom envíe actualizaciones sobre el estado de entrega de plantillas de WhatsApp directamente a objetos de HubSpot (Contacto, Negocio o Ticket).
Precondiciones necesarias
Tener conectada y activa la integración nativa entre Atom y HubSpot.
Haber creado previamente una campaña de tipo Webhook en Atom.
Contar con rol de Administrador en la plataforma Atom.
⚠️ Importante: Para enviar estos campos al objeto Contacto de HubSpot, el contacto debe estar previamente vinculado con Atom y no presentar conflictos de duplicidad.
Casos de Uso Principales
Omnicanalidad Inteligente: Enviar un correo electrónico desde un Workflow de HubSpot a clientes que no pudieron ser contactados por WhatsApp (ej. número sin WhatsApp activo o fallos de entrega).
Seguimiento a No Respondidos: Activar comunicaciones secundarias si el usuario no responde al mensaje inicial en el tiempo configurado.
Gestión de Filtros de Meta: Identificar y reorientar mensajes bloqueados por experimentos de Meta, límites de envío o restricciones de usuario (MM Lite).
⚙️ Configuración del Flujo y Mapeo en HubSpot
Para reportar correctamente los eventos de envío hacia el CRM, debes vincular el identificador único del registro de HubSpot dentro de la campaña de Atom:
Duplicar el flujo en Atom: Ve a tu campaña Webhook en Atom, duplícala y en el componente de Webhook agrega un campo de información destinado a almacenar el ID del contacto de HubSpot (ej.
crm_id).
Configurar el Workflow en HubSpot: En el Workflow de HubSpot configurado para enviar el webhook de Atom, mapea el campo creado en el paso anterior (
crm_id) asignándole el valor Id de registro del contacto.
Mapear los estados de envío: Ingresa a la configuración de estados de envío en Atom y selecciona el campo personalizado del paso 1 como el identificador de destino.
Ruta: Automatizaciones> Webhooks > Acciones
🧩 Campos Sincronizados y Ciclo de Vida del Envío
Cada actualización que Meta o Atom procesan sobre el envío de la plantilla genera un evento automático hacia el registro asociado en HubSpot:
Campos de Información Disponibles
Estado de envío de la plantilla: Estatus actual en el ciclo de vida del mensaje.
Código y Descripción del error: Identificadores y detalles devueltos por Meta en caso de fallo (útiles para diagnosticar en la documentación oficial de Meta).
Nombre e Id del Webhook: Datos que identifican la campaña originaria en Atom para auditorías de soporte.
Nombre e Id de la plantilla: Identificadores del mensaje estructurado enviado.
Canal: Número de teléfono de WhatsApp utilizado para la salida del mensaje.
Matriz de Estatus de Envío
Estatus | Origen | Detalle Operativo |
Enviado | Meta | Confirmación inicial de Meta tras recibir la solicitud sin errores previos. Estado transitorio previo a la entrega. |
Entregado | Meta | Mensaje recibido con éxito en el dispositivo del cliente. La notificación a HubSpot toma solo un par de segundos. |
Leído | Meta | El usuario abre el mensaje. (Nota: No se notificará si el cliente tiene la confirmación de lectura desactivada). |
Fallido | Meta / Atom | Ocurre por problemas de Meta (falta de red, límites de tier, experimentos de Meta, MM Lite) o de Atom (plantilla desactivada, canal desconectado, formato de teléfono inválido). |
Flujo Expirado | Atom | El mensaje se entregó pero el usuario no abrió ni respondió durante el tiempo límite configurado. |
Respondido | Atom | El cliente contesta activamente al primer mensaje de la plantilla. |
Bloqueado | Atom | El intento de envío se detiene porque el destinatario se encuentra en el listado de clientes bloqueados de Atom. |
💡 Tip: Puedes crear Workflows en HubSpot activados exclusivamente cuando el estado de la plantilla cambie a Fallido o Flujo Expirado para enviar un correo de respaldo inmediatamente, asegurando cero pérdida de contactos críticos.
Configurar el rastreo de estatus de tus campañas Webhook te brinda visibilidad total sobre el alcance de tus comunicaciones. Convierte los errores de entrega en oportunidades de reintento omnicanal y garantiza que tu mensaje siempre llegue al cliente indicado. ✅