Base de Conhecimento

Trello no n8n: automatize cartões e quadros

  • trello no n8n, n8n, automação, trello trigger, kanban, cartões
  • Usuários acharam útil: 0

Crie a credencial, use o nó Trello para criar e mover cartões e ative o Trello Trigger com n8n acessível pela internet, na sua própria VPS.

Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Trello no n8n: automatize cartões e quadros

Capa da Redação Eleven Host para o tutorial: Trello no n8n: automatize cartões e quadros Arte: Eleven Host

O trello no n8n funciona com dois nós: o nó Trello, que cria, altera e apaga quadros e cartões, e o Trello Trigger, que inicia um fluxo quando acontece algo no Trello. Atualizado em 15/11/2026.

O que são o nó Trello e o Trello Trigger

O Trello é um aplicativo web de listas no estilo Kanban, subsidiária da Atlassian. O nó Trello trabalha com estes recursos, cada um com suas operações na interface:

  • Attachment: Create, Delete, Get, Get Many;
  • Board: Create, Delete, Get, Update;
  • Board Member: Add, Get Many, Invite, Remove;
  • Card: Create, Delete, Get, Update;
  • Card Comment: Create, Delete, Update;
  • Checklist: Create, Create Checklist Item, Delete, Get, Get Many, entre outras;
  • Label: Add to Card, Create, Remove From Card, entre outras;
  • List: Archive, Create, Get, Get Cards, Get Many, Update.

Para uma operação que o nó não tem, o caminho é o nó HTTP Request, que chama a API do Trello com a credencial já salva.

O Trello Trigger inicia o workflow quando ocorrem eventos no Trello. Ele tem um único parâmetro além da autenticação, o Model ID, o ID do modelo cujos eventos serão assinados; pode ser, por exemplo, o ID de um usuário ou de uma lista.

Para quem serve

Serve a quem já roda o n8n na própria VPS e organiza tarefas em quadros do Trello: criar cartões a partir de formulários, avisar a equipe quando um cartão muda de lista ou montar resumos dos cartões de uma lista. Quem ainda não tem o servidor pode ver o que é um servidor VPS e como escolher um plano. Em 15/11/2026, a versão estável do n8n é a 2.47.7, publicada em 13/11/2026.

Uma lista de VPS com mensalidade em reais está na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 1: Power-Up, API Key e Token

A credencial do n8n precisa de uma API Key e de um API Token, e o pré-requisito é uma conta no Trello. A ordem dos passos, segundo a documentação do n8n, é esta:

  1. no Power-Up Admin Portal do Trello, escolha New para criar um Power-Up;
  2. dê um nome, como n8n integration, escolha o Workspace, deixe em branco o campo da URL do conector iframe, informe um contato e clique em Create;
  3. na página do seu Power-Up, aba onde fica a API Key (hoje chamada Trello Auth), gere a chave e copie para o n8n;
  4. na mesma página, adicione a URL base do seu n8n como origem permitida e escolha as capacidades;
  5. clique no link Token, ao lado da chave, autorize e copie o token.

O nome da aba varia: a documentação do n8n fala em aba API Key e no endereço trello.com/power-ups/admin, enquanto a Atlassian descreve a aba Trello Auth e a opção Generate a new API Key em trello.com/apps/admin. Procure a aba que gera a chave.

Guarde o token como segredo

A Atlassian lembra que tokens devem ser mantidos em segredo. Recomendamos guardar a chave e o token na credencial do n8n.

Passo 2: criar a credencial no n8n

No n8n, crie uma credencial Trello API e preencha:

  • API Key: campo obrigatório, com a chave gerada no Power-Up;
  • API Token: campo obrigatório, com o token do link Token;
  • OAuth Secret: campo opcional, usado para verificar a autenticidade do webhook. Ele fica na aba da API Key do Power-Up.

Para o Trello Trigger, recomendamos preencher o OAuth Secret. Quando ele está preenchido, o n8n confere a assinatura que o Trello envia em cada chamada e recusa as que não batem, com resposta 401. Sem o campo, a conferência da assinatura é pulada. O teste da credencial faz uma chamada à API do Trello que consulta o membro dono do token.

Onde achar os IDs de lista e de quadro

List ID e Model ID são IDs, não nomes. A documentação do n8n ensina um caminho para a lista: abra um cartão dela, acrescente .json ao fim do endereço, procure o campo idList e copie o valor. A lista precisa ter ao menos um cartão.

Para o quadro, a Atlassian ensina a consultar GET /1/members/me/boards e ler o ID no JSON retornado. Dentro do n8n, outra alternativa é List > Get Many, com o Board ID, e ler o ID na saída do nó. Use o ID do JSON, não o trecho curto da URL do quadro.

Mover um cartão: Card, Update e List ID

O nó não tem uma operação chamada Move. Para mover um cartão, use Card > Update e, em Update Fields, preencha List ID, o ID da lista em que o cartão deve ficar. Update Fields também tem Name, Description, Closed e Due Date, entre outros.

Para mover um cartão no n8n, você atualiza a lista dele (Card > Update, campo List ID).

