# Automações

Automações são o núcleo da plataforma de integração do TunnelHub. Elas definem como um fluxo é executado, monitorado e operado ao longo do tempo.

## O que uma automação concentra

Na tela de detalhes, a automação normalmente é organizada em abas como:

* dados básicos;
* gatilhos;
* deploys;
* parâmetros;
* notificações;
* usuários limitados;
* systems;
* Tabelas De/Para e tabelas de conversão;
* histórico de ações.

Dependendo da automação, o produto também expõe execução manual, transporte entre ambientes e histórico de versões.

## Dados básicos

Na configuração básica, o time normalmente define:

* nome e descrição;
* pacote relacionado;
* status;
* URL de repositório, quando deseja rastreabilidade com o código;
* retenção de logs operacionais.

A retenção influencia diretamente a janela disponível para investigação no monitoramento.

## Gatilhos suportados

Atualmente, a plataforma expõe três formas principais de disparo:

* **Webhook**: execução sob demanda por URL.
* **Scheduled**: execução automatizada por agenda.
* **Inbound email**: execução a partir de recebimento de email.

No caso de webhook, o produto pode exigir autenticação conforme a configuração definida. Os modos mais comuns são:

* sem autenticação;
* `BASIC`;
* autenticação por query string;
* autenticação por header.

## Deploys e versões

Cada automação possui histórico de deploys. Esse histórico permite:

* saber quem publicou uma versão;
* acompanhar data e contexto do deploy;
* promover configurações e artefatos entre ambientes por transporte, quando aplicável.

Dependendo do caso, o runtime pode aparecer como `LAMBDA` ou `ECS_FARGATE`.

## Parâmetros e systems associados

Parâmetros permitem externalizar configurações variáveis do código.

Uma automação só recebe em runtime os systems que foram explicitamente associados a ela. Isso reduz acoplamento e melhora o controle operacional.

## Notificações

Você pode configurar notificações para falhas ou situações operacionais relevantes.

Além de email, o produto atual também suporta outros canais conforme o caso, como webhook e integrações de colaboração corporativa.

## Usuários limitados

Automações podem liberar visibilidade seletiva para usuários limitados. Esse recurso é importante quando parceiros ou clientes precisam acompanhar apenas execuções específicas.

## Execução

Depois do deploy, a automação pode ser executada:

* manualmente pelo portal;
* via webhook;
* por agenda;
* por inbound email, quando configurado.

As execuções geram logs de processamento, traces e métricas para investigação.

## Boas práticas

* modele `defineMetadata()` pensando no time que vai operar a execução;
* associe apenas os systems realmente necessários;
* prefira parâmetros, Tabelas De/Para e Sequências a regras rígidas no código;
* revise notificações e retenção de logs antes de colocar a automação em produção.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tunnelhub.io/produto/automations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.