Assistente de WhatsApp com IA

O assistente de IA atende seus clientes no WhatsApp automaticamente: dá a primeira resposta na hora, qualifica o lead e repassa pro corretor no momento certo. Bem configurado, ele evita perder lead fora do horário e dá tranquilidade pro corretor.

Onde fica

Foto do usuário (canto superior direito) › Configurar WhatsApp (ou Menu Gestão › Assistentes).

São três etapas: criar o assistente, vincular o WhatsApp (QR Code) e definir os gatilhos.

Dica: você pode ter dois assistentes no mesmo número (ex: um de Locação e um de Vendas) ou apenas um, bem treinado, para os dois casos.

1. Criar o assistente

Você tem dois caminhos:

Modelos prontos (recomendado). O botão Modelos prontos, ao lado de "Novo assistente", traz três bases já escritas — Atendimento de Venda, Atendimento de Locação e Venda + Locação. Elas vêm com o prompt completo, as regras de atendimento, as ferramentas liberadas e a ficha de qualificação já configurados, usando o nome e os dados da sua imobiliária. Você instala, revisa os textos e liga.

O assistente instalado nasce desligado, de propósito: assistente ligado fala com cliente de verdade, então quem decide a hora de começar é você. Cada modelo mostra também o que ainda falta fazer — em geral, conectar um número de WhatsApp e apontar esse assistente nele.

Criar do zero. O botão Novo assistente abre um assistente em branco, para quem quer escrever o próprio atendimento do começo.

Em qualquer um dos dois, os campos são:

• Nome (ex: "Gezinho").
• Tom de voz: normal, formal ou descontraído.
• Função: vendas, aluguel ou ambos.
• Personalidade / informações da imobiliária: endereço, telefone, e-mail, CRECI, redes sociais, cidades de atuação. Quanto mais completo, melhores as respostas.
• Tempo de espera antes de responder (segundos): faz a IA aguardar alguns segundos antes de começar a processar a resposta do cliente, deixando o atendimento com um ritmo mais humano. Deixe em branco para manter o comportamento padrão do sistema.
• Modelo IA: qual modelo responde. Os modelos avançados aparecem cinza (não selecionáveis) enquanto a imobiliária não tiver a própria chave de IA conectada na Central de IA — eles rodam na conta dela. Na dúvida, deixe o recomendado.

2. Vincular o WhatsApp

Escaneie o QR Code com o celular (igual ao WhatsApp Web) para conectar o número.

Conectar com o código do celular (sem QR)

Se o celular não consegue ler o QR Code, use o caminho alternativo — é oficial do WhatsApp e conecta igual:

1. No painel de conexão, clique em Não consegue escanear? Conecte com o código do celular.
2. Informe o número do WhatsApp com DDI e DDD, só números (ex.: 5511999999999) e clique em Gerar código.
3. Aparece um código de 8 caracteres (ex.: ABCD-1234).
4. No celular, abra o WhatsApp em Aparelhos conectados › Vincular um aparelho › Vincular com número de telefone e digite o código.

O código vale 5 minutos. Se expirar antes de você digitar, clique em Gerar novo código.

Atenção: QR Code e código são o mesmo pareamento por caminhos diferentes — gerar um cancela o outro. Escolha um e vá até o fim.

Só salvar contatos no CRM (a IA não responde)

Na tela de edição da instância existe a chave Só salvar contatos no CRM (a IA não responde). Com ela ligada, o número vira um cadastrador silencioso: toda mensagem recebida de um número que ainda não está no CRM vira lead automaticamente, e nada é respondido.

O que acontece com a chave ligada:

• Quem manda mensagem e não está no CRM entra como lead novo.
• Quem já está salvo não sofre nenhuma ação — nada é criado nem alterado.
• Nenhuma mensagem é enviada pela IA enquanto a opção estiver ativa.

