# Como funciona o Webhook?

O módulo de Webhooks permite que o sistema envie automaticamente informações para outros sistemas externos sempre que ocorre um evento, como o recebimento de um novo lead. Com isso, você conecta o Apresenta.me a ferramentas de automação, CRMs e plataformas parceiras sem precisar exportar dados manualmente.

No dia a dia, esse recurso é utilizado por equipes que trabalham com integrações externas e precisam que os dados captados no sistema sejam transmitidos em tempo real para outras plataformas. Você configura o endereço de destino, mapeia quais informações devem ser enviadas e define como o sistema deve se comportar ao receber novos dados.

O módulo é acessado pelo painel administrativo e exige permissões específicas para criar, editar ou excluir webhooks. Caso você não visualize alguma dessas opções, entre em contato com o responsável pelas configurações de acesso da sua empresa.

**Rotina:**<span style="white-space: pre-wrap;"> Configurações &gt; Integrações &gt; Webhooks</span>

#### **1. Navegação no módulo**

![Navegação até o módulo de Webhooks](https://ajuda.apresenta.me/uploads/images/gallery/2026-05/n5700-gif-navegacao.gif)

Este GIF mostra o caminho de acesso até a rotina de Webhooks dentro do painel de configurações.

#### **2. Como funciona**

![Tela de listagem de webhooks](https://ajuda.apresenta.me/uploads/images/gallery/2026-05/Dxb01-listagem.png)

Ao acessar o módulo, você visualiza a lista de todos os webhooks já cadastrados. Para cada registro, o sistema exibe o nome, a URL de destino, o tipo e a situação atual. Quando não há nenhum webhook criado, a lista aparece vazia com a mensagem "Não há registros para mostrar".

Na parte superior da tela, há três filtros que facilitam a localização de um webhook específico: a busca inteligente (por texto livre), o filtro por link e o filtro para exibir apenas os webhooks já mapeados. Os botões "Buscar", "Cadastrar" e "Remover" ficam disponíveis conforme as permissões do seu usuário.

<p class="callout info">Você pode controlar quantos registros aparecem por página usando as opções 10, 25, 50, 100 ou 240 no rodapé da listagem.</p>

#### **3. Cadastrando um novo webhook**

![Formulário de cadastro de webhook](https://ajuda.apresenta.me/uploads/images/gallery/2026-05/02-form-cadastro.png)

Clique em "Cadastrar" para abrir o formulário de criação. Você deve preencher o nome do webhook e a URL de destino para onde o sistema enviará os dados. O link gerado pelo sistema aparece automaticamente após salvar o registro pela primeira vez, conforme indicado pelo texto "Salve para gerar o Link".

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Nome do Webhook

</td><td>Identificação interna para reconhecer o webhook na listagem. Use um nome que indique a plataforma ou a finalidade, como "CRM Externo" ou "Automação de Leads".

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>URL para acessar o webhook

</td><td>Endereço do sistema externo que receberá os dados. Deve ser uma URL válida e acessível publicamente. O link interno gerado pelo Apresenta.me só é exibido após o primeiro salvamento.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr></tbody></table>

<p class="callout warning">O link gerado pelo sistema para este webhook só aparece após você salvar o cadastro pela primeira vez. Salve antes de tentar copiar ou compartilhar o endereço.</p>

#### **4. Mapeando os campos enviados**

![Seção de mapeamento de campos do webhook](https://ajuda.apresenta.me/uploads/images/gallery/2026-05/02b-form-cadastro-scroll.png)

Após informar o nome e a URL, você define quais informações serão transmitidas para o sistema externo. Cada campo do lado esquerdo representa um dado disponível no Apresenta.me, e você seleciona na lista suspensa ao lado qual campo do sistema de destino deve receber esse valor. Isso é chamado de mapeamento.

<table id="bkmrk-campo-dispon%C3%ADveldesc" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">Campo disponível

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>ID

</td><td>Identificador único do registro no sistema. Útil para cruzar dados entre plataformas.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Nome

</td><td>Nome do lead ou contato recebido. Campo marcado com asterisco na tela, indicando destaque no envio.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>E-mail

</td><td>Endereço de e-mail do contato. Muito utilizado em integrações com ferramentas de disparo de e-mail.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Fone

</td><td>Número de telefone do contato. Útil para plataformas de comunicação via WhatsApp ou SMS.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Detalhes da origem

</td><td>Informações sobre de onde veio o lead, como nome do portal ou canal de captação.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>ID remoto

</td><td>Identificador do registro no sistema externo, quando houver. Permite rastrear o dado no destino.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>ID lead remoto

</td><td>Identificador específico do lead no sistema de destino. Usado quando a plataforma parceira gera seu próprio código para o contato.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Mensagem

</td><td>Texto livre enviado junto com o lead, como uma mensagem inicial de interesse.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Observações

</td><td>Anotações adicionais vinculadas ao contato ou à origem do lead.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Campanha AD

</td><td>Nome ou identificador da campanha de anúncios que gerou o lead. Ajuda a medir o desempenho de mídia paga.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Finalidade

</td><td>Objetivo do contato, como compra, locação ou temporada.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Gravar próximo recebimento

</td><td>Chave que, quando ativada, faz o sistema registrar o próximo dado recebido por este webhook. Útil para testar o mapeamento com um exemplo real.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<p class="callout info">Você não precisa mapear todos os campos. Mapeie apenas os que fazem sentido para a integração que está configurando. Campos não mapeados simplesmente não são enviados.</p>

#### **5. Resultado após o cadastro**

![Listagem de webhooks após cadastro](https://ajuda.apresenta.me/uploads/images/gallery/2026-05/Z0y03-listagem-final.png)

Depois de salvar, o webhook aparece na listagem com seu nome, a URL configurada, o tipo e a situação. A partir desse momento, o sistema já está pronto para transmitir os dados ao sistema externo sempre que o evento correspondente ocorrer.

Para editar um webhook existente, clique sobre o registro na listagem. Para excluir, selecione o registro e use o botão "Remover". Essas ações dependem das permissões atribuídas ao seu usuário.

<p class="callout danger">A exclusão de um webhook é permanente. Após remover, qualquer integração que dependia desse endereço deixará de funcionar imediatamente.</p>

#### **6. Perguntas frequentes**

**O link gerado pelo sistema não aparece no formulário. O que fazer?**  
O link interno só é gerado depois que você salva o webhook pela primeira vez. Preencha o nome e a URL, clique em salvar e reabra o registro para visualizar o endereço gerado.

**O que significa o filtro "Mapeado" na listagem?**  
Esse filtro exibe apenas os webhooks que já tiveram pelo menos um campo de mapeamento configurado. Use-o para identificar rapidamente quais integrações estão completamente configuradas e quais ainda precisam de atenção.

**Para que serve a opção "Gravar próximo recebimento"?**  
Quando você ativa essa chave, o sistema registra internamente o próximo dado que chegar por este webhook. Isso é útil para verificar se o sistema externo está enviando as informações corretamente e se o mapeamento está funcionando como esperado.

**Não consigo ver o botão "Cadastrar" nem o "Remover". Por quê?**  
Esses botões são exibidos somente para usuários com as permissões correspondentes: "Criar" para cadastrar e "Excluir" para remover. Se você não visualiza essas opções, solicite ao responsável pelas configurações de acesso que ajuste as permissões do seu perfil.

**Posso usar o mesmo webhook para receber leads de origens diferentes?**  
Sim, desde que o sistema externo envie os dados para o mesmo endereço. No entanto, se as origens possuem estruturas de dados diferentes, é recomendável criar um webhook separado para cada uma delas e configurar o mapeamento individualmente.