Engage · Integrações

Como configurar e testar webhooks do Engage

Conecte um widget de formulário a um serviço externo e valide o recebimento com dados de teste.

Especialista conecta um formulário web a um serviço externo por meio de linhas conceituais e elementos tridimensionais, com o logotipo oficial da Upnify

Publicado em 5 de novembro de 2026

Um webhook permite que um widget de formulário do Engage envie informações para um endereço da web que recebe solicitações. Ele pode conectar um formulário do site a um serviço da empresa, iniciar uma automação ou entregar dados a um sistema sem integração direta com o Engage.

Antes de configurar. Você precisa de um widget de formulário e da URL do serviço que receberá os dados. Peça à pessoa responsável por esse sistema que confirme o método HTTP aceito, o formato dos dados, a autenticação necessária e a resposta que será retornada. A tela do Engage não define esses detalhes por conta própria.

Onde configurar

Os Web Hooks são configurados dentro de cada widget que coleta informações. Não é uma configuração global para todos os sites nem equivale aos webhooks de saída do CRM. No Engage, acesse Configurações > Widgets, localize o widget de formulário e escolha editá-lo.

Lista de widgets do Engage com controles para abrir e administrar um widget — Abra o widget de formulário que será associado ao destino externo.

Configure o destino

No editor do widget, abra Web Hooks e integrações.
Ative Web Hook e informe um nome que identifique o sistema que receberá os dados.
Escolha o método esperado pelo serviço. A configuração observada oferece POST e PUT; confirme qual deles o endpoint aceita antes de salvar.
Informe a URL completa do endpoint. Use um endereço HTTPS e confirme que ele pertence a um sistema administrado pela sua equipe.
Verifique se também será necessária outra integração do widget, como Zapier ou Make. Salve o widget depois de conferir os valores.

Editor de widget do Engage mostrando Web Hooks e integrações com campos de nome, método e URL — A URL e o método precisam corresponder ao que o serviço receptor aceita.

Como testar com segurança

Faça o primeiro teste em um ambiente controlado e com dados fictícios. Use um endpoint de teste administrado pela equipe que permita consultar as solicitações recebidas. Envie o formulário de teste pela página onde o widget está instalado e verifique se o receptor recebeu a solicitação, quais campos chegaram e qual resposta foi retornada.

A configuração do editor não especifica um esquema de dados universal nem um botão de teste separado. Por isso, combine com a equipe de desenvolvimento quais campos devem chegar e como o sistema receptor validará a solicitação. Não conecte dados de clientes a um serviço não revisado nem publique uma URL de teste em um site de produção.

Exemplo. Uma empresa recebe solicitações de demonstração por um formulário. A equipe técnica configura um endpoint de teste e combina receber nome, e-mail e assunto de interesse. Antes de ativar a conexão para visitantes, envia uma solicitação fictícia e confirma nos registros do receptor se os dados e a resposta estão corretos.

Se as informações não chegarem

Confirme se o widget correto foi editado e se as alterações foram salvas.
Verifique se a URL está completa, sem erros de digitação e usa HTTPS.
Confirme com a pessoa responsável pelo endpoint se o método configurado e a autenticação atendem aos requisitos.
Consulte os registros do serviço receptor para saber se a solicitação chegou e qual resposta foi retornada.
Se o receptor rejeitar ou não processar a solicitação, peça à equipe de desenvolvimento que revise o formato esperado, o acesso à rede e as validações.

Quando o teste controlado funcionar, documente o endpoint de produção e valide-o novamente antes de receber dados reais.