Como configurar o webhook da WavUps CRM
Configure o webhook para avisar a sua API quando leads, atendimentos ou agendamentos forem criados, editados ou excluídos, use o token e acompanhe o histórico de entregas.
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.
- 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.
- 1
Passo 1: Abra o menu Webhook
No menu lateral, em Configurações, clique em Webhook.
- 2
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). - 3
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.
- 4
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.
- 5
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.
| 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.
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.
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.
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
| 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. |
ERP sempre atualizado
A situaçãoUma distribuidora cadastra os clientes no ERP e no CRM, e os dois ficavam diferentes.
Como a WavUps CRM ajudaEla liga o webhook para Leads com Criação e Edição, e o ERP atualiza o cadastro a cada aviso.
Agenda em outro sistema
A situaçãoUma clínica usa um sistema de prontuário que precisa saber das consultas marcadas.
Como a WavUps CRM ajudaO webhook de Agendamentos avisa o sistema da clínica a cada consulta criada, alterada ou excluída.
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.
Não. Hoje os objetos rastreados são Atendimentos, Agendamentos e Leads.
Desligue Webhook ativo e clique em Salvar configuração. O selo do topo muda para Desativado.
Veja também
Ainda com dúvida?
Fale com a nossa equipe pelo WhatsApp.