Chamar um sistema externo no meio do fluxo

Nem tudo que precisa saber de um acontecimento mora no Hub. O ERP que controla a produção, a planilha que o financeiro mantém, o serviço que a sua empresa escreveu: a ação Chamar webhook externo liga o fluxo a qualquer um deles.

Antes de começar

• O endereço que vai receber a chamada, e a informação de como ele espera ser autenticado.
• Acesso ao app Automações com permissão de gerenciar.
• Clareza sobre o que o sistema externo faz com a chamada. Uma automação que dispara ação irreversível lá fora merece condição bem apertada aqui dentro.

Adicione a chamada ao fluxo

1. No editor, use Adicionar passo e escolha Chamar webhook externo.
2. Informe a URL do sistema que vai receber.
3. Monte o corpo da chamada. Nos campos de texto você mistura valor fixo com dados do fluxo: use Inserir token do gatilho para pegar o nome do cliente, o valor do negócio ou o identificador do registro.
4. Configure os cabeçalhos que o sistema externo exigir, incluindo o de autenticação.
5. Salve o fluxo.

Use a resposta nos passos seguintes

A ação devolve dois dados para o fluxo:

O desenho mais útil é pendurar uma Condição logo abaixo, olhando o status: no caminho Sim o fluxo segue, no caminho Não ele avisa alguém de que a integração falhou.

Teste antes de ativar

Use Testar fluxo e acompanhe o passo no histórico. Como a chamada sai de verdade, teste primeiro contra um endereço de homologação do lado de fora, e só depois troque para o endereço definitivo.

Como saber que deu certo

• No histórico da execução, o passo aparece como ok.
• O status devolvido é o de aceite esperado pelo sistema externo.
• O efeito existe do outro lado: o registro criado no ERP, a linha na planilha, o pedido recebido.

Problemas comuns

Próximo passo

• Disparar uma automação a partir de um sistema de fora: o caminho inverso.
• Condição, espera e caminhos diferentes: ramificar pelo status devolvido.
• MDC: seus dados externos dentro do Hub: quando o que você quer é ler dados de fora, não avisar.