Enquanto o modo está ligado, o bloco de configuração da IA (assistente padrão, reativação automática e o envio ao assistente padrão) aparece esmaecido e bloqueado, com o aviso de que está suspenso. Os valores continuam gravados: ao desligar a chave, a configuração volta exatamente como estava.

No painel de assistentes, o card do número passa a exibir a etiqueta Só salva no CRM, para ninguém achar que a IA parou de responder por defeito.

Importante: a opção só existe no WhatsApp da imobiliária (responsável "Toda a Imobiliária"). Nos números de corretor a chave não aparece.

3. Lógica de atendimento

Escolha o fluxo:

• Atender › Entender › Convidar › Repassar (mais completo)
• Atender › Entender › Repassar
• Atender › Repassar

Dica: sempre uma pergunta por vez, para não sobrecarregar o cliente.

Qualificação (perguntas sugeridas): o que procura (apartamento/casa/studio), região, faixa de valor, forma de pagamento (recursos próprios/financiamento/venda de outro), prazo para mudar. Para locação: tipo, região, valor, pets/filhos/home office, interesse em pré-análise.

Critérios de repasse para humano: dúvidas jurídicas/contrato/matrícula, pedido de visita, ou qualquer coisa fora do pré-atendimento.

4. Gatilhos de Entrada (o que ativa o assistente)

Em Gatilhos de Entrada você diz quais mensagens acionam cada assistente. Cada gatilho tem a palavra-chave, o modo de comparação, o número de WhatsApp e a ação (chamar um assistente ou apenas salvar o lead no CRM).

No editor novo de gatilhos, o campo deixa de ser uma lista separada por vírgula e passa a ser uma lista de frases: você digita a frase inteira e tecla Enter, e a vírgula passa a fazer parte do texto — "quero comprar, tenho entrada" vira uma frase só, em vez de duas palavras-chave soltas. Cada frase aceita até 100 caracteres e o contador aparece no próprio chip; frase maior que isso é recusada na hora, com aviso, em vez de ser cortada no meio sem avisar.

O modo de comparação define quando a frase casa:

• Contém a frase inteira (padrão em gatilho novo): "oi" ativa em "Oi, bom dia", mas não dentro de "coisa" ou "noite".
• Contém em qualquer lugar: casa mesmo no meio de outra palavra — é o comportamento antigo.
• A mensagem é exatamente a frase: a mensagem inteira precisa ser a frase, nada mais.
• Casa com a expressão regular: padrão avançado, por exemplo (quero|preciso)\s+alugar.

Em qualquer modo, maiúsculas e acentos são ignorados na comparação: "IMÓVEL", "imovel" e "imóvel" casam entre si.

Por fim, o mesmo gatilho pode valer em vários números ao mesmo tempo: marque quantos quiser na lista de números e a regra é replicada em todos. Na tela, ela continua aparecendo como um gatilho só, com a etiqueta "N números" — e excluir apaga a regra em todos os números de uma vez.

Atenção: "Contém a frase inteira" ainda não está disponível nos números do WhatsApp Oficial (Meta). Se você marcar um número Oficial, o modo volta para "Contém em qualquer lugar" e o aviso aparece na tela.

Dica: gatilhos existentes continuam com o modo que já estava gravado. Só o gatilho novo nasce em "Contém a frase inteira" — se um robô antigo estava afinado no "contém", ele não muda sozinho.

Qualificar antes de mandar pro corretor (aba Delegar Depois)

No WhatsApp oficial cada número tem um modo de chegada do lead: Roleta imediata (o lead cai direto num corretor) ou IA primeiro. No modo IA primeiro, o lead novo do site é abordado pelo número da imobiliária, a IA coleta as informações que você listar na aba Delegar Depois e só então o lead entra na roleta — com o resumo já na ficha. Enquanto isso, ele fica sem corretor, para que ninguém receba lead frio.

Os dois prazos (mesma aba, para o lead nunca ficar esperando a IA):

