Documentación de Conexión (Webhooks)

En Vectum orquestamos tus herramientas (Airtable, Slack, OpenAI) mediante potentes flujos en n8n. Esta sección es una guía para que tu propio equipo de desarrollo o software existente pueda enviar datos hacia los Webhooks que te construiremos.

Autenticación

La API de Vectum utiliza autenticación mediante tokens en los headers HTTP. Para autenticar una petición, debes incluir el token proporcionado por tu arquitecto de datos en el header X-Nova-Auth.

X-Nova-Auth: nv_prod_8f92jds83ndjw921

Límites de Ratio (Rate Limits)

Para proteger la infraestructura de n8n, los endpoints operan con un límite predeterminado de 100 peticiones por minuto por IP o Token. Si superas el límite, recibirás un status HTTP 429 Too Many Requests.

Ingesta de Leads desde Fuentes de Terceros

Usa este endpoint de ejemplo (POST) para despachar la información de un lead captado por un formulario in-house. Nuestro flujo de n8n lo tomará, usará IA para calificarlo y lo insertará en Airtable.

fetch('https://tu-instancia-n8n.com/webhook/ingesta-lead', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Nova-Auth': 'tu_token_secreto_aqui'
  },
  body: JSON.stringify({
    "email": "cliente@empresa.com",
    "nombre": "Carlos Ruiz",
    "empresa": "TechCorp Ltd.",
    "mensaje_original": "Requerimos auditoría para nuestro ERP"
  })
});

Validación de Flujo

Puedes verificar que los nodos receptores del webhook estén listos y operativos en el servidor de orquestación B2B que Vectum configuró para ti.

Respuesta Exitosa (200 OK):
{
  "status": "operativo",
  "servicios_conectados": [
    "Airtable",
    "OpenAI API",
    "Slack"
  ],
  "latencia_ms": 42
}

Solicitar Orquestación Técnica