Como criar um chatbot usando a biblioteca de Comunicações do CV CRM

Este tutorial foi escrito para quem nunca colocou a mão em código e quer entender, do começo ao fim, como planejar e colocar no ar um chatbot conectado ao CV CRM. Aqui você vai descobrir o que é um chatbot, por que vale a pena ter um, o que a biblioteca de Comunicações do CV CRM oferece e qual o passo a passo para tirar a sua ideia do papel.

Não se preocupe com o canal em que o chatbot vai funcionar (WhatsApp, Telegram, site, aplicativo, etc.). A biblioteca de Comunicações do CV CRM é genérica e funciona com qualquer canal de conversa. O que muda é apenas a "porta de entrada" por onde o cliente fala com o robô.

1. O que é um chatbot?

Um chatbot é um "atendente virtual" que conversa com seus clientes por meio de mensagens. Ele entende o que a pessoa digita (ou fala) e responde de forma automática, simulando uma conversa humana. O chatbot pode tirar dúvidas, executar tarefas, encaminhar o cliente para um atendente real ou consultar informações em outros sistemas, como o CV CRM.

Quando o chatbot está conectado ao CV CRM através da biblioteca de Comunicações, ele consegue, sozinho, fazer coisas como cadastrar um novo interessado em um empreendimento, abrir um chamado de manutenção, enviar a segunda via de um boleto por e-mail ou agendar uma visita a uma unidade — tudo isso sem que ninguém da sua equipe precise intervir manualmente.

2. Por que vale a pena ter um chatbot?

A seguir, listamos os principais benefícios e, em cada um, mostramos um caso de uso real de como isso acontece na prática dentro de uma construtora ou incorporadora que usa o CV CRM.

Atendimento 24 horas por dia, 7 dias por semana

O chatbot não dorme, não tira férias e não fica indisponível no fim de semana. Isso significa que sua empresa continua atendendo, captando interessados e resolvendo demandas mesmo fora do horário comercial.

Caso de uso real: um interessado vê um anúncio do seu empreendimento às 23h de um sábado. Em vez de esperar até segunda-feira para falar com um corretor, ele já é atendido pelo chatbot, deixa nome, e-mail e telefone, e recebe materiais do empreendimento na hora. Na segunda-feira, o corretor já tem um lead quente esperando por ele no CV CRM.

Redução do custo de atendimento

Boa parte das dúvidas dos clientes é repetitiva: pedir segunda via de boleto, perguntar a data de entrega de chaves, consultar o saldo devedor, marcar uma visita. Quando o chatbot resolve essas demandas sozinho, sua equipe de atendimento foca no que realmente exige um humano.

Caso de uso real: todo início de mês, a central de atendimento ficava sobrecarregada com pedidos de segunda via de boleto. Com o chatbot, o próprio cliente solicita o boleto pelo canal de mensagem, e o documento é enviado por e-mail automaticamente. A central passa a atender apenas casos mais complexos, como negociações.

Escala sem aumentar o time

Crescer o atendimento, em geral, significa contratar mais gente. Com um chatbot, sua operação consegue absorver picos de demanda sem precisar contratar atendentes na mesma velocidade.

Caso de uso real: no lançamento de um novo empreendimento, sua empresa recebe centenas de novos interessados em poucos dias. O chatbot dá conta de cadastrar todos eles como leads no CV CRM, enviar informações iniciais e qualificar quem está realmente interessado, deixando para o time comercial apenas os contatos mais promissores.

Padronização e qualidade do atendimento

Atendentes humanos têm dias bons e dias ruins. O chatbot, não. Ele sempre faz as mesmas perguntas, registra as informações da mesma maneira e segue o mesmo fluxo, garantindo que nenhum dado importante seja esquecido.

Caso de uso real: antes, alguns corretores cadastravam leads sem o telefone, outros sem o e-mail, e isso gerava furos na hora de fazer follow-up. O chatbot só finaliza o cadastro quando coleta todas as informações obrigatórias, o que melhora a qualidade da base de dados no CV CRM.

Registro automático no CV CRM

Toda interação relevante feita pelo chatbot vira um registro no CV CRM: um lead novo, um atendimento aberto, um agendamento de visita. Isso significa que o histórico do cliente fica completo, sem retrabalho de "digitar de novo" o que foi conversado no chat.

