Chamar um sistema externo no meio do fluxo
O passo Requisição HTTP avisa um sistema seu (ERP, planilha, serviço próprio) e devolve a resposta para os próximos passos do fluxo usarem.
Guias do Automações 2
Etapa 1 de 4
Adicione a chamada: destino e autenticação
O passo Requisição HTTP, o método, a URL de destino e a autenticação.
-
Na Empresa Aurora, a automação avisa o ERP de homologação quando um negócio é ganho no funil Vendas. Dê um nome a ela no topo do editor.
-
No canvas, use o + depois do passo certo.
-
Em Integrações, escolha Requisição HTTP. O passo abre na bancada.
-
Em Método, escolha o verbo (aqui, POST) e preencha a URL de destino do sistema que vai receber. Comece por um endereço de homologação.
-
Em Autenticação, escolha o que o sistema externo exige: Bearer token, Basic, Cabeçalho personalizado ou Credencial. O valor fica mascarado.
Etapa 2 de 4
Adicione a chamada: corpo
O que vai na chamada, com dados do fluxo, e o Salvar.
-
Em Corpo, o padrão é Envelope com os dados do fluxo, que manda tudo o que veio da entrada. Para escolher campo a campo, escolha JSON.
-
Dê o nome do campo e use Inserir dado do fluxo para trazer o valor, como o nome e o valor do negócio. O dado entra como um chip.
-
Clique em Salvar.
Etapa 3 de 4
Use a resposta nos passos seguintes
Status HTTP e corpo da resposta, e uma Condição no status.
-
Em Resultado, o passo devolve Status HTTP, Corpo da resposta (JSON) e Corpo da resposta (texto) para os passos seguintes.
-
Volte ao canvas, use o + depois da Requisição HTTP e escolha Condição, em Lógica do fluxo.
-
Na regra, escolha Status HTTP e o valor de aceite do sistema externo, como 200.
-
No caminho Sim o fluxo segue; no caminho Não, avise alguém de que a integração falhou.
Etapa 4 de 4
Teste antes de ligar
A chamada sai de verdade, com confirmação.
-
Clique em Testar fluxo, no rodapé do canvas.
-
Como a chamada sai de verdade, o Hub lista a Requisição HTTP em Executar ações reais deste fluxo? e só segue se você confirmar.
-
Os passos marcam o andamento no canvas. Em Ver execução, a Requisição HTTP aparece como Concluído, com o Status HTTP devolvido.
Precisa de mais? Abra um chamado dentro do Hub.
Ler este passo a passo em texto
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: o passo Requisição HTTP liga o fluxo a qualquer um deles.
Na Empresa Aurora, a automação Avisar o ERP quando o negócio é ganho usa o gatilho Negócio ganho, no funil Vendas, e manda ao ERP de homologação o nome e o valor do negócio.
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: destino e autenticação
- No canvas, use o + depois do passo certo e escolha Requisição HTTP, em Integrações. O passo abre na bancada.
- Em Método, escolha o verbo (GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS) e preencha a URL de destino do sistema que vai receber. Logo abaixo ficam os Parâmetros da URL.
- Em Autenticação, escolha o tipo que o sistema externo exige: Nenhuma, Bearer token, Basic · usuário e senha, Cabeçalho personalizado ou Credencial (cabeçalho Authorization). O token e a senha ficam mascarados. Em Cabeçalhos, acrescente o que mais o sistema pedir.
Adicione a chamada: corpo
- Em Corpo, escolha o Formato do corpo, nos métodos que enviam conteúdo. O padrão é Envelope com os dados do fluxo, que envia o evento, a data, uma observação e todos os dados da entrada. Para escolher campo a campo, use JSON; há também Formulário · URL encoded, Texto e Sem corpo.
- No JSON, dê o nome de cada campo e misture valor fixo com dados do fluxo: use Inserir dado do fluxo para pegar o nome do cliente, o valor do negócio ou o identificador do registro. O dado entra como um chip. Em Editar JSON em código, o editor aponta a linha e a coluna do erro.
- Clique em Salvar.
Use a resposta nos passos seguintes
O passo devolve estes dados para o fluxo, e eles aparecem em Resultado na bancada:
| Dado | Para que serve |
|---|---|
| Status HTTP | Saber se a chamada foi aceita, e ramificar quando não foi |
| Corpo da resposta (JSON) | Aproveitar, campo por campo, o que o sistema externo devolveu |
| Corpo da resposta (texto) | Usar a resposta inteira quando ela não é JSON |
O desenho mais útil é pendurar uma Condição logo abaixo, olhando o status: use o + depois da Requisição HTTP, escolha Condição em Lógica do fluxo e, na regra, escolha Status HTTP e o valor de aceite do sistema externo, como 200. No caminho Sim o fluxo segue, no caminho Não ele avisa alguém de que a integração falhou.
Teste antes de ligar
Use Testar fluxo. Como a chamada sai de verdade, o Hub lista a Requisição HTTP em Executar ações reais deste fluxo? e só roda se você confirmar em Executar ações reais. Teste primeiro contra um endereço de homologação do lado de fora, e só depois troque para o endereço definitivo. Ao fim, Ver execução abre o relatório: a Requisição HTTP aparece como Concluído, com o Status HTTP devolvido.
Como saber que deu certo
- Em Execuções, o passo aparece como Concluído.
- O Status HTTP 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
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O passo aparece como Falhou, vai tentar de novo | O sistema externo recusou ou não respondeu | Abra o passo no relatório da execução e leia o motivo e os Detalhes técnicos |
| O passo Esgotou as tentativas | Falhou nas três tentativas, com espera crescente entre elas | Corrija do lado de fora e use Tentar de novo no passo |
| O sistema externo recebe o corpo vazio | Os campos foram preenchidos com dados que aquele gatilho não carrega | Use Inserir dado do fluxo em vez de digitar o dado na mão |
| Autenticação recusada | O cabeçalho está ausente ou com o valor errado | Confira o cabeçalho exigido pelo sistema externo |
| Ele foi chamado várias vezes pelo mesmo caso | O fluxo permite reinscrição para um caso que roda uma vez | Ajuste a reinscrição em Configurações, no gatilho |
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.
Continue por aqui
Não resolveu?
Abra um chamado pelo botão de suporte dentro do Hub. Nosso time responde e, quando é problema de produto, ele vira uma correção rastreável.