Saltar al contenido principal

n8n

Plan Basic y superior

Los webhooks requieren un plan de pago. Consulta Automatizaciones con webhooks para límites y detalles.

n8n es una plataforma de automatización que puedes alojar tú mismo o usar en la nube. Conecta TellDone a n8n usando un nodo Webhook. Tu instancia de n8n debe tener una URL HTTPS accesible desde internet.

Configuración​

En n8n​

  1. Añade un nodo Webhook a tu flujo de trabajo
  2. Configura el HTTP Method en POST
  3. Establece un path (por ejemplo, telldone)
  4. (Opcional) Activa Header Auth: Name = Authorization, Value = tu token secreto
  5. Copia la Production URL (no la URL de prueba)

En TellDone​

  1. Ve a Ajustes > Integraciones > Webhook Automations
  2. Toca Nueva automatización y pega la URL de producción de n8n
  3. Si activaste Header Auth en n8n, introduce el mismo token como auth header en TellDone
  4. Elige qué tipos de datos enviar
  5. Toca Guardar y luego Probar para enviar una carga útil de muestra

Revisa el log de ejecución de n8n: deberías ver un payload con "test": true.

Enrutamiento por tipo de evento​

Añade un nodo Switch después del nodo Webhook para enrutar los datos por tipo de evento:

  • Campo de enrutamiento: el valor de event de los datos entrantes
  • Regla 1: igual a note.created: enruta a tus acciones de notas
  • Regla 2: igual a task.created: enruta a tus acciones de tareas
  • Regla 3: igual a calendar_event.created: enruta a tus acciones de calendario
  • Regla 4: igual a report.created: enruta a tus acciones de informes

Conecta cada salida del Switch al nodo de acción correspondiente (Todoist, Google Calendar, Slack, etc.).

Expresiones útiles​

Al configurar nodos de acción, usa estas expresiones de n8n para acceder a los datos de TellDone:

ExpresiónDescripción
{{ $json.data.title }}Título de la nota, tarea o evento
{{ $json.data.tags.join(', ') }}Etiquetas como cadena separada por comas
{{ $json.data.priority }}Nivel de prioridad
{{ $json.data.due_date }}Fecha límite (tareas)
{{ $json.data.summary }}Resumen generado por IA (notas)
{{ $json.event }}Tipo de evento

Para ver la lista completa de campos en cada tipo de datos, consulta Automatizaciones con webhooks - Qué se envía.

Filtrar eventos de prueba​

Añade un nodo IF justo después del nodo Webhook:

  • Condición: {{ $json.test }} is not true
  • Ruta verdadera: resto de tu flujo de trabajo
  • Ruta falsa: No Operation (descartar eventos de prueba)

Ejemplos de flujos de trabajo​

  • Webhook - Switch - Todoist: crear tareas con prioridad y fecha límite
  • Webhook - Switch - Google Calendar: crear eventos con hora, ubicación y asistentes
  • Webhook - Switch - Slack: publicar informes diarios en un canal
  • Webhook - Switch - Google Sheets: registrar todas las notas como filas de hoja de cálculo
  • Webhook - Switch - Notion: guardar notas con etiquetas y resumen

Verificar firmas de webhook (opcional)​

Limitación del cuerpo crudo en n8n

El nodo Code de n8n solo expone el objeto JSON parseado, no el cuerpo crudo de la solicitud. La verificación de firma requiere los bytes crudos exactos que TellDone firmó. En la práctica, la mayoría de usuarios de n8n usan el encabezado predeterminado Authorization: <signing_secret> para autenticación en lugar de la verificación HMAC.

Para uso en producción, puedes verificar que los datos del webhook provienen realmente de TellDone comprobando la firma HMAC-SHA256. Añade un nodo Code justo después del nodo Webhook:

const crypto = require('crypto');

const secret = 'whsec_your_signing_secret_here';
const signature = $input.first().headers['x-lp-signature'];
const timestamp = $input.first().headers['x-lp-timestamp'];
const body = JSON.stringify($input.first().json);

const expected = 'sha256=' + crypto
  .createHmac('sha256', secret)
  .update(timestamp + '.' + body)
  .digest('hex');

if (signature !== expected) {
  throw new Error('Invalid webhook signature');
}

// Reject timestamps older than 5 minutes
const age = Math.floor(Date.now() / 1000) - parseInt(timestamp);
if (age > 300) {
  throw new Error('Webhook timestamp too old');
}

return $input.all();

Sustituye whsec_your_signing_secret_here por el secreto de firma que copiaste al crear la automatización en TellDone.

Desconectar​

Para dejar de enviar datos a n8n:

  • Desactiva el flujo de trabajo en n8n, o
  • Desactiva o elimina la automatización en Ajustes de TellDone > Integraciones > Webhook Automations

Ver también​

Ultima actualizacion en