Saltar al contenido principal

n8n

Basic o superior

Las automatizaciones están disponibles con Basic o superior. Consulta Automatizaciones con webhooks para ver los límites y los detalles.

n8n es una plataforma de automatización que puedes alojar tú o usar en la nube. Conecta TellDone con n8n mediante un nodo Webhook. Tu instancia de n8n debe ser accesible desde internet por HTTPS, con un nombre de dominio (las direcciones IP se rechazan).

Configuración​

En n8n​

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

La Production URL solo recibe datos mientras el flujo de trabajo está activo, así que actívalo primero.

En TellDone​

  1. Ve a Ajustes > Integraciones > Automatizaciones
  2. Toca Nueva automatización, escribe un nombre (por ejemplo, "n8n") y pega la URL de producción de n8n
  3. Si activaste Header Auth en n8n, escribe el mismo token como encabezado de autenticación en TellDone
  4. Elige qué tipos de datos enviar (Nota, Nota + audio en Ultra, Tareas, Eventos, Informes) y qué activadores usar (Creado, Actualizado, Completado, Eliminado)
  5. Toca Guardar y luego Envío de prueba para enviar una carga útil de muestra

Revisa el registro de ejecuciones de n8n: deberías ver una carga con "test": true.

Enrutar 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 que llegan
  • Regla 1: es igual a note.created, y enruta a tus acciones de notas
  • Regla 2: es igual a task.created, y enruta a tus acciones de tareas
  • Regla 3: es igual a calendar_event.created, y enruta a tus acciones de calendario
  • Regla 4: es igual a report.created, y enruta a tus acciones de informes
  • Si también activas los activadores Actualizado, Completado o Eliminado, añade reglas para esos tipos de evento, por ejemplo task.completed

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

Expresiones útiles​

Cuando configures los 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, la tarea o el evento
{{ $json.data.tags.join(', ') }}Etiquetas como cadena separada por comas
{{ $json.data.priority }}Nivel de prioridad
{{ $json.data.due_date }}Fecha de vencimiento (tareas)
{{ $json.data.summary }}Resumen generado por la IA (notas)
{{ $json.event }}Tipo de evento

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

Filtrar los eventos de prueba​

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

  • Condición: {{ $json.test }} is not true
  • Camino verdadero: el resto de tu flujo de trabajo
  • Camino falso: No Operation (descarta los eventos de prueba)

Flujos de trabajo de ejemplo​

  • Webhook > Switch > Todoist: crea tareas con prioridad y fecha de vencimiento
  • Webhook > Switch > Google Calendar: crea eventos con hora, ubicación y asistentes
  • Webhook > Switch > Slack: publica informes diarios en un canal
  • Webhook > Switch > Google Sheets: registra todas las notas como filas de una hoja de cálculo
  • Webhook > Switch > Notion: guarda notas con etiquetas y resumen

Comprobar que las solicitudes vienen de TellDone​

n8n no puede verificar la firma de TellDone, porque sus nodos solo ven los datos ya interpretados, no el cuerpo sin procesar exacto que TellDone firmó. Usa Header Auth en su lugar: actívalo en el nodo Webhook y escribe el mismo token como encabezado de autenticación en TellDone (pasos 4 y 8). Así n8n rechaza cualquier solicitud que no lleve ese token.

Desconectar​

Para dejar de enviar datos a n8n:

  • Desactiva el flujo de trabajo en n8n, o
  • En TellDone, en Ajustes > Integraciones > Automatizaciones, desactiva el interruptor Activa de la automatización o toca Eliminar automatización

Ver también​

Ultima actualizacion en