Conheça o Comunicador CV CRM: WhatsApp API - Integrações e API

Comunicador CV CRM: Comunicação centralizada no seu CRM. Saiba mais clicando aqui!


O Comunicador CV CRM é o primeiro chat com Inteligência Artificial voltado para o mercado imobiliário, integrado diretamente ao WhatsApp.
Com ele, sua equipe consegue:

  • Centralizar todas as conversas com leads no CV CRM;

  • Iniciar ou responder conversas usando o WhatsApp;

  • Enviar materiais do empreendimento (fotos, plantas, campanhas) rapidamente;

  • Registrar o histórico de interações de forma automática.

Existem dois tipos de integração:

  1. WhatsApp Web – indicado para uso rápido com celular vinculado;

  2. WhatsApp API – integração oficial da Meta, robusta e escalável.


Este artigo vai detalhar como configurar o Comunicador CV WhatsApp API, nas modalidades Ativa (inicia conversas) e Receptiva (somente recebe mensagens).


Confira neste artigo:


1. Como ter acesso à funcionalidade

O Comunicador CV CRM é um benefício nativo do sistema.
Para habilitar o módulo WhatsApp API:

  1. Contrate o serviço com a equipe comercial do CV CRM;

  2. Aguarde o contato da equipe de implantações para iniciar o processo de integração;

  3. Após o vínculo, o número passa a ser exclusivo da API, ou seja, não poderá mais ser usado no app normal do WhatsApp.

Importante:
Se você precisa de um número com uso normal do app, considere usar a versão WhatsApp Web.


2. Pré-requisitos para integração

Antes de iniciar, tenha em mãos todas as informações abaixo.
A integração com API é mais complexa que o Web e pode levar até 30 dias úteis.

2.1. Dados necessários

  • E-mail do usuário responsável pela integração

    • Deve estar vinculado ao Facebook Business Manager.

    • Precisa ter acesso Full (administrador) no gerenciador.

    • Documentação da conta deve estar validada.

  • Razão social ou nome do cliente.

  • ID do Gerenciador de Negócios (Facebook Business Manager).

  • Estimativa de leads/mensagens por mês (para dimensionar a API).

  • Número do WhatsApp Business “virgem”

    • Não pode ter WhatsApp ativo vinculado.

    • Deve estar no aparelho para receber códigos de verificação.

    • Deve ser corporativo (não usar conta pessoal do Facebook).

  • Escolha do tipo de comunicador:

    • Ativo – permite iniciar conversas com leads;

    • Receptivo – somente recebe mensagens de leads.

Atenção:
Após vincular o número à API, ele não poderá mais acessar o aplicativo do WhatsApp.
Toda comunicação passa a ser feita pelo CV CRM.


3. Configurações iniciais no CV CRM

Para que o Comunicador funcione corretamente, siga estas configurações:

3.1. Habilitar permissões no perfil de acesso

No CV CRM, acesse Perfil de Acesso e ajuste:

  1. Aba Relacionamento

    • Habilite o uso do Comunicador.

  2. Aba Configurações

    • Libera acesso à tela de Canais do Comunicador.

  3. Aba Cadastros

    • Necessário para mensagens ativas. 


3.2. Criar Filas de Leads para o Comunicador

  • Crie uma Fila de Distribuição de Leads com:

    • Tag “cvcrmcomunicador” ou

    • Campo “Comunicador CV” habilitado.
       

  • Configure a Origem como obrigatória (Chat Online ou ChatBot).


Dica:
A fila exclusiva garante que leads sejam distribuídos corretamente e que o atendimento no Comunicador seja organizado.


3.3. Outras configurações importantes

  • Cadastrar mensagens padrão para agilizar respostas.

  • Manter empreendimentos completos com endereço, imagens, tabelas e plantas.

  • Configurar Canais do Comunicador para vincular números.

  • Ativar a função “Comunicador Ativo” se quiser iniciar conversas.

Se não habilitar o ativo, o corretor não conseguirá iniciar mensagens com leads.


Facilidade extra:
É possível habilitar ou desabilitar usuários em lote, agilizando a configuração para grandes equipes.


4. Configurando o Comunicador CV WhatsApp API – Ativo

Se você contratou a versão Ativa, siga o passo a passo:

4.1. Localizando o número no CV CRM

  1. Vá para Canais do Comunicador.

  2. Localize o número cadastrado pelo time do CV.

  3. Clique em Editar para acessar o número da API. 

Importante:
- Ao editar, você verá o Token de Acesso e o Webhook.
- Não altere os dados manualmente.
- O time de implantação orientará como usar essas informações.


4.2. Ativando o envio de mensagens ativas

  1. Verifique se o campo “Pode iniciar conversa” está como Sim.

  2. Isso habilita a aba Templates, onde você vai cadastrar mensagens ativas.


4.3. Cadastro de Templates

  • Obrigatório para envio ativo.

  • Até 500 caracteres por mensagem.

  • Pode usar variáveis:

    • Nome do cliente

    • Nome do atendente

    • Nome do empreendimento

