Trigger: Projeto / Card

Quando usar

Use este gatilho quando quiser que o workflow reaja a mudancas em projetos e cards. Exemplos comuns:

• Enviar uma notificacao quando um novo card e criado em um projeto


• Atualizar uma tabela externa quando o status de um card muda


• Disparar um e-mail automatico quando um formulario e submetido via card


• Registrar um log toda vez que um projeto e atualizado

---

Como funciona

Ao adicionar este gatilho, voce escolhe o evento que deve disparar o workflow. O Brife monitora continuamente as alteracoes em projetos, cards e views do workspace. Quando o evento configurado acontece, o fluxo e iniciado automaticamente com os dados do evento.

Voce pode filtrar por projeto especifico, campo alterado e ate por valor do campo, permitindo controle granular sobre quando o workflow dispara.

---

Configuracoes

Quando (Evento)

Selecione o evento que ira disparar o workflow. Os eventos estao organizados em tres categorias:

#### Card

| Evento | Descricao |
|--------|-----------|
| Card criado | Dispara quando um novo card e adicionado a qualquer projeto (ou ao projeto filtrado). |
| Card atualizado | Dispara quando qualquer informacao de um card e modificada. |
| Card concluido | Dispara quando um card e marcado como concluido. |
| Card arquivado | Dispara quando um card e movido para o arquivo. |
| Card excluido | Dispara quando um card e removido permanentemente. |
| Campo alterado | Dispara quando um campo especifico de um card tem seu valor alterado. Habilita filtros adicionais de campo e valor. |
| Formulario submetido | Dispara quando um formulario vinculado a um card e preenchido e enviado. |

#### Projeto

| Evento | Descricao |
|--------|-----------|
| Projeto criado | Dispara quando um novo projeto e criado no workspace. |
| Projeto atualizado | Dispara quando as configuracoes ou dados de um projeto sao alterados. |

#### View

| Evento | Descricao |
|--------|-----------|
| View criada | Dispara quando uma nova view e criada dentro de um projeto. |
| View atualizada | Dispara quando as configuracoes de uma view sao modificadas. |

---

No projeto (filtro de projeto)

Aparece apenas para eventos da categoria Card. Permite limitar o gatilho a um projeto especifico.

| Opcao | Descricao |
|-------|-----------|
| Todos os projetos | O workflow dispara para cards de qualquer projeto do workspace. |
| (Projeto especifico) | O workflow dispara apenas para cards do projeto selecionado. |

---

Campo (filtro de campo)

Aparece apenas quando o evento e Campo alterado e um projeto esta selecionado. Permite filtrar qual campo deve ter sido alterado para disparar o workflow.

| Opcao | Descricao |
|-------|-----------|
| Qualquer campo | Dispara quando qualquer campo de selecao ou checkbox e alterado. |
| (Campo especifico)* | Dispara apenas quando o campo selecionado for alterado. Somente campos do tipo **select** e *checkbox aparecem na lista. |

---

Quando valor for (filtro de valor)

Aparece apenas quando um campo especifico esta selecionado e esse campo possui opcoes (select/checkbox). Permite filtrar por um valor especifico.

| Opcao | Descricao |
|-------|-----------|
| Qualquer valor | Dispara independente de qual valor foi selecionado no campo. |
| (Valor especifico) | Dispara somente quando o campo for alterado para o valor escolhido. |

---

Status de conclusao (filtro de conclusao)

Aparece para eventos de Card (exceto "Card concluido"). Permite filtrar cards pelo status de conclusao.

| Opcao | Descricao |
|-------|-----------|
| Qualquer status | Dispara para cards concluidos e nao concluidos. |
| Apenas nao concluidos | Dispara somente para cards que ainda nao foram marcados como concluidos. |
| Apenas concluidos | Dispara somente para cards ja marcados como concluidos. |

---

Dados de saida

Os nodes seguintes no fluxo podem acessar os dados gerados pelo evento:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `event` | Texto | Nome do evento que disparou o workflow (ex: `project.card.created`) |
| `data` | Objeto | Dados completos do card, projeto ou view que sofreu a alteracao |
| `workspaceId` | Texto | Identificador do workspace onde o evento ocorreu |
| `timestamp` | Texto | Data e hora em que o evento aconteceu |

O objeto `data` contera campos diferentes dependendo do evento. Para eventos de card, por exemplo, inclui titulo, campos, responsavel, datas, etc.

---

Dicas

• Use o filtro de projeto especifico para evitar que o workflow dispare para todos os projetos do workspace. Isso melhora a performance e evita execucoes desnecessarias.


• O evento Campo alterado combinado com filtro de valor e muito poderoso. Exemplo: dispare um e-mail quando o campo "Status" de um card mudar para "Aprovado".


• O filtro de status de conclusao e util para evitar processar cards ja finalizados. Por exemplo, ao monitorar "Card atualizado", filtre por "Apenas nao concluidos" para ignorar atualizacoes em cards encerrados.


• Para automacoes de formulario, use o evento Formulario submetido — ele e mais preciso do que monitorar "Card criado" ou "Card atualizado".