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;
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.
Em gatilhos do tipo Scheduled, é possível definir uma data e hora em Não executar antes de. Essa opção permite configurar a agenda com antecedência para um go-live sem disparar execuções antes do momento planejado. Disparos anteriores à data configurada são ignorados; a automação passa a executar normalmente quando a próxima ocorrência da agenda for igual ou posterior à data/hora inicial.
Exemplo: uma agenda “de hora em hora” com Não executar antes de em 01/07/2026 06:00 começa a considerar execuções a partir de 06:00, depois 07:00, 08:00 e assim por diante.
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 automáticas para falhas de execução. Quando uma execução termina com status de erro, o TunnelHub envia um alerta para cada destinatário configurado na aba Notificações da automação.
Como configurar
Abra a automação e acesse a aba Notificações.
Clique em Adicionar.
Selecione o tipo de notificação.
Informe o e-mail ou a URL de destino.
Escolha o idioma da mensagem, entre português e inglês.
Salve a configuração.
Os canais disponíveis são:
Endereço de e-mail que receberá o alerta.
Informe o endereço do destinatário.
Discord
URL de webhook criada para um canal do Discord.
Crie e copie a URL do webhook em Integrações do servidor. Consulte Introdução a webhooks.
Microsoft Teams
URL de webhook gerada pelo Workflows (Power Automate) para um canal ou chat.
No Teams, abra Workflows, escolha um modelo de alerta por webhook para o canal ou chat, crie o fluxo e copie a URL gerada. Consulte Criar webhooks de entrada com Workflows.
Google Chat
URL de webhook criada para um espaço do Google Chat.
Adicione um webhook em Apps e integrações do espaço e copie a URL. Consulte Criar um webhook.
Slack
URL de Incoming Webhook associada ao canal de destino.
Crie um Incoming Webhook no aplicativo Slack e copie a URL. Consulte Enviar mensagens usando Incoming Webhooks.
Webhook
URL de um endpoint HTTP próprio.
Prepare o endpoint para receber uma requisição POST com conteúdo JSON.
É possível adicionar mais de um destinatário, inclusive usando canais diferentes. URLs de webhook podem conter tokens ou outros dados que permitem publicar mensagens no canal. Trate-as como segredos e não as exponha em repositórios, tickets, logs ou mensagens públicas.
Conteúdo do alerta
A apresentação varia conforme o canal, mas as notificações normalmente incluem:
conta, ambiente, pacote e automação;
início e fim da execução;
totais processados e registros com erro;
mensagem geral de erro;
link para consultar a execução no monitoramento, quando suportado pelo canal.
No webhook genérico, o TunnelHub envia esses dados em JSON e inclui o header TunnelHub-Tenant-Id. O endpoint deve aceitar requisições POST com Content-Type: application/json.
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.
Last updated