Upnify CRM
← Voltar ao produto

CRM · Integrações

Como configurar e testar webhooks de saída

Envie dados de eventos selecionados do CRM para outro sistema e valide a solicitação antes de depender da automação.

Ilustração editorial do fluxo de um webhook de saída de um evento do CRM até a resposta do sistema externo.

Publicado em 27 de outubro de 2026

Um webhook de saída avisa outro sistema quando ocorre um evento selecionado no CRM. Em vez de exportar registros manualmente, o CRM envia uma solicitação web ao endereço informado. O sistema que recebe os dados pode processá-los e continuar um fluxo, como criar uma tarefa interna quando uma venda é registrada.

O que você precisa: uma URL pública para receber os dados, o evento que deseja enviar e, se necessário, as informações de autenticação exigidas pelo outro sistema. Não use um endereço privado do seu computador.
Diagrama conceitual do fluxo de um webhook de saída de um evento do CRM até a resposta do sistema externo.
O CRM envia uma solicitação quando ocorre o evento configurado; o sistema externo recebe e responde.

Configure o webhook

  1. Acesse CRM > Configurações > Integrações > Webhooks e escolha a opção para adicionar um webhook. É necessário ter permissão para administrar essa configuração.
  2. Defina um nome que identifique o destino e a finalidade, como Avisar o sistema interno sobre uma venda.
  3. Escolha o Evento que iniciará o envio. Confira também os filtros de entidade, campo e valor se quiser limitar quais registros acionam o webhook. Um filtro mais restritivo impede o envio dos demais registros.
  4. Informe a URL de recebimento e selecione o método HTTP combinado com a pessoa responsável pelo sistema externo: GET, POST, PUT ou DELETE.
  5. Configure os cabeçalhos e o tipo de autenticação exigido: nenhuma, Bearer ou API key. Ao usar uma API key, indique se o receptor espera a chave em um cabeçalho ou na consulta da URL. Use uma credencial criada para essa conexão e compartilhe-a com segurança.
  6. Escolha como preparar o corpo da solicitação: payload padrão, mapeamento simples de campos ou JSON avançado. Siga a documentação do receptor; não invente nomes de campos. No mapeamento simples, selecione o tipo de conteúdo aceito pelo sistema.
  7. Ative o reenvio automático somente quando fizer sentido para a integração e salve.
Formulário do CRM para configurar um webhook de saída com evento, URL de destino, método e autenticação.
Confira o evento e o destino antes de salvar. Esta configuração ainda não enviou solicitações.

Teste antes de ativar o fluxo

  1. Na lista, abra o menu de ações do webhook e selecione Teste de execução.
  2. O teste envia uma amostra do evento ao destino para conferir URL, método, autenticação, formato do payload e resposta. Ele não cria um evento real no CRM e, sozinho, não confirma que o receptor salvou os dados.
  3. Compare o payload enviado com a documentação do sistema externo. Confira a resposta mostrada pelo CRM e corrija URL, cabeçalhos ou mapeamento se o receptor rejeitar a solicitação.
  4. Quando o teste funcionar, confira a execução mais recente e o histórico disponível. Depois ative o webhook e acompanhe o primeiro evento real controlado.
Evite duplicidade: se o reenvio automático estiver ativo, o sistema externo precisa reconhecer e tratar notificações repetidas. Peça à pessoa responsável que processe eventos de forma idempotente, para que a mesma notificação não crie uma venda ou tarefa duplicada.

Exemplo

A equipe de operações quer enviar novas vendas ao sistema interno. Ela escolhe o evento de criação de venda, uma URL de recebimento aprovada, o método POST e a autenticação exigida pelo endpoint. O teste confirma que o receptor aceita o formato de amostra; em seguida, a equipe valida uma venda de teste e confirma com o responsável externo que ela foi criada uma única vez.

Se o teste falhar

  • Não há resposta: confira se a URL pode ser acessada pela internet, se usa HTTPS quando exigido e se não depende de uma rede local.
  • O receptor rejeita a solicitação: verifique método, cabeçalhos, credencial e tipo de conteúdo na documentação do sistema.
  • Chegam campos inesperados: compare o payload mostrado pelo CRM com o mapeamento ou JSON configurado.
  • O teste funciona, mas não chegam eventos: confirme se o webhook está ativo, se o evento está correto e se os filtros permitem o registro usado no teste.

Para criar uma conexão personalizada a partir do seu aplicativo, consulte a documentação oficial da API de CRM. Webhooks são úteis para notificar eventos; a API permite consultar ou enviar dados conforme as rotas e permissões documentadas.