# Como configurar o webhook da WavUps CRM

> O webhook da WavUps CRM envia um POST para a URL que você escolher sempre que um lead, atendimento ou agendamento é criado, editado ou excluído. Um administrador configura no menu **Webhook**: liga **Webhook ativo**, informa a **URL de destino**, escolhe os eventos e objetos e clica em **Salvar configuração**.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/integracoes/webhook (atualizado em 8 de outubro de 2026)

## Antes de começar

- O webhook faz parte do acesso à API e está disponível nos planos **Pro** e **Advanced**.
- Só **administradores** e o proprietário da conta alteram o webhook. Membros veem a tela, mas não editam.
- Você precisa de uma URL pública na internet, de preferência com HTTPS, que aceite requisições POST.

## Passo a passo: configurar o webhook

### Passo 1: Abra o menu Webhook

No menu lateral, em **Configurações**, clique em **Webhook**.

![Tela Webhook com o item do menu lateral, e o selo de situação.](https://crm.wavups.com/images/docs/integracoes-webhook.png)

### Passo 2: Ligue e informe a URL

Na seção **Configuração**, ligue **Webhook ativo** e preencha a **URL de destino** (por exemplo, `https://api.suaempresa.com.br/webhooks/wavups`).

![Configuração do webhook com o webhook ligado e a URL de destino preenchida.](https://crm.wavups.com/images/docs/integracoes-webhook-preenchido.png)

### Passo 3: Escolha eventos e objetos

Em **Eventos**, marque quando avisar: **Criação**, **Edição** e/ou **Exclusão**. Em **Objetos rastreados**, marque o que acompanhar: **Atendimentos**, **Agendamentos** e/ou **Leads**.

![Configuração do webhook com os eventos Criação e Edição e os objetos Leads e Agendamentos marcados.](https://crm.wavups.com/images/docs/integracoes-webhook-preenchido.png)

### Passo 4: Gere o token (recomendado)

Em **Token de autenticação**, clique em **Gerar token** e copie antes de salvar: depois ele não é exibido de novo.

![Seção Token de autenticação do webhook com o token gerado e o botão Gerar token.](https://crm.wavups.com/images/docs/integracoes-webhook-token.png)

### Passo 5: Salve

Clique em **Salvar configuração**. Aparece **Webhook salvo!** e o selo do topo muda para **Ativo**. As mudanças valem assim que você salva.

![Rodapé da configuração do webhook com o botão Salvar configuração destacado.](https://crm.wavups.com/images/docs/integracoes-webhook-salvar.png)

## Eventos e objetos

| Opção | Quando dispara |
| --- | --- |
| **Criação** | Quando um registro novo é criado. |
| **Edição** | Quando os dados de um registro mudam. |
| **Exclusão** | Quando um registro é removido. |
| **Atendimentos** | Atendimentos ao cliente no painel. |
| **Agendamentos** | Eventos, reuniões e compromissos da agenda. |
| **Leads** | Contatos e oportunidades do CRM. |

É preciso escolher pelo menos um evento e um objeto. Cada disparo envia um POST com os dados do registro.

## Token de autenticação

O token vai no cabeçalho `WavToken` de cada requisição para a sua API confirmar que ela veio da WavUps CRM. É opcional, mas recomendado.

- **Gerar token** cria um token aleatório. Você também pode digitar o seu.
- Com token salvo, aparece **Token configurado**. Para tirar, clique em **Remover** e salve; antes de salvar, **Desfazer** cancela a remoção.
- Não coloque usuário e senha dentro da URL. Use o token.

## Disparos e histórico de entregas

A seção **Disparos** mostra um gráfico com o volume de envios nas **Últimas 24 horas**, nos **Últimos 7 dias**, nos **Últimos 30 dias** ou nos **Últimos 6 meses**.

![Seções Disparos e Histórico de entregas do webhook, com o seletor de período e o botão Atualizar.](https://crm.wavups.com/images/docs/integracoes-webhook-entregas.png)

A seção **Histórico de entregas** lista as 100 entregas mais recentes, com **Situação**, **Evento**, **Destino**, **Tentativas** e **Data**. Clique em **Atualizar** para ver as novas.

| Situação | O que significa |
| --- | --- |
| **Entregue** | A sua API recebeu e respondeu com sucesso. |
| **Tentando de novo** | A entrega falhou e uma nova tentativa vai ser feita. |
| **Falhou** | Todas as tentativas falharam. Veja o erro nos detalhes da entrega. |

Clique numa entrega para abrir os **Detalhes da entrega**: evento, objeto, tentativas, duração, código HTTP e, para administradores, o **Conteúdo enviado** (com **Copiar JSON**) e a **Resposta da sua API**.

> **Quem vê o conteúdo das entregas**
> Só administradores e o proprietário da conta veem a URL, o conteúdo enviado, a resposta e o erro de cada entrega. Membros veem apenas os dados gerais: evento, objeto, tentativas, duração e código HTTP.

## Se algo der errado

| Mensagem ou situação | O que fazer |
| --- | --- |
| **Informe uma URL válida, começando com http:// ou https://.** | Confira o endereço completo da sua API. |
| **A URL precisa apontar para um endereço público na internet** | Não use localhost nem IPs de rede interna. Publique o endpoint na internet. |
| **Não encontramos esse endereço. Confira a URL.** | O domínio não existe ou foi digitado errado. |
| **A URL não pode conter usuário e senha.** | Tire o usuário e a senha da URL e use o token de autenticação. |
| **Escolha ao menos um evento.** / **Escolha ao menos um objeto.** | Marque pelo menos uma opção em cada lista. |
| **Disponível nos planos Pro e Advanced** | Mude de plano em **Meu plano** para ativar o webhook. |
| Entregas com **Falhou** | Abra a entrega, veja o código HTTP e a resposta da sua API, corrija o endpoint e acompanhe as próximas entregas. |

## Na prática

### ERP sempre atualizado

**Situação:** Uma distribuidora cadastra os clientes no ERP e no CRM, e os dois ficavam diferentes.

**Como a WavUps CRM ajuda:** Ela liga o webhook para **Leads** com **Criação** e **Edição**, e o ERP atualiza o cadastro a cada aviso.

### Agenda em outro sistema

**Situação:** Uma clínica usa um sistema de prontuário que precisa saber das consultas marcadas.

**Como a WavUps CRM ajuda:** O webhook de **Agendamentos** avisa o sistema da clínica a cada consulta criada, alterada ou excluída.

## Perguntas frequentes

### Dá para enviar um teste do webhook?

Não há um botão de teste. Crie ou edite um registro de teste (por exemplo, um lead) e acompanhe a entrega em **Histórico de entregas**.

### O webhook avisa sobre conversas e mensagens?

Não. Hoje os objetos rastreados são **Atendimentos**, **Agendamentos** e **Leads**.

### Como desligo o webhook sem perder a configuração?

Desligue **Webhook ativo** e clique em **Salvar configuração**. O selo do topo muda para **Desativado**.

## Veja também

- [Como criar e usar a chave de API da WavUps CRM](https://crm.wavups.com/docs/integracoes/chave-de-api)
- [Como receber leads dos anúncios do Facebook e Instagram na WavUps CRM](https://crm.wavups.com/docs/integracoes/meta-business-leads-de-anuncios)
- [O que são automações na WavUps CRM e quando usar](https://crm.wavups.com/docs/automacoes/o-que-sao-automacoes)