Caso de uso real: o cliente abre um chamado de manutenção pelo chatbot às 22h. Quando o gestor de pós-venda chega no escritório de manhã, o atendimento já está aberto no CV CRM com todas as informações da pessoa, do imóvel e da descrição do problema, pronto para ser direcionado ao responsável.

Experiência mais rápida para o cliente

Esperar dez minutos no telefone para pedir uma segunda via de boleto é frustrante. Com o chatbot, o cliente resolve em poucos segundos, sem fila, sem horário de funcionamento e sem precisar repetir as mesmas informações várias vezes.

Caso de uso real: um morador precisa do informe de imposto de renda para fazer a declaração no último dia do prazo. Em menos de um minuto, ele pede o documento pelo chatbot, informa o ano de referência e recebe tudo por e-mail. Sem dor de cabeça, sem ligar pra ninguém.

3. O que é a biblioteca de Comunicações do CV CRM?

A biblioteca de Comunicações é um conjunto de "comandos" disponibilizados pelo CV CRM para que sistemas externos — incluindo o seu chatbot — possam executar ações dentro da plataforma de forma automática. Esses comandos são acessados por meio de uma API, que é a forma como dois sistemas conversam entre si.

Você pode pensar nela como um cardápio: cada item desse cardápio é uma ação que o chatbot pode pedir ao CV CRM. Os principais "pratos" desse cardápio, organizados pelo que o chatbot consegue fazer, são:

Para captar e gerenciar interessados (leads)

Cadastrar um novo lead a partir do contato inicial pelo chat.
Alterar o empreendimento de interesse de um lead que já existe.
Consultar a lista de empreendimentos ativos e as unidades disponíveis para apresentar ao interessado.

Para abrir e acompanhar atendimentos (pós-venda, manutenção, dúvidas)

Consultar os assuntos e subassuntos disponíveis no CV CRM (por exemplo: Financeiro, Manutenção, Cobrança).
Cadastrar um novo atendimento para um cliente já existente no CV CRM ou para um contato avulso.
Finalizar um atendimento quando a demanda for resolvida.
Listar atendimentos abertos para acompanhamento.

Para resolver demandas financeiras dos clientes

Enviar a segunda via de boletos por e-mail.
Enviar o extrato financeiro do cliente por e-mail.
Enviar o informe de imposto de renda por e-mail.
Enviar os contratos associados ao cliente por e-mail.

Para agendar visitas e vistorias

Consultar as unidades em que o cliente pode agendar uma visita ou vistoria.
Consultar as datas e horários disponíveis para agendamento.
Cadastrar um novo agendamento.
Cancelar um agendamento existente.

A boa notícia é que você não precisa entender de programação para planejar quais dessas ações o seu chatbot vai oferecer. Quem cuidará da conexão técnica entre o chatbot e o CV CRM são as ferramentas de integração ou um desenvolvedor parceiro — e nós voltaremos nisso no passo a passo.

4. Antes de começar: o que você vai precisar

Para que seu chatbot consiga conversar com o CV CRM, três coisas precisam estar prontas. Não se preocupe se algum dos termos abaixo parecer novo: cada um deles está explicado de forma simples.

1. Acesso ao CV CRM da sua empresa. Você precisa estar com seu cadastro ativo na plataforma e ter permissão para gerar credenciais de integração. Se você não souber se tem essa permissão, fale com o administrador do CV CRM dentro da sua empresa.

2. As credenciais de acesso (e-mail e token). O token é uma espécie de "senha técnica" que identifica seu chatbot perante o CV CRM. Sem ele, a plataforma não permite que o chatbot execute nenhuma ação. O passo a passo completo para gerar essas credenciais está em outro tutorial do portal do desenvolvedor: Como autenticar nas APIs do CV CRM Leia esse material antes de seguir adiante.

3. Uma ferramenta para construir o chatbot. É nessa ferramenta que você vai desenhar a "conversa" do robô (as perguntas, as respostas, os menus) e conectá-la ao CV CRM. Falaremos das opções no próximo passo.

5. Passo a passo para criar o seu chatbot

A partir daqui, vamos seguir um caminho prático para você sair do zero. O foco é o planejamento: decisões que você precisa tomar antes de a parte técnica acontecer. Em cada passo, indicamos quando faz sentido envolver um parceiro técnico (interno ou externo).

