Trello
Administrar quadros, listas, cartões, checklists e atividades no Trello.
O que faz
Integre com o Trello para listar, buscar, criar, atualizar e excluir cartões e listas, gerenciar checklists e seus itens, atribuir etiquetas e membros, acompanhar a atividade e adicionar comentários.
Quando usar: Use quando o seu fluxo precisar administrar quadros, listas, cartões, checklists e atividades no Trello.
Exemplo de situação: Organizar o processo e encaminhar cada caso para a etapa certa.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Trello ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Obter listas | Obtém listas com o bloco Trello. |
| Listar cartões | Lista cartões com o bloco Trello. |
| Buscar | Busca com o bloco Trello. |
| Criar cartão | Cria cartão com o bloco Trello. |
| Obter cartão | Obtém cartão com o bloco Trello. |
| Atualizar cartão | Atualiza cartão com o bloco Trello. |
| Excluir cartão | Exclui cartão com o bloco Trello. |
| Obter atividades | Obtém atividades com o bloco Trello. |
| Adicionar comentário | Adiciona comentário com o bloco Trello. |
| Adicionar checklist | Adiciona checklist com o bloco Trello. |
| Adicionar item ao checklist | Adiciona item ao checklist com o bloco Trello. |
| Atualizar item do checklist | Atualiza item do checklist com o bloco Trello. |
| Adicionar etiqueta | Adiciona etiqueta com o bloco Trello. |
| Remover etiqueta | Remove etiqueta com o bloco Trello. |
| Adicionar membro | Adiciona membro com o bloco Trello. |
| Remover membro | Remove membro com o bloco Trello. |
| Listar membros | Lista membros com o bloco Trello. |
| Criar quadro | Cria quadro com o bloco Trello. |
| Obter quadro | Obtém quadro com o bloco Trello. |
| Criar lista | Cria lista com o bloco Trello. |
| Atualizar lista | Atualiza lista com o bloco Trello. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Obter listas · Listar cartões · Buscar · Criar cartão · Obter cartão · Atualizar cartão · Excluir cartão · Obter atividades · Adicionar comentário · Adicionar checklist · Adicionar item ao checklist · Atualizar item do checklist · Adicionar etiqueta · Remover etiqueta · Adicionar membro · Remover membro · Listar membros · Criar quadro · Obter quadro · Criar lista · Atualizar lista
- Padrão:
- Obter listas
Conta do Trello
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Trello
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Quadro
Obrigatório conforme a operaçãoSelecione o quadro do Trello.
- Aparece em:
- Obter listas, Listar cartões, Obter atividades, Obter quadro, Criar lista, Listar membros
- Exemplo:
- (escolha na lista do campo)
ID do quadro
Obrigatório conforme a operaçãoEm campos adicionaisInforme o ID do quadro do Trello.
- Aparece em:
- Obter listas, Listar cartões, Obter atividades, Obter quadro, Criar lista, Listar membros
- Exemplo:
- id-do-recurso
ID da lista
Obrigatório conforme a operaçãoInforme o ID da lista do Trello.
- Aparece em:
- Listar cartões, Criar cartão, Atualizar lista
- Exemplo:
- id-do-recurso
Filtro de listas
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Obter listas
- Opções:
- Em aberto (padrão) · Fechado · Todos
- Exemplo:
- Em aberto (padrão)
Filtro de cartões
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar cartões
- Opções:
- Em aberto (padrão) · Fechado · Todos
- Exemplo:
- Em aberto (padrão)
ID do cartão
Obrigatório conforme a operaçãoInforme o ID do cartão do Trello.
- Aparece em:
- Atualizar cartão, Excluir cartão, Obter atividades, Adicionar comentário, Obter cartão, Adicionar checklist, Atualizar item do checklist, Adicionar etiqueta, Remover etiqueta, Adicionar membro, Remover membro
- Exemplo:
- id-do-recurso
Nome do cartão
Obrigatório conforme a operaçãoInforme o nome do cartão.
- Aparece em:
- Criar cartão, Atualizar cartão
- Exemplo:
- Exemplo de atendimento
Descrição
Informe a descrição do cartão.
- Aparece em:
- Criar cartão, Atualizar cartão
Posição
Em campos adicionaisOnde o novo cartão entra na lista do Trello: top (no topo), bottom (no final) ou um número decimal positivo para uma posição exata.
- Aparece em:
- Criar cartão
- Exemplo:
- top (no topo), bottom (no final) ou um número decimal positivo
Prazo
AAAA-MM-DD ou data e hora no formato ISO 8601.
- Aparece em:
- Criar cartão, Atualizar cartão
- Exemplo:
- AAAA-MM-DD ou data e hora no formato ISO 8601
Status da data de entrega
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar cartão, Atualizar cartão
- Opções:
- Não definir · Concluído · Não concluído
- Exemplo:
- Não definir
IDs das etiquetas
Em campos adicionaisIDs das etiquetas separados por vírgula.
- Aparece em:
- Criar cartão
- Exemplo:
- Exemplo de atendimento
IDs dos membros
Em campos adicionaisIDs dos membros separados por vírgula.
- Aparece em:
- Criar cartão
- Exemplo:
- IDs dos membros separados por vírgula
Arquivamento
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Atualizar cartão
- Opções:
- Manter como está · Arquivar cartão · Reabrir cartão
- Exemplo:
- Manter como está
Mover para a lista (ID)
Informe o ID da lista do Trello.
- Aparece em:
- Atualizar cartão
Filtro de atividades
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Obter atividades
- Exemplo:
- status = 'ativo'
Limite de atividades do quadro
Em campos adicionaisNúmero máximo de atividades do quadro.
- Aparece em:
- Obter atividades
- Exemplo:
- 10
Página de atividades
Em campos adicionaisNúmero da página de atividades do quadro ou do cartão.
- Aparece em:
- Obter atividades
- Exemplo:
- Número da página de atividades do quadro ou do cartão
Desde
Em campos adicionaisData e hora no formato ISO 8601 ou ID da atividade.
- Aparece em:
- Obter atividades
- Exemplo:
- Data e hora no formato ISO 8601 ou ID da atividade
Antes de
Em campos adicionaisData e hora no formato ISO 8601 ou ID da atividade.
- Aparece em:
- Obter atividades
- Exemplo:
- Data e hora no formato ISO 8601 ou ID da atividade
Comentário
Obrigatório conforme a operaçãoInforma o texto que será processado pelo bloco.
- Aparece em:
- Adicionar comentário
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Nome do quadro
Obrigatório conforme a operaçãoInforme o nome do quadro.
- Aparece em:
- Criar quadro
- Exemplo:
- Exemplo de atendimento
Descrição
Informe a descrição do quadro.
- Aparece em:
- Criar quadro
ID da área de trabalho
Em campos adicionaisInforme o ID ou o nome da área de trabalho/organização.
- Aparece em:
- Criar quadro
Listas padrão
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar quadro
- Opções:
- Não definir · Criar listas padrão · Sem listas padrão
- Exemplo:
- Não definir
Nome da lista
Obrigatório conforme a operaçãoInforme o nome da lista.
- Aparece em:
- Criar lista, Atualizar lista
- Exemplo:
- Exemplo de atendimento
Posição da lista
Em campos adicionaisOnde a lista fica no quadro do Trello: top (primeira à esquerda), bottom (última) ou um número decimal positivo para uma posição exata.
- Aparece em:
- Criar lista, Atualizar lista
- Exemplo:
- top (no topo), bottom (no final) ou um número decimal positivo
Arquivamento
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Atualizar lista
- Opções:
- Manter como está · Arquivar lista · Reabrir lista
- Exemplo:
- Manter como está
Mover para o quadro (ID)
Em campos adicionaisInforme o ID do quadro do Trello.
- Aparece em:
- Atualizar lista
- Exemplo:
- id-do-recurso
Nome do checklist
Obrigatório conforme a operaçãoInforme o nome do checklist.
- Aparece em:
- Adicionar checklist
- Exemplo:
- Exemplo de atendimento
Posição do checklist
Em campos adicionaisOnde o checklist entra no cartão do Trello: top (no topo), bottom (no final) ou um número decimal positivo para uma posição exata.
- Aparece em:
- Adicionar checklist
- Exemplo:
- top (no topo), bottom (no final) ou um número decimal positivo
ID do checklist
Obrigatório conforme a operaçãoInforme o ID do checklist do Trello.
- Aparece em:
- Adicionar item ao checklist
- Exemplo:
- id-do-recurso
Nome do item
Obrigatório conforme a operaçãoInforme o nome do item do checklist.
- Aparece em:
- Adicionar item ao checklist
- Exemplo:
- Exemplo de atendimento
Posição do item
Em campos adicionaisOnde o novo item entra no checklist do Trello: top (no topo), bottom (no final) ou um número decimal positivo para uma posição exata.
- Aparece em:
- Adicionar item ao checklist
- Exemplo:
- top (no topo), bottom (no final) ou um número decimal positivo
Começar marcado
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Adicionar item ao checklist
- Opções:
- Desmarcado · Marcado
- Exemplo:
- Desmarcado
ID do item do checklist
Obrigatório conforme a operaçãoInforme o ID do item do checklist.
- Aparece em:
- Atualizar item do checklist
- Exemplo:
- id-do-recurso
Estado
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Atualizar item do checklist
- Opções:
- Manter como está · Concluído · Não concluído
- Exemplo:
- Manter como está
Novo nome do item
Em campos adicionaisInforme o novo nome do item do checklist.
- Aparece em:
- Atualizar item do checklist
- Exemplo:
- Exemplo de atendimento
ID da etiqueta
Obrigatório conforme a operaçãoInforme o ID da etiqueta do Trello.
- Aparece em:
- Adicionar etiqueta, Remover etiqueta
- Exemplo:
- id-do-recurso
ID do membro
Obrigatório conforme a operaçãoInforme o ID do membro do Trello.
- Aparece em:
- Adicionar membro, Remover membro
- Exemplo:
- id-do-recurso
Consulta de busca
Obrigatório conforme a operaçãoInforme o texto da busca (aceita operadores do Trello, como board:, list:, due:).
- Aparece em:
- Buscar
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Onde buscar
Define a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Buscar
- Opções:
- Todos · Somente cartões · Somente quadros
- Padrão:
- Todos
Restringir aos quadros (IDs)
Em campos adicionaisIDs dos quadros separados por vírgula.
- Aparece em:
- Buscar
- Exemplo:
- IDs dos quadros separados por vírgula
Limite de cartões no resultado
Em campos adicionaisNúmero máximo de cartões a retornar (1-1000, padrão 10).
- Aparece em:
- Buscar
- Exemplo:
- 10
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <trello.lists>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<trello.lists> | json | Listas do quadro (id, name, closed, pos, idBoard). |
<trello.cards> | json | Cartões (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete). |
<trello.card> | json | Cartão criado, atualizado ou obtido (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete). |
<trello.board> | json | Quadro criado ou obtido (id, name, desc, url, closed, idOrganization). |
<trello.list> | json | Lista criada (id, name, closed, pos, idBoard). |
<trello.checklist> | json | Checklist criado (id, name, idCard, idBoard, pos). |
<trello.item> | json | Item do checklist criado ou atualizado (id, name, state, pos, idChecklist). |
<trello.labelIds> | json | IDs das etiquetas aplicadas ao cartão depois de adicionar a etiqueta. |
<trello.memberIds> | json | IDs dos membros atribuídos ao cartão depois de adicionar o membro. |
<trello.members> | json | Membros do quadro (id, fullName, username). |
<trello.boards> | json | Quadros que correspondem à busca (id, name, desc, url, closed, idOrganization). |
<trello.actions> | json | Atividades (id, type, date, idMemberCreator, text, memberCreator, card, board, list). |
<trello.comment> | json | Atividade de comentário criada (id, type, date, idMemberCreator, text, memberCreator, card, board, list). |
<trello.count> | number | Quantidade de listas, cartões, quadros, atividades ou membros retornados. |
<trello.success> | boolean | Indica se a exclusão ou remoção foi concluída com sucesso (excluir cartão, remover etiqueta, remover membro). |
<trello.error> | string | Mensagem de erro quando a operação do Trello falha. |
Exemplo de uso
Objetivo: Organizar o processo e encaminhar cada caso para a etapa certa.
- Operação
- Obter listas
- Conta do Trello
- (escolha a conta conectada)
- Quadro
- (escolha na lista do campo)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <trello.lists>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Atualizar evento · Google CalendarAtualizar evento usando a conexão Google Calendar deste workspace.
- Atualizar tarefa · Google TasksAtualizar tarefa usando a conexão Google Tasks deste workspace.
- Compartilhar agenda · Google CalendarCompartilhar agenda usando a conexão Google Calendar deste workspace.
- Convidar participantes · Google CalendarConvidar participantes usando a conexão Google Calendar deste workspace.
- Criar agenda · Google CalendarCriar agenda usando a conexão Google Calendar deste workspace.
- Criar evento · Google CalendarCriar evento usando a conexão Google Calendar deste workspace.