Trello

ACTIVEVersão 1.0.0Atlassian

Crie cartões e reaja a mudanças em quadros do Trello.

Ver como JSON

Pré-requisitos

• uma conta no Trello com acesso ao quadro;
• permissão no iBPMS para criar ou selecionar conexões;
• a API Key e o Token gerados em trello.com/app-key.

trello.json

{
  "schemaVersion": 1,
  "key": "trello",
  "name": "Trello",
  "description": "Crie cartões e reaja a mudanças em quadros do Trello.",
  "category": "productivity",
  "vendor": "Atlassian",
  "version": "1.0.0",
  "status": "ACTIVE",
  "credentials": [
    {
      "type": "BASIC",
      "usernameLabel": "API Key",
      "usernamePlaceholder": "sua API key do Trello",
      "secretLabel": "Token",
      "secretPlaceholder": "seu token do Trello",
      "helpText": "Gere a API Key e o Token em trello.com/app-key (o Token fica no link 'Token' da mesma página).",
      "helpUrl": "https://trello.com/app-key"
    }
  ],
  "actions": [
    {
      "key": "card.create",
      "name": "Criar cartão",
      "description": "Cria um cartão numa lista do quadro, com dados do processo.",
      "inputs": [
        {
          "key": "listId",
          "label": "Lista (list id)",
          "type": "TEXT",
          "required": true,
          "description": "Id da lista onde o cartão será criado."
        },
        {
          "key": "name",
          "label": "Título",
          "type": "TEXT",
          "required": true,
          "description": "Aceita expressões do processo."
        },
        {
          "key": "desc",
          "label": "Descrição",
          "type": "TEXT",
          "required": false
        }
      ],
      "outputs": [
        {
          "key": "id",
          "label": "Id",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "url",
          "label": "Url",
          "type": "OUTPUT",
          "required": false
        }
      ]
    }
  ],
  "triggers": [
    {
      "key": "card.updated",
      "name": "Cartão atualizado",
      "description": "Dispara quando um cartão do quadro é criado, movido ou alterado.",
      "mode": "PUSH",
      "exclusiveByConnection": false,
      "inputs": [
        {
          "key": "boardId",
          "label": "Quadro (board id)",
          "type": "TEXT",
          "required": true,
          "description": "Id do quadro a observar. Ex.: 5f2a1b3c4d5e6f7a8b9c0d1e"
        }
      ],
      "events": [
        {
          "type": "GENERIC"
        }
      ]
    }
  ]
}

Gerando API Key e Token

1. Acesse trello.com/app-key e copie a API Key.
2. Na mesma página, use o link Token para gerar um token.
3. Cole a API Key e o Token nos campos de credencial do iBPMS.

Proteja a credencial

Guarde o segredo apenas no campo de credencial do iBPMS. Não o coloque em regras, Markdown, capturas de tela ou logs.

Credenciais

Credencial

Token

BASIC

Gere a API Key e o Token em trello.com/app-key (o Token fica no link 'Token' da mesma página).

Campo	Formato esperado
API Key	sua API key do Trello
Token	seu token do Trello

Abrir guia do provedor

Ações disponíveis

Ação

Criar cartão

card.create

Cria um cartão numa lista do quadro, com dados do processo.

Entradas

Campo	Tipo	Obrigatório	Descrição
listIdLista (list id)	TEXT	Sim	Id da lista onde o cartão será criado.
nameTítulo	TEXT	Sim	Aceita expressões do processo.
descDescrição	TEXT	Não	—

Saídas

Campo	Tipo	Obrigatório	Descrição
idId	OUTPUT	Não	—
urlUrl	OUTPUT	Não	—

Chamada

{
  "connection": "trello-producao",
  "operation": "card.create",
  "inputs": {
    "listId": "{{ context.listId }}",
    "name": "{{ context.name }}",
    "desc": "{{ context.desc }}"
  }
}

Resposta

{
  "id": 123,
  "url": "…"
}

Triggers disponíveis

Trigger

Cartão atualizado

PUSH

Dispara quando um cartão do quadro é criado, movido ou alterado.

Configuração

Campo	Tipo	Obrigatório	Descrição
boardIdQuadro (board id)	TEXT	Sim	Id do quadro a observar. Ex.: 5f2a1b3c4d5e6f7a8b9c0d1e

Eventos normalizados

• GENERIC

Evento recebido

{
  "event": "GENERIC",
  "data": {
    "boardId": "{{ context.boardId }}"
  }
}

Limitações

• esta credencial usa dois campos: a API Key identifica a aplicação e o Token autoriza a conta;
• o trigger de cartão atualizado depende de um webhook ativo no quadro;
• o token enxerga apenas os quadros da conta que o gerou.

Erros comuns

Sintoma	Possível causa	Correção
401 nas chamadas	Token expirado ou revogado	Gere um token novo em trello.com/app-key.
Cartão não criado	Lista de destino inexistente	Confirme o identificador da lista no quadro.
Eventos não chegam	Webhook do quadro inativo	Reative o trigger para recriar o webhook.

Veja também

• Todos os conectores
• Integrações
• Solução de problemas