Integração com Webhooks - Integrações e API

Sua gestão comercial pode ir além: conheça as mais de 50 integrações do ecossistema CV CRM clicando aqui!

Confira neste artigo:

• O que são Webhooks
• Como funcionam
• Como cadastrar um Webhook 
• Gatilhos disponíveis por funcionalidade 
• O que o CVCRM envia (Payload) e o sistema recebe 
• Gerenciamento de Webhooks por API
• Campos dos Webhooks

O que são Webhooks

Os Webhooks permitem que o CVCRM envie informações automaticamente para outro sistema sempre que um evento acontecer. Na prática, isso significa que o CVCRM não precisa ser consultado constantemente. Ele envia os dados no momento exato em que algo ocorre, como a criação de um lead ou alteração de uma reserva. Esse recurso é utilizado para integrações com outros sistemas, automações e atualização de dados em tempo real.

Alguns Webhooks criados antes de 2026 eram disparados com todas as informações da funcionalidade contemplada no Webhook. Este modelo está sendo desativado pelo CVCRM. Orientamos que ajustem os Webhooks para o novo modelo.

Como funcionam

O funcionamento de um webhook segue este fluxo: 

1. Um evento ocorre no CVCRM (ex: criação de lead) 
2. O sistema identifica um webhook ativo para esse evento 
3. Os dados são enviados automaticamente para a URL configurada 
4. O sistema de destino recebe e processa as informações 

Como cadastrar um Webhook 

Para cadastrar um webhook, acesse: 

Configurações > Integrações

Preencha os seguintes campos:

Nome: Identificação do webhook. 

Sugestão: utilizar nomes descritivos, como:
- Lead: Criação - Integração X
- Reserva: Aprovação - Gerente

Funcionalidade: Define a funcionalidade onde o evento será monitorado. 

Opções disponíveis: 

• Reserva 
• Lead 
• Pré-cadastro 
• Repasse 
• Comissão 
• Pagamento de Comissão 
• Atendimento 
• Assistência 
• Corretor 
• Clientes 
• Enviar Comissão 
• Agendamento 
• Unidades 
• Tabela de Preço  

Empreendimento: Permite selecionar um ou mais empreendimentos para o disparo. 

Gatilho: Define o momento em que o webhook será disparado. 

Endereço: URL que receberá os dados enviados pelo CVCRM. 

Ativo Painel: O webhook precisa estar ativo para realizar os disparos. 

Assunto / Sub assunto (exclusivo para atendimentos): Permite selecionar o assunto e o sub assunto para o webhook de atendimentos 

Gatilhos disponíveis por funcionalidade 

Reserva 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem 
• Aprovação de reserva 
• Solicitação de distrato 
• Contrato gerado 
• Cessão realizada 
• Permuta realizada

Lead 

• Criação 
• Alteração para situações definidas 
• Cadastro de interação 
• Cadastro de tarefa 
• Alteração para situações definidas no workflow 
• Associar atendente 
• Sem gatilho automátio 

Pré-Cadastro 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem

Repasse 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem

Comissão 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem 
• Cadastro de pagamento 
• Pagamento editado 
• Pagamento removido 
• Pagamento liberado 
• Ação cadastrada no workflow de reservas (cadastro de comissão)

Pagamento de Comissão 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem 
• Cadastro de pagamento 
• Pagamento removido 
• Pagamento liberado 
• Alteração para qualquer situação

Atendimento 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem

Assistência 

• Criação 
• Alteração para situações definidas 
• Cadastro de mensagem 
• Cadastro de visita

Corretor 

• Criação 
• Alteração de dados

Cliente 

• Criação 
• Alteração de dados

Agendamento 

• Criação de visita 
• Criação de vistoria 
• Alteração para situações definidas

Unidades 

• Criação 
• Alteração de dados 
• Alteração de situação

Tabela de preço 

• Criação 
• Edição 
• Aprovação 
• Reprovação 
• Ativar 
• Inativar

O que o CVCRM envia (Payload) e o sistema recebe 

O CVCRM envia um JSON contendo somente o identificador da funcionalidade. O sistema receptor deverá utilizar um endpoint de consulta da mesma funcionalidade para obter os dados completos. Exemplo:

{
 "idatendimento": 1
} 

Gerenciamento de Webhooks por API

Além da configuração pelo painel, o CVCRM disponibiliza APIs para gerenciamento de webhooks via autenticação. 

Consultar gatilhos 

Lista os gatilhos disponíveis no sistema. 

Acesse a nossa documentação: 

https://desenvolvedor.cvcrm.com.br/reference/get_webhooks-gatilhos-1

Consultar webhooks 

Lista os webhooks cadastrados. 

Acesse a nossa documentação: 

https://desenvolvedor.cvcrm.com.br/reference/get_webhooks-1 

Outras operações disponíveis 

Também é possível: 

• Criar webhooks 
• Deletar webhooks 

Essas operações são realizadas via API autenticada (email e token). 

Boas práticas 

• Utilize nomes claros e padronizados 
• Evite duplicar webhooks para o mesmo evento 
• Certifique-se de que a URL de destino está preparada para receber os dados 
• Revise o gatilho antes de ativar 

Campos dos Webhooks

Clique nos links abaixo para conhecer os campos e os dados dos Webhooks:

• Introdução ✅ 
• Criação de Webhooks  
• Webhook de Reservas
• Webhook de Leads
• Webhook de Pré-cadastro
• Webhook de Repasse
• Webhook de Comissão
• Webhook de Atendimento
• Webhook de Assistência
• Webhook de Corretor
• Webhooks de Clientes
• Webhook de Pagamento de Comissão
• Webhook de Agendamento
  
• Webhook de Unidades
• Webhook de Tabela de Preço