Pular para o conteúdo principal

n8n

Basic ou superior

As automações são do Basic ou superior. Veja Automações por webhook para conhecer os limites e os detalhes.

O n8n é uma plataforma de automação que você pode hospedar por conta própria ou usar na nuvem. Conecte o TellDone ao n8n usando um nó Webhook. Sua instância do n8n precisa estar acessível pela internet via HTTPS, com um nome de domínio (endereços IP são rejeitados).

Configuração​

No n8n​

  1. Adicione um nó Webhook ao seu fluxo de trabalho
  2. Defina o HTTP Method como POST
  3. Defina um caminho (por exemplo, telldone)
  4. (Opcional) Ative Header Auth: Name = Authorization, Value = o seu token secreto
  5. Copie a Production URL (não a URL de teste)

A Production URL só recebe dados enquanto o fluxo de trabalho está ativo, então ative-o primeiro.

No TellDone​

  1. Vá em Configurações > Integrações > Automações
  2. Toque em Nova automação, digite um nome (por exemplo, "n8n") e cole a URL de produção do n8n
  3. Se você ativou o Header Auth no n8n, digite o mesmo token como cabeçalho de autenticação no TellDone
  4. Escolha quais tipos de dados enviar (Nota, Nota + áudio no Ultra, Tarefas, Eventos, Relatórios) e quais gatilhos usar (Criado, Atualizado, Concluídas, Excluído)
  5. Toque em Salvar e depois em Testar envio para enviar um exemplo de payload

Confira o log de execução do n8n: você deve ver um payload com "test": true.

Roteamento por tipo de evento​

Adicione um nó Switch depois do nó Webhook para rotear os dados por tipo de evento:

  • Campo de roteamento: o valor event dos dados recebidos
  • Regra 1: igual a note.created - encaminhe para as suas ações de notas
  • Regra 2: igual a task.created - encaminhe para as suas ações de tarefas
  • Regra 3: igual a calendar_event.created - encaminhe para as suas ações de calendário
  • Regra 4: igual a report.created - encaminhe para as suas ações de relatórios
  • Se você também ativar os gatilhos Atualizado, Concluídas ou Excluído, adicione regras para esses tipos de evento também, por exemplo task.completed

Conecte cada saída do Switch ao nó de ação apropriado (Todoist, Google Calendar, Slack etc.).

Expressões úteis​

Ao configurar os nós de ação, use estas expressões do n8n para acessar os dados do TellDone:

ExpressãoDescrição
{{ $json.data.title }}Título da nota, tarefa ou evento
{{ $json.data.tags.join(', ') }}Tags como uma string separada por vírgulas
{{ $json.data.priority }}Nível de prioridade
{{ $json.data.due_date }}Prazo (tarefas)
{{ $json.data.summary }}Resumo gerado pela IA (notas)
{{ $json.event }}Tipo de evento

Para ver a lista completa de campos de cada tipo de dado, veja Automações por webhook - O que é enviado.

Filtrar eventos de teste​

Adicione um nó IF logo depois do nó Webhook:

  • Condição: {{ $json.test }} is not true
  • Caminho verdadeiro: o resto do seu fluxo de trabalho
  • Caminho falso: No Operation (descarta os eventos de teste)

Exemplos de fluxos de trabalho​

  • Webhook > Switch > Todoist: cria tarefas com prioridade e prazo
  • Webhook > Switch > Google Calendar: cria eventos com horário, local e participantes
  • Webhook > Switch > Slack: publica os relatórios diários em um canal
  • Webhook > Switch > Google Sheets: registra todas as notas como linhas de uma planilha
  • Webhook > Switch > Notion: salva notas com tags e resumo

Conferir se as requisições vêm do TellDone​

O n8n não consegue verificar a assinatura do TellDone, porque os nós dele só veem os dados já processados, não o corpo bruto exato que o TellDone assinou. Use o Header Auth: ative-o no nó Webhook e digite o mesmo token como cabeçalho de autenticação no TellDone (passos 4 e 8). Assim o n8n rejeita qualquer requisição sem esse token.

Desconectar​

Para parar de enviar dados ao n8n:

  • Desative o fluxo de trabalho no n8n ou
  • No TellDone, em Configurações > Integrações > Automações, desative o botão Ativa da automação ou toque em Excluir automação

Veja também​

Última atualização em