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. Na Empresa Aurora, o formulário de orçamento do site chama esse endereço a cada pedido, e o fluxo cadastra o contato e abre o negócio no CRM.

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.

Monte o fluxo

1. Em Nova automação, clique em Escolher o gatilho e escolha Webhook recebido. A janela do gatilho explica: recebe uma chamada de outro sistema e inicia este fluxo. A URL já aparece ali e pode ser copiada; antes do primeiro Salvar, Gerar outro endereço sorteia outra URL.
2. Clique em Concluído e use o + na saída do gatilho para adicionar o primeiro passo, como Criar contato. Um fluxo novo só salva com pelo menos um passo.
3. Dê um nome no topo do editor e clique em Salvar. A senha do webhook só é criada nesse primeiro Salvar, e aparece uma vez só, dentro do gatilho, em Autenticação. Abra o gatilho, use Copiar senha, guarde a senha e clique em Já guardei a senha.

Configure a URL e a proteção

Clique no gatilho para abrir a configuração. Em URL do webhook:

1. Escolha Produção. É o endereço que executa o fluxo. Use o ícone de copiar ao lado da URL.
2. Escolha o método aceito. O verbo fica no começo da URL: clique nele para escolher POST, GET, PUT, PATCH ou DELETE. Chamada com outro verbo recebe 404.
3. Defina a autenticação. Em Autenticação, Segredo em um cabeçalho já vem escolhido, com Cabeçalho Authorization. O sistema externo precisa enviar a senha nesse cabeçalho. Em Valor esperado, deixe em branco para usar a senha criada no primeiro Salvar, ou digite outra, com pelo menos 8 caracteres. Depois do primeiro Salvar, o Hub guarda só o hash da senha: o campo mostra que ela está definida, e deixar em branco mantém a atual. Com Nenhuma (só a URL), quem tem o endereço dispara o fluxo.
4. Clique em Concluído. Se mudou alguma coisa, clique em Salvar no topo do editor: a configuração do gatilho vale a partir desse momento.

Quando o webhook está sem senha, o painel avisa e oferece Ligar senha.

Teste com uma chamada real

A janela de escuta resolve o problema clássico de configurar às cegas:

1. Em Amostra do corpo, clique em Escutar evento de teste. O Hub escuta por 2 minutos.
2. A URL do webhook passa para Teste sozinha: peça ao sistema externo para chamar essa URL. Ela aceita qualquer verbo e não executa o fluxo: só captura o corpo. Enquanto o Hub escuta, a configuração do gatilho fica travada.
3. Quando a chamada chega, aparece o aviso Evento de teste recebido no canto da tela, e o gatilho diz “Amostra recebida. Os campos estão em Resultado, prontos para usar nos passos.” Os campos do corpo aparecem na Saída do gatilho.
4. Se nada chegar, o aviso diz que a janela de teste expirou sem receber nada. Use Parar de escutar e revise a URL do lado de fora.

Com a amostra recebida, os campos do corpo aparecem em Inserir dado do fluxo nos passos seguintes, e cada um com o tipo que veio na amostra. Um e-mail do corpo, por exemplo, aparece em Do fluxo num campo de e-mail do passo Criar contato: no E-mail, escolha Dado do fluxo, clique no botão de dados ao lado do campo e escolha o e-mail. Um texto comum aparece nos campos de texto livre, mas não num campo que escolhe um registro.

Dê um nome a cada chamada

Sem nome, toda chamada aparece em Execuções como Chamada do webhook. Para achar a chamada de um lead:

1. No gatilho, vá em Nome da execução.
2. Insira um dado do corpo, como o nome do lead. Dá para juntar dois, como o nome e o e-mail.
3. Clique em Salvar.

A partir daí, cada chamada aparece em Execuções com o nome do lead. As chamadas que já aconteceram continuam como Chamada do webhook. O nome aceita até 255 caracteres.

Ligue

Com o teste recebido e os passos preenchidos, clique em Ligar. Uma chamada que chega com o fluxo desligado, com o segredo errado ou com o verbo errado é recusada, e o motivo aparece em Chamadas recusadas, no próprio gatilho.

Como saber que deu certo

• O gatilho mostrou Evento de teste recebido com o conteúdo esperado.
• Depois da primeira chamada real, a execução aparece em Execuções, com o nome escolhido em Nome da execução.
• 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.
• Acompanhar execuções: conferir cada chamada recebida.
• MCP: o Hub nas mãos da sua IA: quando o de fora é um assistente, não um sistema.