Como configurar a ação de envio de Webhook
Configurar a ação Disparar Webhook permite integrar a octapipe a sistemas externos, enviando dados automaticamente sempre que regras e eventos forem atendidos
Support Team
Última atualização há 3 meses
1º Passo: Acessando o módulo de administração de automações:
No menu lateral inferior esquerdo, clique em “Automações” para visualizar a listagem.
2º Passo: Criando ou editando uma automação:
Clique em “Nova Automação” para criar uma regra ou selecione uma automação existente para editar.
3º Passo: Definindo entidade e evento:
Selecione a Entidade que será monitorada (ex.: Pipeline Cards, Database Records, Tarefas ou Usuários) e escolha o Evento que vai disparar a automação:
Criar
Atualizar
Excluir
Mover
Tarefa concluída
Todas as tarefas concluídas
Cada entidade possui eventos próprios que podem ser usados conforme o contexto.
4º Passo: Selecionando a ação:
No campo "Ação", escolha "Disparar Webhook".
5º Passo: Aplicando condições (opcional):
Se necessário, adicione condições para restringir quando o webhook deve ser disparado. Configure:
Campo
Operador
Valor
6º Passo: Configurando o Webhook:
Na seção "Configurações", preencha os campos:
Método: escolha o método HTTP que será utilizado (GET, POST, PUT, DELETE).
Endpoint: insira a URL do serviço externo que vai receber os dados.
Headers: adicione cabeçalhos de autenticação ou parâmetros adicionais se necessário.
Body: defina o corpo da requisição. É possível inserir texto, JSON ou outras estruturas de dados.
Você pode utilizar variáveis dinâmicas representadas pelo ícone (x) ao lado do campo para personalizar automaticamente o texto da mensagem, inserindo informações como nome do cliente, responsável pelo card ou número de pedido.
7º Passo: Salvando a automação:
Após revisar, clique em “Criar Automação”. A regra ficará ativa e disparará o webhook sempre que o evento e as condições forem atendidos.
Boas práticas:
Teste o endpoint com ferramentas como Postman antes de integrar na automação.
Use variáveis para enviar dados dinâmicos no body da requisição.
Configure headers de autenticação para conexões seguras.
Monitore logs do sistema externo para validar os recebimentos.
Conclusão:
Você aprendeu como configurar a ação de disparo de Webhook em uma automação, definindo método, endpoint, headers e corpo da requisição, além do uso de variáveis dinâmicas. Esse recurso amplia as possibilidades de integração da octapipe com sistemas externos. Em caso de dúvidas, entre em contato com nosso suporte.