Webhooks

Los webhooks permiten que Mind One notifique a sistemas externos en tiempo real cuando ocurren eventos en la plataforma. En lugar de consultar la API periódicamente, tu sistema recibe una llamada HTTP en el momento en que sucede algo relevante.

Cómo funcionan link

1. Configuras un endpoint en tu sistema que acepte peticiones POST.
2. Registras el webhook en Mind One indicando la URL y los eventos a escuchar.
3. Cuando ocurre el evento, Mind One envía un POST con el payload en formato JSON a tu endpoint.
4. Tu endpoint responde con un código 2xx para confirmar la recepción.

Configuración link

Los webhooks se gestionan desde Configuración Cuenta → Webhooks. Solo el rol Admin puede crear, editar y eliminar webhooks.

Para crear un webhook:

1. Haz clic en + Crear webhook.
2. Introduce un nombre descriptivo (ej: Notificaciones de sincronización).
3. Introduce la URL destino donde Mind One enviará las peticiones.
4. Selecciona uno o varios eventos que activarán el webhook.
5. Haz clic en Crear webhook.

Eventos disponibles link

Formato del payload link

Todos los eventos siguen la misma estructura:

{
  "event": "datagrid.row.updated",
  "timestamp": "2026-05-25T10:30:00Z",
  "tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "data": { ... }
}

Seguridad link

Cada webhook incluye una cabecera X-MindOne-Signature con una firma HMAC-SHA256 del cuerpo de la petición usando el secreto configurado en el webhook.

X-MindOne-Signature: sha256=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Verificación en Node.js:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

Reintentos link

Si tu endpoint no responde con un 2xx en el tiempo límite (10 segundos), Mind One reintenta la entrega con backoff exponencial:

Tras 3 reintentos fallidos, el evento se marca como no entregado.

Relacionado link

• Documentación API — API REST pública para consultar y modificar datos de forma programática.
• Conexiones — Sincronización automática con data warehouses vía Autosync.