• Lead não respondeu em X minutos — padrão 60. Passado o prazo, o campo No prazo, fazer o quê decide o destino:
  • Mandar pra roleta (padrão) — o lead é distribuído a um corretor.
  • Só etiquetar (sem corretor) — o lead fica com a etiqueta Sem Resposta IA até alguém assumir.
  • Enviar pra uma automação — o lead entra no fluxo que você escolher em Automações, e é lá que você monta a sequência (etiqueta, espera, mensagem de reativação e, no fim, a roleta). Só aparecem automações em fluxo (as do canvas). Se o robô escolhido estiver desativado ou tiver sido apagado, o lead cai na roleta — nunca fica parado.
• Lead respondeu mas a IA não concluiu em Y minutos — padrão 120, contados do último sinal da conversa. É a rede de segurança para a conversa que começa e trava: o lead é entregue ao corretor com o que a IA já coletou. 0 desliga esse limite.

Importante: o modo IA primeiro exige assistente ativo no número. Se a IA não conseguir abordar (número desconectado, template reprovado, lead sem WhatsApp), o lead não fica preso: vai pela roleta normal e o corretor é avisado para chamar à mão.

Atenção — QR Code e API oficial não abordam juntos: se a imobiliária tem um WhatsApp conectado por QR Code, o lead novo do site sai por ele, e a abordagem automática pela API oficial nem chega a ser tentada. Ou seja: com QR Code conectado, ligar o IA primeiro no número oficial não faz a IA chamar o lead do site — quem atende é o caminho do QR Code. A aba Delegar Depois mostra um aviso quando essa situação existe. Para a IA abordar pelo número oficial, desconecte/desative a instância de QR Code da imobiliária.

Quando o contato não é um cliente (fornecedor, parceria)

Nem todo mundo que chama no WhatsApp quer comprar ou alugar imóvel: aparece fornecedor oferecendo plano, empresa propondo parceria, currículo, cobrança. Sem esse ajuste, esses contatos esperam o prazo e caem na roleta como qualquer lead — e um corretor perde tempo com quem nunca foi cliente.

Na mesma aba Delegar Depois, o bloco Contato que não é lead (fornecedor, parceria) liga o reconhecimento. Ele nasce desligado; ao ligar, aparece o campo Quem recebe o aviso por e-mail, que começa em Administradores da imobiliária e aceita qualquer corretor da lista.

Com o recurso ligado, quando a IA percebe durante a conversa que o contato não é cliente de imóvel — fornecedor, proposta de parceria, oferta de serviço, currículo — acontecem quatro coisas:

• Sai um e-mail na hora para quem você escolheu (ou para os administradores, se você deixou o padrão), com o nome, o telefone, o motivo que a IA identificou e um link para abrir o atendimento.
• O contato não vai para a roleta. Ele fica salvo, sem corretor, e não entra na distribuição automática — nem na hora, nem quando o prazo de "lead não respondeu" vencer.
• O contato recebe a etiqueta Não é Lead IA, para você achar todos depois em uma busca.
• A IA se despede e para de responder aquele número, em vez de seguir qualificando quem não é cliente.

Importante: se o corretor escolhido estiver sem e-mail cadastrado, a tela avisa embaixo do campo — o aviso não tem para onde ir. Cadastre o e-mail em Menu Gestão › Usuários ou escolha outro destinatário. O mesmo aviso aparece quando o corretor escolhido foi removido depois.

E se a IA errar? O contato continua no bolsão, visível para todos: qualquer corretor pode puxá-lo normalmente, como faz com qualquer lead sem dono. Nada é apagado — só a distribuição automática deixou de acontecer. Se quiser, tire a etiqueta Não é Lead IA da ficha para não confundir a equipe depois.

Dica: o e-mail sempre sai, mesmo quando a IA se engana. É a sua rede de segurança: alguém de carne e osso lê o resumo e decide se aquele contato merece um corretor.

Abordagem automática da IA (WhatsApp oficial)

Ainda na tela de assistentes, o bloco Abordagem automática da IA mostra, por situação (Com imóvel, Sem imóvel, Pediu fotos, Pediu visita e Padrão), qual template a IA usa para abrir a conversa com o lead. Situação em branco usa o template padrão do sistema.

Para trocar, clique na situação. Abre a janela Escolher template, com a lista de templates à esquerda e a prévia à direita:

1. Use a busca para achar o template pelo nome — quem tem dezenas de templates não precisa rolar a lista inteira.
2. Clique num template: ele fica destacado e a prévia mostra como a mensagem chega no WhatsApp — balão, cabeçalho, imagem, rodapé e botões, já com os dados de exemplo cadastrados na Meta.
3. Confirme em Usar este template. Enquanto você não confirmar, nada é salvo; Cancelar fecha sem mexer na configuração.

A opção — nenhum — mantém a situação no template padrão do sistema, e a prévia explica o que isso significa. No celular a janela fica em uma coluna só: a prévia abre logo abaixo do template destacado, e o botão de confirmar continua fixo no rodapé.

Importante: dá para abrir a prévia de qualquer template, inclusive os aguardando aprovação e os rejeitados, mas só template aprovado pela Meta pode ser usado de fato — nos demais o botão fica desabilitado e a janela explica o motivo.

Essa mesma janela de escolha aparece em Template por origem e cenário, dentro do número da API oficial (Menu Gestão › WhatsApp › o número).

Aba Funil — ações automáticas por objetivo

Na aba Funil você diz o que a IA deve fazer no funil quando a conversa atinge um marco: mover o lead de etapa, aplicar uma etiqueta ou enviar o lead para uma automação. O corretor para de arrastar card à mão — o funil anda junto com o atendimento.

Ligue a chave Ações automáticas no funil e monte as regras. São no máximo 10 regras por assistente, de dois tipos.

1. Quando o lead responder pela primeira vez (uma regra, no máximo). Não passa pela IA: assim que chega a primeira mensagem do lead, a ação é aplicada. É o jeito mais simples de tirar do "Novo" todo lead que respondeu.

2. Objetivos detectados pela IA (até 9). Você descreve, em português, quando a regra vale — por exemplo "quando a IA descobrir o imóvel de interesse do lead" ou "quando o lead aceitar agendar uma visita". Esse texto é exatamente o que a IA lê para decidir, então escreva com o mínimo de dez caracteres e sem ambiguidade. Cada objetivo tem sua própria ação e seu próprio destino.

As três ações:

• Mover para etapa do funil — escolha o funil e depois a etapa (a lista de etapas só abre depois do funil, e trocar o funil limpa a etapa escolhida).
• Adicionar etiqueta — aplica a etiqueta no lead, sem mexer na etapa dele.
• Enviar para automação — o lead entra no robô escolhido (os do editor visual). Robô desligado aparece na lista marcado como (desligado), e enquanto estiver assim o lead não entra nele.

Importante — o lead nunca volta de etapa. As ações só fazem o lead avançar. Se ele já está na etapa de destino, ou numa etapa mais à frente, nada acontece. A régua é a ordem das colunas do seu funil: quem está mais à direita está mais avançado. Por isso, reordenar as colunas em Pipeline › Editar muda a régua — uma coluna movida para o fim passa a ser considerada "mais avançada" para todas as regras.

Atenção — descarte é a última etapa. Como o critério é a posição da coluna, deixe a etapa de descarte/perdido como a última do funil. Assim a IA consegue mandar o lead para lá (é o ponto mais avançado) e nenhuma outra regra o traz de volta depois.

Dica: comece com poucas regras (a primeira resposta e um ou dois objetivos claros) e acompanhe o funil por alguns dias antes de acrescentar o resto. Regra demais com condição parecida faz a IA hesitar entre duas.

Habilidades, follow-up e treino

• Habilidades: ative só o que faz sentido (acessar imóveis, transferir e notificar corretor, agendar visita…).
• Follow-up por inatividade (aba Reativação): ex. sem resposta em 2h → mensagem de apoio; 1 dia → nova tentativa; 2 dias → último lembrete. Disparos só dentro do horário definido. Cada abordagem é de um destes tipos:
  • Sequência de mensagens — você escreve o conteúdo (texto, imagem, áudio, documento).
  • Instrução para a IA — a IA escreve a mensagem seguindo a orientação que você der.
  • Enviar para automação — nenhuma mensagem sai: o lead entra na automação escolhida e o fluxo assume a conversa. A reativação segue para a próxima abordagem normalmente. Em liberação gradual: se este tipo não aparecer na sua conta, fale com o suporte.
• Template do WhatsApp oficial (por abordagem): também em liberação gradual; aparece para quem usa a API oficial (WhatsApp Cloud) em abordagens de sequência de mensagens. Fora da janela de 24 horas a Meta só aceita template aprovado — escolha um da lista ou deixe Automático (recomendado). Dentro das 24 horas a mensagem vai como texto normal, e template reprovado ou de outro número cai no automático.
• Base de conhecimento: carregue PDFs, lista de bairros, FAQ — a IA usa para responder melhor.

Importante — a lista de templates é a do número: na abordagem automática e em Template por origem e cenário (dentro do número da API oficial) aparecem apenas os templates da conta do WhatsApp (Meta) daquele número. Quem tem mais de uma conta oficial via o mesmo nome repetido várias vezes na lista e podia escolher a cópia errada — o envio ignora template de outra conta. Se a conta do número ainda não tiver template próprio, o sistema mostra os das outras contas com o nome da conta ao lado, só para você não ficar sem opção.

• Simulador: converse com a IA para testar; use o lápis para corrigir e treinar. As correções viram aprendizado.

Ajustar com IA (aba do editor)

Dentro do assistente existe a aba Ajustar com IA: um chat onde você escreve o que quer mudar, em português, e a IA altera a configuração pra você. Serve pra quem não quer caçar o campo certo em cada aba.

Exemplos do que funciona:

• "Deixe o tom mais consultivo e menos vendedor"
• "Nunca prometa mandar foto sem antes consultar o sistema"
• "Atenda também no sábado, das 9h às 13h"
• "Ligue o atendimento de locação"

Ela aplica na hora — não fica pedindo confirmação. Do lado direito fica a lista Alterações da IA, com um botão Desfazer em cada uma: se não gostou do resultado, um clique volta ao texto anterior.

Importante: a aba só funciona com a chave de IA da sua imobiliária conectada na Central de IA, no escopo WhatsApp — esse ajuste roda na sua conta de IA, não na do sistema. Hoje o recurso funciona com chave do Google Gemini. Sem chave conectada, a aba explica isso e leva você até a Central.

O que ela não faz: ligar ou desligar o assistente (esse botão é seu, no topo da tela) e trocar o modelo de IA.

Aba Auditoria (só administrador)

A aba Auditoria, ao lado de Configuração, responde a pergunta que mais aparece no suporte: a IA falou com esse lead ou não? Ela mostra, no período escolhido, todos os leads que a IA deveria abordar — pelos dois canais de WhatsApp (o conectado por QR Code e o Oficial) — com o número de mensagens trocadas, a etapa atual do lead, se a IA ainda está ativa naquela conversa e o erro exato quando o envio falhou.

O topo da tela tem uma linha de indicadores: total de leads, quantos a IA atendeu, quantos estão sendo atendidos agora, quantos responderam, quantos estão em cada etiqueta (Buscando, Compra futura, Já compraram, Sem resposta, Descadastrados), as duas contas de visita — Visita marcada pela IA e Visita c/ atendimento da IA —, quantos deram erro e quantos a IA não chegou a chamar. Cada indicador é um filtro: clique nele para deixar na lista só aqueles leads, e clique de novo para tirar o filtro. Os filtros aplicados aparecem logo abaixo da barra, com um Limpar filtros ao lado. Passando o mouse sobre um indicador, uma dica explica exatamente o que aquele número conta.

As duas contas de visita. Visita marcada pela IA conta só as visitas que a própria IA marcou — pela etiqueta que ela aplica ou pelo compromisso que ela cria na agenda. Visita c/ atendimento da IA conta as visitas de qualquer origem, inclusive as que o corretor marcou depois por telefone ou pessoalmente, desde que aquele lead tenha passado pelo atendimento da IA. O primeiro número mostra o que a IA fechou sozinha; o segundo, quanta visita saiu do atendimento dela no total — por isso costuma ser maior.

Importante: os dois indicadores de visita contam pela data da visita, não pelo dia em que ela foi marcada. Uma visita marcada hoje para o mês que vem só aparece quando o período De/Até alcançar a data em que ela acontece.

Abaixo dos indicadores ficam a busca por nome ou telefone, o filtro de status e a opção Só com erro, além do período em De/Até — este último vale para a tela inteira, indicadores incluídos.

Reenviar uma mensagem que falhou. Quando o erro é do canal conectado por QR Code, a linha do lead traz o botão Reenviar. Envios marcados como incerto podem já ter chegado ao cliente: o sistema pede confirmação antes, porque reenviar pode gerar mensagem duplicada. Se o WhatsApp tiver bloqueado temporariamente o envio para aquele número, aparece o prazo da liberação e o botão espera até lá. No fim da página, a Fila de reenvio permite disparar o lote de uma vez — o worker envia um por vez.

Atenção: cada linha da lista é um par lead × telefone. Um mesmo cliente com dois números aparece duas vezes, então o total de registros da lista não bate exatamente com o número do indicador ao lado.

Problemas comuns

• A IA atende junto com o corretor — quando um atendente entra na conversa, a IA recua automaticamente para não atropelar. Ela volta conforme a configuração.
• A IA respondeu valor/erro de informação — revise a personalidade e os prompts; informações erradas ali viram respostas erradas. As mudanças valem a partir da próxima mensagem.
• O número desconectou — refaça a vinculação pelo QR Code ou pelo código do celular.
• Instalei um modelo pronto e a IA não respondeu nada — o assistente nasce desligado e sem número vinculado. Ligue no topo da tela e aponte um WhatsApp para ele.
• A aba "Ajustar com IA" aparece bloqueada — falta conectar a chave de IA da imobiliária na Central de IA, ou ela está sem crédito/inválida.
• O "Chat de teste" não responde — ele usa o mesmo motor do atendimento real: com o assistente desligado, não há resposta. Ligue no topo da tela, salve e teste de novo (a própria aba avisa quando o assistente está inativo).
• A Auditoria mostra "Não chamado — assistente inativo" — a IA não chegou a abordar o lead porque o assistente ligado à roleta estava desligado no momento em que o lead entrou. Ligue o assistente; leads novos passam a ser atendidos (os antigos não são reprocessados sozinhos).

Perguntas frequentes

Mudei o prompt e nada mudou na conversa atual? As mudanças entram na próxima mensagem do cliente, não retroativamente.

A IA atende leads de todos os canais? Sim — site, portais, anúncios e WhatsApp, em paralelo com a Roleta que atribui o corretor.

Onde vejo as conversas? Na caixa de entrada do WhatsApp dentro do sistema.

Instalar um modelo pronto apaga o assistente que eu já tinha? Não. Cada modelo instalado vira um assistente NOVO na lista, desligado. Os que já existiam continuam iguais.

Posso instalar o mesmo modelo mais de uma vez? Pode — cada instalação cria um assistente separado. Útil pra testar uma variação do texto sem mexer no que já está atendendo.