Automações

Automações permitem definir regras Gatilho → Condições → Ações que executam tarefas automaticamente quando eventos ocorrem no projeto, reduzindo trabalho manual repetitivo.

Acesse em Configurações do Projeto → Automações.

Estrutura de uma Regra

Quando [GATILHO] acontece
E [CONDIÇÕES] são verdadeiras (opcional)
Então [AÇÕES] são executadas

Cada regra possui:

Nome — identificação da regra
Ativo / Inativo — toggle para habilitar ou desabilitar sem excluir
Um gatilho — o evento que dispara a regra
Zero ou mais condições — filtros opcionais aplicados à issue
Uma ou mais ações — o que acontece quando a regra é ativada

Gatilhos Disponíveis

Gatilho	Quando dispara
`issue.created`	Uma nova issue é criada no projeto
`issue.updated`	Campos de uma issue são atualizados (exceto status)
`status.changed`	O status de uma issue muda

Condições Disponíveis

Condições são opcionais e avaliadas com lógica AND — todas devem ser verdadeiras para a ação executar.

Campo	Operadores disponíveis	Valores de exemplo
`priority`	`equals`, `not_equals`, `contains`	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `TRIVIAL`
`type`	`equals`, `not_equals`, `contains`	`EPIC`, `STORY`, `TASK`, `BUG`, `SUBTASK`, `IMPROVEMENT`, `HOTFIX`, `SPIKE`, `RESEARCH`, `TECHNICAL_DEBT`
`status`	`equals`, `not_equals`, `contains`	Nome exato do status configurado no projeto

Ações Disponíveis

Ação	Descrição
`send_email`	Envia um email para os destinatários configurados
`set_status`	Move a issue para um status específico
`assign_user`	Atribui a issue a um usuário do projeto

Detalhes: Envio de Email (`send_email`)

Configure o assunto, o corpo do email e os destinatários:

Tipo de destinatário	Descrição
`REPORTER`	Quem criou a issue
`ASSIGNEE`	Responsável(is) pela issue
`PROJECT_ADMINS`	Todos os membros com papel `PROJECT_ADMIN`
`ORG_OWNER`	Membro(s) com papel `OWNER` na organização
`CUSTOM`	Um endereço de email específico informado manualmente

SMTP customizado por regra:

Cada ação send_email pode usar um servidor SMTP próprio, independente do SMTP global da plataforma:

Campo	Descrição
Host	Endereço do servidor SMTP (ex.: `smtp.gmail.com`)
Porta	`587` para STARTTLS · `465` para SSL/TLS direto
Usuário	Login ou email do SMTP
Senha	Senha do SMTP

Atenção com a porta: use 465 para SSL/TLS e 587 para STARTTLS. Configurar a porta incorreta causa timeout de conexão.

Se nenhum SMTP customizado for configurado, o sistema usa o SMTP global da plataforma.

Exemplos de Regras

Notificar admins ao mudar status

Gatilho: status.changed
Condição: status equals "Em Revisão"
Ação: send_email → PROJECT_ADMINS
      Assunto: Issue em revisão

Atribuir responsável em bugs críticos

Gatilho: issue.created
Condição: type equals BUG AND priority equals CRITICAL
Ação: assign_user → [usuário selecionado]

Mover hotfix para andamento automaticamente

Gatilho: issue.created
Condição: type equals HOTFIX
Ação: set_status → "Em Andamento"

Ordem de Execução

Quando múltiplas regras são disparadas pelo mesmo evento, elas executam na ordem de criação.

As automações executam de forma assíncrona, após o commit da transação que gerou o evento — garantindo que a issue esteja completamente salva antes de qualquer processamento.

Acompanhamento

Cada regra exibe um contador de execuções na listagem de automações. Erros de execução (ex.: falha no envio de email por SMTP incorreto) são registrados nos logs do servidor.

Use a Navegação lateral para explorar toda a Documentação.