Em Card > Create, List ID e Name são obrigatórios, e os Additional Fields incluem Due Date, Position, Member IDs e Label IDs. Em List > Create, os obrigatórios são Board ID e Name.

Testar o nó Trello

Antes de ligar o Trigger, teste a credencial. Um exemplo: execute List > Get Cards com o ID de uma lista de teste e veja se os cartões aparecem na saída.

Trello Trigger: URL pública e N8N_WEBHOOK_URL

Ao ativar o workflow, o n8n cria um webhook no Trello, informando o endereço de retorno do n8n e o Model ID; ao desativar, apaga o webhook. Segundo a Atlassian, na criação o Trello envia um pedido HEAD para o endereço, e se a resposta não for 200 o webhook não é criado. O n8n responde a esse pedido.

Como o Trello precisa alcançar o n8n, ele precisa estar acessível pela internet, em um endereço público correto; recomendamos HTTPS. Vale conferir isso no seu ambiente. Num n8n atrás de proxy reverso, a documentação do n8n orienta informar o endereço público na variável N8N_WEBHOOK_URL; sem ela, o n8n monta a URL com o protocolo, o host e a porta 5678, e isso não funciona. O exemplo da documentação é N8N_WEBHOOK_URL=https://n8n.example.com/, junto com N8N_PROXY_HOPS=1.

A N8N_WEBHOOK_URL existe a partir do n8n 2.30.0 e substitui a WEBHOOK_URL, depreciada desde a 2.35.0. Em versões anteriores à 2.30.0, use a WEBHOOK_URL.

Ativar e filtrar os eventos

Com a credencial pronta e a variável configurada, ative o workflow que tem o Trello Trigger. O nó não tem seletor de tipo de evento: tudo o que acontece no modelo informado chega ao fluxo. Por isso, filtre depois, com um nó If ou Filter, deixando passar só os eventos que interessam.

Se o Trello não conseguir entregar a chamada, a Atlassian informa que tenta 3 vezes antes de parar e desativa o webhook se ele falhar por 30 dias e mais de 1000 vezes.

Combinações para começar

Um exemplo: um Form Trigger recebe um pedido e o Card > Create abre um cartão com List ID, Name e Description. O artigo HTML no n8n: extrair dados de páginas mostra como tirar dados de uma página para alimentar um fluxo assim.

Um exemplo: o Trello Trigger, com o Model ID do quadro, um filtro para o movimento de cartões e um aviso no Slack ou no Telegram.

Um exemplo de onboarding de cliente: Card > Create, depois Checklist > Create e, por fim, Checklist > Create Checklist Item para cada tarefa. Quem prefere um quadro kanban hospedado no próprio servidor encontra uma opção em Kanboard na VPS: quadro kanban da equipe.

Um exemplo de resumo: um agendamento diário, List > Get Cards e um e-mail com a lista. O artigo Google Calendar no n8n: criar e ler eventos traz outra fonte de dados. Monte e teste cada exemplo no seu próprio n8n antes de usar no dia a dia.

Problemas comuns

  • 401 ou token inválido: confira se o token não foi colado no campo da chave, ou o contrário, e se ele foi gerado para a mesma chave. No Trigger, um OAuth Secret errado também resulta em 401;
  • ID errado: use o ID do JSON, como idList, e não o trecho curto da URL do quadro;
  • O webhook não chega: veja se o n8n tem URL pública com HTTPS, se a N8N_WEBHOOK_URL está certa, se o workflow está ativo e se o Trello recebeu 200 na verificação;
  • Erro 429: a API do Trello limita as chamadas. A Atlassian informa 300 requisições a cada 10 segundos por chave e 100 requisições a cada 10 segundos por token. Ao estourar, a resposta é HTTP 429.

Espaçar as chamadas ajuda a ficar abaixo desses limites.

E o OAuth 2.0 do Trello?

A Atlassian lançou o OAuth 2.0 para o Trello em 15/09/2026. O anúncio oficial diz que os tokens de API continuam e que não há prazo de descontinuação. O nó Trello do n8n continua com a chave e o token de API, o método usado nas etapas acima.

Onde conferir os nomes dos campos

As páginas do nó Trello e do Trello Trigger ficam em docs.n8n.io, e a página de credenciais do Trello explica o preenchimento da chave e do token.

As VPS têm mensalidade em reais na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

Existe uma operação para mover cartão?

Não. Use Card > Update e preencha o List ID com o ID da lista de destino.

Posso escolher o tipo de evento no Trello Trigger?

Não. O nó recebe os eventos do Model ID informado, e o filtro fica por conta de um nó If ou Filter depois dele.

O n8n precisa estar acessível pela internet?

Para o Trello Trigger, sim: o Trello envia pedidos ao endereço do webhook, que precisa ser público; recomendamos HTTPS.

O OAuth Secret é obrigatório?

Não, o campo é opcional. Recomendamos preenchê-lo, porque sem ele a assinatura do webhook não é conferida.

Esta resposta lhe foi útil?

Artigos Relacionados