Passo 1 — Defina o objetivo do chatbot

Antes de qualquer coisa, escreva, em uma frase, qual problema o chatbot vai resolver. Quanto mais específico, melhor. Alguns exemplos:

"Quero captar novos interessados nos meus empreendimentos fora do horário comercial."
"Quero reduzir em 50% o volume de ligações pedindo segunda via de boleto."
"Quero permitir que o cliente marque a vistoria do apartamento sozinho, sem precisar falar com o pós-venda."

Esse objetivo vai guiar todas as decisões seguintes. Um chatbot que tenta fazer tudo, em geral, não faz nada bem feito. Comece pequeno e cresça depois.

Passo 2 — Escolha os fluxos que o chatbot vai cobrir

Com o objetivo em mãos, escolha quais "fluxos" o chatbot vai oferecer ao usuário. Um fluxo é o caminho que o cliente percorre dentro da conversa para conseguir o que precisa. Use a lista de ações da biblioteca de Comunicações (item 3 deste tutorial) como referência.

Exemplos de fluxos comuns:

Fluxo de captação de lead: o chatbot pergunta o nome, e-mail e telefone do interessado, mostra opções de empreendimentos e envia o lead direto para o CV CRM.
Fluxo de segunda via de boleto: o chatbot pede o CPF do cliente, identifica a pessoa no CV CRM, lista as unidades dela e dispara o envio do boleto por e-mail.
Fluxo de abertura de atendimento: o chatbot apresenta os assuntos disponíveis, pede a descrição do problema e abre um atendimento no CV CRM.
Fluxo de agendamento de visita: o chatbot identifica o cliente, mostra as unidades disponíveis para visita, lista as datas e horários e confirma o agendamento.

Tente desenhar cada fluxo no papel ou em uma ferramenta visual antes de ir para a próxima etapa. Pense como uma conversa real: o que o cliente diz primeiro, o que o chatbot responde, quais informações precisam ser coletadas e o que acontece no final.

Passo 3 — Defina o tom e a personalidade do chatbot

O chatbot é uma extensão da sua marca. Decida desde o início:

Ele vai ter um nome? (por exemplo, "Vera, sua assistente do residencial Tal").
O tom será formal ou amigável?
Ele vai usar emojis?
Como ele se apresenta no início da conversa?
O que ele responde quando não entende o pedido do cliente?
Como ele encaminha o cliente para um atendente humano quando necessário?

Essa parte parece secundária, mas faz uma diferença enorme na percepção do cliente.

Passo 4 — Escolha a ferramenta para construir o chatbot

Existem muitas ferramentas no mercado que permitem montar um chatbot sem precisar programar. Elas funcionam com uma lógica de "arrastar e soltar" os blocos da conversa. Para conectar essas ferramentas ao CV CRM, você usa um recurso chamado "integração via API", que normalmente é configurado dentro da própria ferramenta.

Algumas categorias de ferramentas que você pode pesquisar:

Plataformas de chatbot no-code/low-code, Existem muitas plataformas disponíveis no mercado para escolher com diversas ferramentas, você pode optar por uma mais simples, buscando custo, ou uma mais complexa, com mais recursos.. Elas permitem desenhar visualmente a conversa e oferecem campos para chamar APIs externas, como a do CV CRM.
Plataformas de automação, como Zapier, Make (antigo Integromat) e n8n. Elas funcionam como "encanadores" digitais que ligam o chatbot à API do CV CRM sem código.
Plataformas de atendimento omnichannel, como Zenvia, Octadesk e Huggy, que muitas vezes já têm um construtor de bot embutido e suporte a integrações.
Plataformas de inteligência artificial conversacional, como Dialogflow (Google) e Watson Assistant (IBM), recomendadas para chatbots mais sofisticados.

A escolha depende do seu orçamento, do canal em que o chatbot vai funcionar e da complexidade desejada. Pesquise duas ou três opções, faça contas e, se possível, peça uma demonstração antes de decidir.

Passo 5 — Envolva um parceiro técnico para a integração

Mesmo nas ferramentas no-code, o momento de "ligar" o chatbot ao CV CRM exige alguém com conhecimento técnico mínimo. Esse profissional vai:

