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. Agrega un nodo Webhook a tu flujo de trabajo
  2. Configura el HTTP Method en POST
  3. Establece un path (ej., 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, ingresa el mismo token como auth header en TellDone
  4. Elige qué tipos de datos enviar
  5. Toca Guardar y luego Envío de prueba

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

Enrutamiento por tipo de evento​

Agrega 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 la lista completa de campos en cada tipo de datos, consulta Automatizaciones con webhooks - Qué se envía.

Filtrar eventos de prueba​

Agrega 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)​

Para uso en producción, puedes verificar que los datos del webhook realmente provienen de TellDone comprobando la firma HMAC-SHA256. Agrega 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();

Reemplaza whsec_your_signing_secret_here con 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​