Integrando o CVCRM com o n8n via API

Nível: Iniciante | Ferramenta: n8n | Objetivo: Autenticar na API do CVCRM e consultar a Tabela de Preços
| Vídeo resumo: Assista aqui

📌 Visão Geral

Neste tutorial, você vai aprender como criar um fluxo no n8n que se conecta à API do CVCRM para:

1. Autenticar um usuário e obter um token de acesso
2. Consultar a Tabela de Preços do seu ambiente CVCRM

Esse é o padrão base de qualquer integração com o CVCRM: primeiro você se autentica, depois usa o token recebido para acessar os dados que precisa.

💡

Por que esse fluxo é importante?

Toda requisição à API do CVCRM exige um token válido. Entender como gerar e usar esse token é o passo fundamental para qualquer automação — seja cadastrar leads, consultar reservas ou integrar com outros sistemas.

🧩 Como funciona a API do CVCRM

O CVCRM disponibiliza uma API REST que permite que sistemas externos se comuniquem com a plataforma de forma segura. Tudo começa com a autenticação.

A documentação oficial da API está disponível em desenvolvedor.cvcrm.com.br.

O que é autenticação Bearer Token?

Quando você faz login na API, o CVCRM devolve um token — uma chave temporária válida por 6 horas. Esse token deve ser enviado em todas as requisições seguintes no cabeçalho Authorization, no formato:

Authorization: Bearer SEU_TOKEN_AQUI

Pense no token como um crachá de visitante: você passa na recepção (autenticação), recebe o crachá (token) e, a partir daí, pode circular pelas áreas permitidas (endpoints da API) sem precisar se identificar novamente em cada porta.

✅ Pré-requisitos

Antes de começar, você vai precisar de:

• Conta ativa no CVCRM com acesso ao painel gestor
• Domínio da sua base CVCRM (ex: suaempresa.cvcrm.com.br)
• E-mail e senha de um usuário com permissão para acessar a API
• Conta no n8n (pode ser a versão cloud em n8n.io ou autohosted)
• Perfil de acesso com permissões para os endpoints que serão consumidos — veja as permissões dos endpoints

⚠️

Atenção ao painel do usuário
No momento da autenticação, você precisa informar o tipo de painel do usuário: gestor, corretor ou imobiliaria. Certifique-se de usar o painel correto para o e-mail informado.

🛠️ Estrutura do Workflow

O fluxo que vamos construir tem 3 nós:

[Webhook] → [CVCRM - Autenticação] → [CVCRM - Tabela de Preços]

🔧 Passo a Passo

Nó 1 — Webhook (Gatilho)

O Webhook é o ponto de entrada do fluxo. Ele "escuta" uma URL e, quando recebe uma chamada, inicia a execução dos nós seguintes.

No n8n:

1. Clique em Add first step
2. Escolha Webhook
3. Defina o HTTP Method como POST
4. Copie a URL gerada — você vai usá-la para disparar o fluxo

💡

Para este tutorial, o Webhook é usado apenas como gatilho de exemplo. Em um cenário real, ele poderia receber dados de um formulário, de outro sistema ou de uma automação externa.

Nó 2 — CVCRM - Autenticação

Este nó faz uma requisição POST para a API de autenticação do CVCRM e retorna o token de acesso.

Endpoint: Gera um token de acesso para o usuário

POST https://{seudominio}.cvcrm.com.br/api/v3/auth/token

No n8n:

1. Adicione um nó HTTP Request
2. Configure:
   • Method: POST
   • URL: https://seudominio.cvcrm.com.br/api/v3/auth/token
   • Headers: adicione dois headers:
     • accept: application/json
     • content-type: application/json
   • Body Content Type: JSON
   • Body:
     JSON

     {
       "painel": "gestor",
       "email": "[email protected]",
       "senha": "suasenha"
     }

3. Renomeie o nó para CVCRM - Autenticação

Resposta esperada (200):

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_in": 1776474681
}

⚠️

Boas práticas de segurança
Nunca insira e-mail e senha diretamente no nó em texto puro em ambientes de produção. Utilize as Credentials do n8n ou variáveis de ambiente para proteger dados sensíveis.

Nó 3 — CVCRM - Tabela de Preços

Com o token em mãos, agora podemos fazer a consulta à Tabela de Preços.

No n8n:

1. Adicione um novo nó HTTP Request
2. Configure:
   • Method: GET
   • URL: https://seudominio.cvcrm.com.br/api/v1/comercial/tabelas-de-preco (ajuste conforme seu endpoint)
   • Authentication: Generic Credential Type → Header Auth
   • Header Name: Authorization
   • Header Value: Bearer {{ $node["CVCRM - Autenticação"].json.access_token }}
3. Renomeie o nó para CVCRM - Tabela de Preços

💡

O que é essa expressão {{ ... }}?

No n8n, as chaves duplas são usadas para referenciar dados de nós anteriores. $node["CVCRM - Autenticação"].json.access_token significa: "pegue o campo access_token da resposta JSON do nó de Autenticação". É assim que o token gerado no passo anterior é automaticamente repassado para a próxima requisição.

▶️ Testando o Fluxo

1. No n8n, clique em Execute Workflow
2. Dispare o Webhook — você pode usar ferramentas como Postman ou o próprio botão de teste do n8n
3. Acompanhe a execução nó a nó
4. Verifique os dados retornados no nó de Tabela de Preços
5. Assista o vídeo do nosso teste ASSISTA AQUI.

Se tudo estiver correto, você verá o token no segundo nó e os dados da tabela no terceiro. ✅

🔍 Monitorando suas integrações com o CVIO

O CVIO é o painel de monitoramento do CVCRM. Ele registra todas as requisições de entrada e saída, permitindo que você:

• Veja o histórico de chamadas à API
• Identifique erros e falhas de integração
• Gerencie tokens e filas

Acesse em: https://seudominio.cvcrm.com.br/cvio

⚠️

As requisições ficam disponíveis no CVIO por 30 dias.

🚨 Erros Comuns

🎯 Próximos Passos

Agora que você entende o fluxo base de autenticação + consulta, pode expandir esse padrão para:

• Cadastrar leads automaticamente a partir de formulários externos
• Criar atendimentos com base em eventos de outros sistemas
• Sincronizar reservas entre o CVCRM e um ERP

Explore os endpoints disponíveis na Referência da API do CVCRM e consulte os Manuais Simplificados para cenários mais avançados.

Dúvidas? Entre em contato com o suporte do CVCRM: [email protected]