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

Confira neste artigo:

•  1. O que é o Comunicador CV CRM e como funciona
• 2. Pré-requisitos para integração
  • 2.1. Dados necessários
  • 2.2. Prazos para ativação
• 3. Habilitando permissões no CV CRM
  • 3.1. Configurações no perfil de acesso
  • 3.2. Criando Filas de Leads para o Comunicador
  • 3.3. Outros ajustes importantes
• 4. Configuração do Comunicador WhatsApp Web – Ativo
  • 4.1. Acessando os Canais do Comunicador
  • 4.2. Adicionando um canal
  • 4.3. Cadastro de Templates de Mensagens
  • 4.4. Configurações de empreendimentos, tags e mídias
  • 4.5. Vinculando via QR Code
• 5. Resumo dos Requisitos para Envio de Mensagens Ativas
  • 5.1. Permissões no Perfil de Acesso
  • 5.2. Comunicação liberada para o corretor
  • 5.3. Templates de mensagens aprovados
  • 5.4. Processo de envio de mensagens ativas
• 6. Configuração do Comunicador CV WhatsApp Web – Receptivo
  • 6.1. Diferença para o modo Ativo
  • 6.2. Passos de configuração
• 7. Boas práticas
  •  7.1 Observações gerais

1. O que é o Comunicador CV CRM e como funciona

O Comunicador CV CRM é o primeiro chat com Inteligência Artificial voltado para o mercado imobiliário.
Com ele, você consegue:

• Receber mensagens de leads do WhatsApp diretamente no CV CRM.

• Iniciar conversas com leads usando mensagens ativas aprovadas pela Meta.

• Enviar fotos, vídeos e materiais de empreendimentos de forma prática.

• Acompanhar o histórico de conversas e perfil do lead sem sair do sistema.

Existem dois tipos de integração:

1. Comunicador Ativo

   • Permite iniciar conversas com leads.

   • Necessário cadastrar templates de mensagens ativas aprovados pela Meta.

   • Ideal para ações de prospecção e follow-up.

2. Comunicador Receptivo

   • Permite apenas receber mensagens dos leads.

   • Não exige templates nem envio ativo.

   • Indicado para atendimento passivo, quando o cliente inicia a conversa.

2. Pré-requisitos para integração

Antes de começar a configuração, é importante garantir que você atende aos pré-requisitos:

2.1. Dados necessários

Para ativar o Comunicador, você precisa fornecer à equipe de integração:

• Razão Social ou nome do cliente;

• Número do WhatsApp que será vinculado;

• Definir o tipo de comunicador desejado:

  • Ativo (inicia conversas);

  • Receptivo (somente recebe mensagens).

Atenção:
O número de WhatsApp não pode ser removido do celular após a integração.
Se a conta for desconectada ou removida do aparelho, a integração será desativada imediatamente.

2.2. Prazos para ativação

• O prazo médio para integração é de até 10 dias úteis após o fechamento do contrato.

• Durante esse período, a equipe do CV realizará a triagem e preparação dos dados para liberar o Comunicador.

3. Habilitando permissões no CV CRM

Para que o Comunicador funcione corretamente, é necessário configurar o Perfil de Acesso do usuário e as Filas de Leads.

3.1. Configurações no perfil de acesso

Acesse o Perfil de Acesso no CV CRM e habilite permissões nas seguintes abas:

1. Relacionamento

   • Habilite a permissão para usar o Comunicador.
     
     

2. Configurações

   • Permite que o usuário acesse e configure os Canais do Comunicador.
     
     

3. Cadastros

   • Necessário para mensagens ativas.
     

3.2. Criando Filas de Leads para o Comunicador

Se você quiser uma fila exclusiva para o Comunicador, siga estas orientações:

1. Crie uma Fila de Distribuição de Leads no CV CRM.

2. Marque a tag “cvcrmcomunicador” ou habilite o campo “Comunicador CV”.

3. Caso configure esta fila exclusiva, defina as demais filas como “Não” para o campo “Comunicador CV”, garantindo que o direcionamento seja organizado e eficiente.
   

Além disso, vincule sempre as origens “Chat Online” e “ChatBot”.
Essas configurações são obrigatórias para que o lead chegue corretamente ao Comunicador.

3.3. Outros ajustes importantes

• Cadastrar mensagens padrões para agilizar o atendimento.

• Cadastrar informações completas do empreendimento (localização, imagens, tabelas, plantas).

• Configurar os Canais do Comunicador para definir quais números serão usados.

Dica:
Se você quiser que o corretor inicie conversas, habilite a função “Ativar/Desativar Comunicador Ativo”.
Sem essa habilitação, ele não conseguirá enviar mensagens ativas para leads.

Além da opção manual, também está disponível uma ação em lote, permitindo que a habilitação/desabilitação seja feita para múltiplos corretores de forma mais ágil e prática. Isso facilita o processo e reduz o tempo necessário para configurar as permissões.

4. Configuração do Comunicador WhatsApp Web – Ativo

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

4.1. Acessando os Canais do Comunicador

1. Vá para Configurações > Canais do Comunicador.

2. Verifique:

   • Quantidade de números contratados;

   • Quantidade de números já em uso.

Observação: essa tela só aparece para usuários com permissão no Perfil de Acesso na aba Configurações.

4.2. Adicionando um canal

Clique em “Adicionar Canal” e preencha os campos.

• Nome de identificação: se tiver vários números, crie nomes claros para diferenciar.

• Telefone: adicione o número do WhatsApp (será preenchido automaticamente após o QR Code).

• Integração: selecione WhatsApp Web.

• Tipo: defina se será usado para pré-venda ou transacional.

• E-mail para comunicação: será usado para notificações sobre status do número (inativo, bloqueado, etc.).

• Ativo no Painel: precisa estar como ativo para funcionar.

• Quantidade de dias para encerrar o chat: permite definir quantos dias o chat pode ficar inativo antes de ser encerrado automaticamente .

• Pode iniciar conversa: habilite se o seu contrato permitir mensagens ativas.

4.3. Cadastro de Templates de Mensagens

Para enviar mensagens ativas, siga os passos:

1. Clique em "Adicionar template".
    

2. Cadastre um Template no CV CRM com até 500 caracteres.
   
   

3. Personalize com variáveis como:

   • Nome do cliente;

   • Nome do atendente;

   • Nome do empreendimento.

     
     

4. Aguarde a aprovação da Meta, que pode levar até 1 hora.

5. Se reprovado, edite ou crie um novo template para tentar novamente.
   

Importante:
A Meta não informa o motivo da 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 Empreendimentos, Tags e 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. Vinculando via QR Code

1. Após salvar as configurações, será exibido um QR Code.

2. Abra o WhatsApp no celular e acesse Dispositivos Vinculados.

3. Clique em Vincular Dispositivo e escaneie o QR Code.

4. Pronto! O número está integrado ao CV CRM.

Dica:
Depois do QR Code, o campo Telefone será preenchido automaticamente.

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 Web – 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. Passos de configuração

1. Acesse Configurações > Canais do Comunicador.

2. Clique em “Adicionar Número” e preencha:

   • Nome de identificação para o número;

   • Selecione “WhatsApp Web” em Integração;

   • Ative o número no painel.

3. Escaneie o QR Code com o WhatsApp do celular para vincular.

Após esse processo, todas as mensagens recebidas para esse número vão direto para o CV CRM, aparecendo no Comunicador do lead.

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!