Fluxo de aprovação:

  1. Cadastre o template no CV.

  2. Aguarde a aprovação da Meta (até 1 hora).

  3. Se reprovado, edite ou crie outro template.

A Meta não informa o motivo de reprovação.


4.4. Configurações de empreendimentos, tags e mídias

No menu "Configurações" dos Canais do Comunicador, é possível vincular cada número a EmpreendimentosTags Mídias. Essa funcionalidade permite que, ao receber um lead via integração do Comunicador, o sistema realize automaticamente a associação com as informações configuradas para aquele número específico.

Isso é especialmente útil em cenários com múltiplos números integrados, garantindo que cada número utilize as informações adequadas para a distribuição em Filas de Leads, otimizando a gestão e o direcionamento dos contatos.


4.5. Iniciando uma conversa com lead

  1. Acesse o lead no CV CRM.

  2. Clique no botão do Comunicador.

  3. Escolha Nova conversa.

  4. Selecione:

    • Canal (número de WhatsApp API)

    • Template aprovado


Observação: se o lead não responder em 24h, a conversa é encerrada automaticamente, seguindo regras da Meta.


5. Resumo dos Requisitos para Envio de Mensagens Ativas

Para que o Comunicador CV WhatsApp Web Ativo funcione corretamente e permita iniciar conversas com leads, todos os requisitos abaixo devem ser atendidos:

5.1. Permissões no Perfil de Acesso

  • O usuário (corretor ou gestor) precisa ter o perfil habilitado para envio de mensagens ativas.

  • Essa permissão é encontrada na aba Relacionamento > Comunicador.

Sem essa habilitação, mesmo que o número esteja integrado, não será possível enviar mensagens.


5.2. Comunicação liberada para o corretor

  • O corretor precisa ter a flag de comunicação habilitada no CV CRM.

  • Essa configuração pode ser feita individualmente ou em lote, facilitando para equipes grandes.


Dica:
Use a ação em lote para liberar ou bloquear rapidamente o envio de mensagens para múltiplos usuários.


5.3. Templates de mensagens aprovados

  • Pelo menos um template ativo e aprovado pela Meta é obrigatório.

  • Sem ele, o WhatsApp não permite iniciar conversas com leads que ainda não interagiram.

Regras importantes sobre templates:

  1. Obrigatórios apenas para envio ativo.

  2. Personalizáveis com variáveis como nome do cliente e do empreendimento.

  3. Limitados a 500 caracteres por mensagem.

  4. Sujeitos à aprovação da Meta, que pode reprovar sem informar o motivo.


5.4. Processo de envio de mensagens ativas

Depois que todas as permissões e templates estão ativos:

  1. O usuário acessa o lead no CV CRM.

  2. Clica no botão do Comunicador.

  3. Seleciona “Nova conversa”.

  4. Escolhe o Canal (número de WhatsApp) e o Template aprovado.
     

Se o lead não responder em até 24h, o chat é encerrado automaticamente.
Essa regra segue as políticas da Meta para conversas iniciadas pela empresa.

6. Configuração do Comunicador CV WhatsApp API – Receptivo

O Comunicador Receptivo é mais simples de configurar, pois não inicia conversas, apenas recebe mensagens.

6.1. Diferença para o modo Ativo

  • Não exige templates de mensagens.

  • Não permite iniciar conversas com leads.

  • A interação só ocorre quando o cliente envia a primeira mensagem.

Este modelo é indicado para equipes que não fazem prospecção ativa e focam no atendimento de leads .

6.2. Passo a passo para configuração

  1. Acesse Canais do Comunicador no CV CRM;

  2. Localize o número cadastrado pela equipe de integração;

  3. Verifique se está Ativo no Painel;

  4. Libere o perfil do usuário para receber mensagens no Comunicador;

  5. Faça um teste de recebimento para confirmar a integração.


7. Boas práticas

  • Manter sempre celular ligado, para qualquer eventual desconexão possa ser logo reestabelecido o contato.
  • Inserção de materiais de campanhas no empreendimento para que seja enviado pelos corretores.
  • Tabelas e disponibilidade atualizadas, para que seja disparada pelo corretor.
  • Ter mensagens padrões, facilitando o envio do Corretor/SDR direto ao cliente.
  • Mantenha suas conversas ativas, para que o contato não fique obsoleto.
  • Não usar o nome para campanha massivas de captação de leads, pois a Meta pode bloquear o número considerando como spam.


7.1 Observações gerais

  • O CV CRM, não é responsável pela aprovação ou bloqueio do número para com o WhatsApp
  • Para o funcionamento correto das filas é necessário identificar como é a chegada do lead, para cair no atendimento correto. 
  • Números para vinculo com a API, precisam estar "virgem", sem um
  • WhatsApp vinculado ou número ser novo, caso tenha conta de WhatsApp tem que ser removido.
  • O Web tem o benefício de ter mais melhorias disponíveis devido a ter uma integração mais simples com o WhatsApp, liberando mais APIs de conexões. 
  • Quando passar das 24 horas para contatos que sejam da API, tem aviso na tela, para realizar ações para voltar a se comunicar. Já para o tipo Web, o tempo deve ser configurado no Canal.


BOAS VENDAS!

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo