Passa al contenuto principale

n8n

Da Basic in su

Le automazioni sono disponibili da Basic in su. Vedi Automazioni webhook per limiti e dettagli.

n8n è una piattaforma di automazione che puoi ospitare tu stesso o usare nel cloud. Collega TellDone a n8n con un nodo Webhook. La tua istanza di n8n deve essere raggiungibile da internet tramite HTTPS, con un nome di dominio (gli indirizzi IP vengono rifiutati).

Configurazione​

In n8n​

  1. Aggiungi un nodo Webhook al tuo workflow
  2. Imposta HTTP Method su POST
  3. Imposta un percorso (per esempio, telldone)
  4. (Facoltativo) Attiva Header Auth: Name = Authorization, Value = il tuo token segreto
  5. Copia il Production URL (non l'URL di test)

Il Production URL riceve dati solo mentre il workflow è attivo, quindi attivalo prima.

In TellDone​

  1. Vai in Impostazioni > Integrazioni > Automazioni
  2. Tocca Nuova automazione, inserisci un nome (per esempio, "n8n") e incolla l'URL di produzione di n8n
  3. Se hai attivato Header Auth in n8n, inserisci lo stesso token come auth header in TellDone
  4. Scegli quali tipi di dati inviare (Nota, Nota + audio con Ultra, Attività, Eventi, Report) e quali trigger usare (Creato, Aggiornato, Completato, Eliminato)
  5. Tocca Salva, poi Invio di prova per inviare un payload di esempio

Controlla il log di esecuzione di n8n: dovresti vedere un payload con "test": true.

Instradare per tipo di evento​

Aggiungi un nodo Switch dopo il nodo Webhook per instradare i dati per tipo di evento:

  • Routing field: il valore event dei dati in arrivo
  • Rule 1: uguale a note.created - instrada verso le azioni per le note
  • Rule 2: uguale a task.created - instrada verso le azioni per le attività
  • Rule 3: uguale a calendar_event.created - instrada verso le azioni per il calendario
  • Rule 4: uguale a report.created - instrada verso le azioni per i report
  • Se attivi anche i trigger Aggiornato, Completato o Eliminato, aggiungi regole anche per quei tipi di evento, per esempio task.completed

Collega ogni uscita dello Switch al nodo di azione appropriato (Todoist, Google Calendar, Slack, ecc.).

Espressioni utili​

Quando configuri i nodi di azione, usa queste espressioni di n8n per accedere ai dati di TellDone:

EspressioneDescrizione
{{ $json.data.title }}Titolo della nota, dell'attività o dell'evento
{{ $json.data.tags.join(', ') }}Etichette come stringa separata da virgole
{{ $json.data.priority }}Livello di priorità
{{ $json.data.due_date }}Scadenza (attività)
{{ $json.data.summary }}Riepilogo generato dall'AI (note)
{{ $json.event }}Tipo di evento

Per l'elenco completo dei campi di ogni tipo di dati, vedi Automazioni webhook - Cosa viene inviato.

Filtrare gli eventi di prova​

Aggiungi un nodo IF subito dopo il nodo Webhook:

  • Condizione: {{ $json.test }} is not true
  • Percorso True: il resto del tuo workflow
  • Percorso False: No Operation (scarta gli eventi di prova)

Workflow di esempio​

  • Webhook > Switch > Todoist: crea attività con priorità e scadenza
  • Webhook > Switch > Google Calendar: crea eventi con ora, luogo e partecipanti
  • Webhook > Switch > Slack: pubblica i report giornalieri in un canale
  • Webhook > Switch > Google Sheets: registra tutte le note come righe di un foglio di calcolo
  • Webhook > Switch > Notion: salva le note con etichette e riepilogo

Verificare che le richieste arrivino da TellDone​

n8n non può verificare la firma di TellDone, perché i suoi nodi vedono solo i dati già elaborati, non il corpo grezzo esatto che TellDone ha firmato. Usa invece Header Auth: attivalo nel nodo Webhook e inserisci lo stesso token come auth header in TellDone (passaggi 4 e 8). n8n rifiuta così qualsiasi richiesta senza quel token.

Scollegare​

Per smettere di inviare dati a n8n:

  • Disattiva il workflow in n8n, oppure
  • In TellDone, in Impostazioni > Integrazioni > Automazioni, disattiva l'interruttore Attiva dell'automazione o tocca Elimina automazione

Vedi anche​

  • Automazioni webhook - formato del payload, limiti di consegna e sicurezza
  • Zapier - alternativa di automazione nel cloud
  • Make - alternativa di automazione nel cloud