Integración de Webhook con N8N

---

Visión General

La integración con Webhooks envía notificaciones en tiempo real a N8N cuando ocurren eventos importantes en su inquilino de WhatsMark. Esto le permite:

• Sincronizar contactos con Google Sheets, CRMs o bases de datos.
• Enviar notificaciones vía Slack, correo electrónico o SMS.
• Disparar flujos de trabajo basados en cambios de estado.
• Actualizar paneles de analítica en tiempo real.
• Conectar con más de 400 aplicaciones soportadas por N8N.

---

Eventos Soportados

Recurso	Eventos	Descripción
Contactos	created, updated, deleted	Registros de clientes y prospectos (leads).
Orígenes (Sources)	created, updated, deleted	Seguimiento del origen de los prospectos.
Estados (Statuses)	created, updated, deleted	Seguimiento del estado del contacto.

---

Guía de Inicio Rápido

Paso 1: Habilitar Webhooks en WhatsMark

• Inicie sesión en su cuenta de inquilino.
• Vaya a Configuración → Configuración del Sistema → Gestión de Webhooks.
• Active la opción Habilitar Webhooks.
• Seleccione los eventos que desea rastrear (Contactos, Orígenes, Estados).
• Haga clic en Guardar.

Paso 2: Crear el Webhook en N8N

• Abra su editor de flujo de trabajo en N8N.
• Añada un nodo Webhook a su flujo.
• Configure el nodo:
  • Método HTTP: POST
  • Ruta (Path): Elija una ruta única (ej. /whatsmark-webhooks).
  • Autenticación: Ninguna (o configúrela según necesite).
• Copie la URL del webhook generada por N8N.

Paso 3: Configurar la URL del Webhook

• De vuelta en WhatsMark, vaya a Gestión de Webhooks.
• Pegue la URL de N8N en el campo Webhook URL.
• Haga clic en Guardar.

Paso 4: Probar la Conexión

• Cree un nuevo contacto en WhatsMark.
• Revise su flujo de N8N: debería haber recibido la petición (webhook).
• Inspeccione la carga de datos (payload) para verificar la estructura.

---

Estructura del Payload (Datos del Webhook)

{
  "event": {
    "id": "evt_1702468200_abc123",
    "type": "contact.created",
    "timestamp": "2025-12-12T14:30:00.000Z",
    "version": "1.0"
  },
  "tenant": {
    "id": 123,
    "name": "Empresa Ejemplo",
    "domain": "empresa"
  },
  "data": {
    "resource": {
      "type": "contact",
      "id": 456,
      "attributes": {
        "firstname": "Juan",
        "lastname": "Pérez",
        "email": "juan@ejemplo.com",
        "phone": "+1234567890",
        "company": "Ejemplo Inc"
      }
    },
    "relationships": {
      "status": {
        "id": 1,
        "name": "Activo"
      },
      "source": {
        "id": 2,
        "name": "Sitio Web"
      }
    }
  },
  "changes": {
    "previous": null,
    "current": { "firstname": "Juan", "lastname": "Pérez" },
    "modified_fields": null
  }
}

Campos Clave Explicados

• event: Metadatos sobre el evento del webhook (tipo, marca de tiempo).
• tenant: Información sobre su inquilino.
• data: Los datos reales del recurso afectado.
• changes: Solo para eventos de actualización (updated), muestra los valores anteriores y actuales.

---

Cabeceras HTTP (Headers)

WhatsMark incluye las siguientes cabeceras con cada petición de webhook:

Content-Type: application/json
X-Webhook-Event: contact.created
X-Webhook-Timestamp: 2025-12-12T14:30:00+00:00
X-Webhook-Format: n8n

---

Mejores Prácticas

• Filtre Eventos Temprano: Use nodos IF al inicio de su flujo en N8N para procesar solo los eventos necesarios.
• Manejo de Errores: Añada nodos de Try/Catch en N8N para prevenir fallos en el flujo de trabajo.
• Pruebe con Datos Reales: Valide su flujo con un evento real de WhatsMark antes de pasarlo a producción.