Configurar as credenciais (e-mail e token) na ferramenta de chatbot.
Mapear cada passo do fluxo a uma ação da biblioteca de Comunicações (por exemplo: "quando o cliente confirmar o cadastro, chame a ação de Cadastrar Lead").
Tratar as respostas que o CV CRM devolve para que o chatbot mostre uma mensagem amigável ao cliente.
Cuidar dos cenários de erro (e-mail inválido, cliente não encontrado, horário indisponível, etc.).

Esse parceiro pode ser um desenvolvedor da sua equipe interna, um freelancer ou uma agência especializada. Compartilhe com ele este tutorial e o link do portal do desenvolvedor para que ele tenha o contexto técnico completo da API.

Passo 6 — Teste o chatbot antes de liberar para os clientes

Antes de colocar o chatbot para conversar com clientes reais, faça testes exaustivos com pessoas da sua equipe. Para cada fluxo desenhado, verifique:

O chatbot responde da forma esperada?
As informações chegam corretamente ao CV CRM (lead criado, atendimento aberto, agendamento marcado)?
O e-mail com o documento financeiro é entregue?
O que acontece quando o cliente digita algo errado ou foge do roteiro?
O caminho para falar com um atendente humano está funcionando?

A maioria das ferramentas de chatbot tem um ambiente de simulação. Use bastante. Lembre-se de que, no início, é sempre melhor que a equipe descubra os problemas antes dos clientes.

Passo 7 — Coloque o chatbot no ar e acompanhe os resultados

Quando estiver tudo certo, conecte o chatbot ao canal de atendimento real (WhatsApp, site, aplicativo, etc.) e divulgue para sua base de clientes. Nas primeiras semanas, acompanhe de perto:

Quantas conversas o chatbot está atendendo por dia?
Quais fluxos são os mais usados?
Em quais pontos o chatbot está sendo "atropelado" e o cliente acaba pedindo um atendente humano?
A qualidade dos leads cadastrados está adequada?

Esses dados vão te mostrar onde ajustar o roteiro, melhorar mensagens e adicionar novos fluxos.

6. Boas práticas para um chatbot que funciona

Algumas recomendações que valem para qualquer chatbot, independentemente da ferramenta escolhida ou do canal usado.

Comece pequeno. É melhor lançar um chatbot que faz duas coisas muito bem do que um que tenta fazer dez coisas e falha em todas.

Deixe sempre um caminho para o humano. Em qualquer momento da conversa, o cliente deve poder pedir para falar com um atendente real. Robôs não resolvem tudo, e tentar forçar a barra gera frustração.

Confirme antes de executar. Antes de cadastrar um lead, abrir um atendimento ou marcar uma visita, mostre um resumo do que será feito e peça confirmação. Isso evita registros duplicados ou agendamentos errados.

Use linguagem simples. Evite jargão imobiliário ou siglas que o cliente comum não conhece. O chatbot precisa falar a língua de quem está do outro lado.

Cuide dos dados do cliente. O chatbot vai lidar com informações pessoais (nome, telefone, CPF). Garanta que a ferramenta escolhida respeita a Lei Geral de Proteção de Dados (LGPD) e que você tem uma política de privacidade clara.

Atualize o chatbot com frequência. Os clientes mudam, os empreendimentos mudam e as suas regras de negócio mudam. Revisar o roteiro do chatbot a cada três ou seis meses é uma boa prática.

7. Próximos passos

Agora que você entende o que é um chatbot, quais vantagens ele traz e como a biblioteca de Comunicações do CV CRM pode ser usada, recomendamos:

Definir, com sua equipe, qual o primeiro objetivo do chatbot.
Acessar o tutorial Como autenticar nas APIs do CV CRM e providenciar as credenciais.
Explorar a documentação completa da API de Comunicações no portal do desenvolvedor, para conhecer todas as ações disponíveis em detalhes.
Selecionar duas ou três ferramentas de chatbot que pareçam se encaixar no seu cenário e pedir uma demonstração.
Conversar com o time técnico (interno ou parceiro) para alinhar o cronograma de implementação.

Se em algum momento você ficar travado, lembre-se: o chatbot é um projeto incremental. Não precisa nascer perfeito — precisa nascer útil. O resto é aprendizado em produção.