Disparar uma automação a partir de um sistema de fora

Quando o acontecimento que interessa nasce fora do Hub, o caminho é o contrário do normal: em vez de o Hub escutar um app interno, ele oferece um endereço para o sistema de fora avisar. É o gatilho Webhook recebido.

Antes de começar

• Acesso ao app Automações com permissão de gerenciar.
• Alguém do lado do sistema externo capaz de configurar a chamada, ou uma ferramenta que faça isso.
• O fluxo precisa estar salvo antes de o gatilho ser configurado. Antes disso o editor mostra Salve o fluxo antes de configurar o gatilho.

Monte o fluxo

1. Em Nova automação, escolha o gatilho Webhook recebido. O editor explica: um sistema externo chama uma URL e inicia este fluxo.
2. Monte os passos que devem acontecer quando a chamada chegar.
3. Salve o fluxo.

Configure a URL e o segredo

Na configuração do gatilho, o painel traz duas URLs e o controle de proteção:

1. Copie a URL de Produção. É o endereço definitivo do fluxo. Use Copiar URL para não errar um caractere.
2. Escolha o método aceito. O painel deixa restringir o verbo da chamada, para o fluxo recusar o que não for o combinado.
3. Defina o segredo. O sistema externo precisa enviar esse valor no cabeçalho Authorization. Sem ele, a chamada é recusada com a mensagem de segredo ausente ou incorreto.
4. Salve. A confirmação aparece como Gatilho salvo.

Quando o endereço vazar ou o segredo cair em mão errada, use a opção de sortear outro endereço para este webhook. A URL antiga deixa de valer.

Teste com uma chamada real

O painel tem uma janela de escuta que resolve o problema clássico de configurar às cegas:

1. Clique em Escutar evento de teste. O Hub passa a aguardar uma chamada.
2. Peça ao sistema externo para chamar a URL de teste.
3. Quando a chamada chegar, o painel mostra Evento de teste recebido e você vê o conteúdo que veio.
4. Use esse conteúdo para preencher os campos dos passos, em vez de adivinhar o nome de cada dado.
5. Se nada chegar, o painel avisa que a janela de teste expirou sem receber nada. Use Parar de escutar e revise a URL e o segredo do lado de fora.

Ative

Com o teste recebido e os passos preenchidos, ative o fluxo. Uma chamada que chega em fluxo desativado é registrada com o aviso de que o fluxo estava desativado, então dá para diagnosticar sem perder a chamada.

Como saber que deu certo

• O painel mostrou Evento de teste recebido com o conteúdo esperado.
• Depois da primeira chamada real, a execução aparece em Execuções com os passos executados.
• O sistema de fora recebe a resposta de aceite em vez de uma recusa.

Problemas comuns

Próximo passo

• Chamar um sistema externo no meio do fluxo: o caminho inverso, do Hub para fora.
• MCP: o Hub nas mãos da sua IA: quando o de fora é um assistente, não um sistema.
• Acompanhar execuções: conferir cada chamada recebida.