Assistente de WhatsApp com IA

Atualizado em 23 out 2026

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

Menu Gestão › WhatsApp & Assistente IA › Assistentes IA & WhatsApp — Assistentes IA & WhatsApp. O mesmo lugar abre por Foto do usuário (canto superior direito) › Automação › Configurar WhatsApp.

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

Dica: nas imobiliárias que testam a Central de configurações, a configuração desta tela também fica em Configurações › IA & WhatsApp › Assistentes & WhatsApp, sem o resumo e sem a aba Auditoria, que continuam aqui.

Importante: esta tela configura a IA que conversa com o lead. O aviso que o corretor recebe no WhatsApp quando entra lead novo é configurado em outro lugar: Configurar notificações.

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.

Modelo gerenciado pela ImobTotal. Quando o assistente é um modelo gerenciado (instalado pela nossa equipe ou pela galeria, quando esse modelo estiver disponível para a sua conta), o roteiro de atendimento, os agentes e as ferramentas vêm prontos e são atualizados pela ImobTotal — você não mexe em prompt. O editor mostra a faixa "Modelo gerenciado pela ImobTotal" e só as abas que são suas: Geral (nome, modelo de IA e ligar/desligar), Agenda de visitas (dias e horários em que a IA pode marcar visita, valendo para venda, locação e captação de uma vez), Funil, Delegar Depois e Chat de teste. As abas Agentes, Funções, Substituições, Reativação e Ajustar com IA não aparecem nesse caso. O nome que você escolhe é também como a IA se apresenta na conversa.

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:

No painel de conexão, clique em Não consegue escanear? Conecte com o código do celular.
Informe o número do WhatsApp com DDI e DDD, só números (ex.: 5511999999999) e clique em Gerar código.
Aparece um código de 8 caracteres (ex.: ABCD-1234).
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.

Na grade de instâncias, 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.

As instâncias aparecem em cards lado a lado (um por linha no celular, até três ou quatro no computador), cada um com o nome, o estado (Ativo, Inativo, Ativo sem WhatsApp ou envio bloqueado), se é da imobiliária ou do corretor, o canal e o número. Passe o mouse sobre o card para ver o resumo completo. Com mais de seis números, aparece um campo Buscar por nome ou número no topo da seção.

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.

Quando o corretor responde pelo WhatsApp dele

Na seção Instâncias WhatsApp, a chave Desativar a IA quando o corretor responder pelo WhatsApp dele cobre o corretor que fala com o lead pelo número de WhatsApp dele (conectado no CRM), e não pelo chat do CRM nem pelo número da imobiliária. Ela só aparece para o administrador e quando há pelo menos um número de corretor conectado. Ligada:

a primeira mensagem dele pelo número dele faz a IA do número da imobiliária parar de responder esse lead, como se ele tivesse clicado em Assumir chat (fica registrado na ficha do lead);
enquanto ele estiver atendendo — 7 dias desde a última mensagem dele, ou 12 horas quando o assistente está no modo Continua sempre —, a IA não volta sozinha: nem pela Reativação automática da IA do número, nem se o lead se cadastrar de novo no site;
para religar antes disso, use Ativar IA na conversa do lead.

A chave nasce desligada, vale para todos os assistentes da imobiliária (não é configurada em cada um) e salva na hora em que você clica. Pode levar até 1 minuto para valer em todas as conversas.

Número de fallback da imobiliária

O número de fallback é um WhatsApp reserva da imobiliária. Ele fica conectado, mas só entra em ação quando o WhatsApp principal (o de responsável Toda a Imobiliária) cai e, mesmo assim, atende apenas leads novos.

Quando é usado: só enquanto o número principal estiver desconectado. Com o principal conectado, o fallback não é usado.
Só leads novos: conversas que já existem não mudam de número.
Herda a IA do principal: o fallback usa a mesma configuração de IA do número principal. Por isso a tela dele não mostra o bloco de IA nem as chaves Só salvar contatos no CRM e Proteger para chats pessoais.
Só existe um: cada imobiliária pode ter um único número de fallback, e ele exige que a instância Toda a Imobiliária já exista.

Para criar:

Em Instâncias WhatsApp, clique em Nova instância WhatsApp e escolha Uazapi (QR code ou código).
No campo Responsável, escolha Fallback da imobiliária (reserva) e clique em Criar instância.
Conecte o número pelo QR Code ou pelo código do celular, como qualquer outro.

Na grade de instâncias, o card aparece como Fallback da imobiliária. Assim como o número da imobiliária, só o administrador edita. Quando o principal está desconectado e o fallback está conectado, o resumo da tela avisa: Número principal desconectado — o fallback está atendendo os leads novos.

Importante: a opção só aparece para imobiliárias com o recurso liberado. Se já existe um número de fallback, ou se ainda não há a instância Toda a Imobiliária, a tela explica o motivo logo abaixo do campo Responsável.

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.

Horários em que a IA pode agendar (aba Agentes)

Na aba Agentes, cada agente ativo (Venda, Locação, Temporada, Proprietário e Financeiro) tem o bloco Horários em que a IA pode agendar, logo acima do prompt. Ele define os dias e horários em que aquele agente pode marcar visita, ligação ou reunião com o cliente. Com o bloco fechado, o resumo já mostra o que está valendo (por exemplo, "Seg a Sex — 08:00 às 18:00"); clique em Alterar horários para mudar.

Permitir que a IA agende: desmarcado, a IA não marca nada naquele agente — ela atende normalmente e passa o lead ao corretor para combinar o horário.
Antecedência mínima: tempo mínimo, em minutos, entre a conversa e o horário marcado. Com 60, se o cliente pedir às 14:00, a IA só oferece das 15:00 em diante.
Dias da semana: clique para liberar ou bloquear o dia. A IA só agenda nos dias em azul.
Horários de cada dia: a IA só marca dentro dos períodos informados. Para pular o almoço, use dois períodos no mesmo dia (08:00 às 12:00 e 13:30 às 18:00).

Importante: esses horários valem só para marcar compromissos — não são o horário em que a IA responde as mensagens. Para a IA conseguir marcar, a função de agendamento também precisa estar ligada na aba Funções. As mudanças valem depois de Salvar agentes.

Na aba Funções você escolhe o que cada agente pode usar. Três regras valem para todos os assistentes:

A transferência para atendimento humano fica sempre marcada nos agentes (a caixa aparece travada). Sem ela a IA não consegue passar o lead ao corretor e acabaria prometendo um retorno que ninguém recebe. A única exceção é a IA do proprietário, que avisa o corretor pelo canal próprio.
Acessar imóveis é opcional. Marcada, a IA procura imóveis, confirma o interesse e convida para a visita. Desmarcada, a IA trabalha só o imóvel que o lead pediu: não apresenta outras opções, não cita referência nem link de outro imóvel e passa ao corretor quando o cliente quiser ver mais. A tela mostra um aviso quando algum agente ativo está sem a busca.
O imóvel de interesse é automático. Em todo agente que tem a busca de imóveis, a caixa aparece marcada e travada: quando o lead diz que gostou de um imóvel, a IA registra o imóvel em Imóveis de interesse na ficha dele, e tira de lá se ele disser que não quer mais. O corretor vê o resultado na ficha do lead e na aba de interessados do imóvel.

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.

Origem e imóvel de interesse no gatilho

Dois campos opcionais no mesmo gatilho dizem com que origem e com qual imóvel o lead entra no CRM quando a frase casa:

Origem do lead: o nome da origem publicitária (por exemplo, "Facebook - Campanha Studio"). Se ainda não existir, ela é criada. O lead nasce com essa origem em vez da origem do anúncio ou do número.
Imóvel de interesse: a referência do imóvel do seu acervo. O imóvel entra na ficha do lead antes da distribuição.

Com isso, o lead segue o mesmo caminho de um lead de portal: passa pela Roleta de atendimento com as regras que você configurou (por imóvel, empreendimento, origem, valor...), entra no funil e na etapa da regra e o corretor recebe o aviso completo, com foto e link do imóvel. É o jeito de distribuir campanhas de anúncio que chegam no WhatsApp da imobiliária: uma frase por campanha, cada uma com a sua origem e o seu imóvel.

Importante: os dois campos valem só nos números conectados por QR Code (uazapi). No WhatsApp Oficial eles são ignorados.

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.

Gatilho no WhatsApp do corretor

O gatilho também pode apontar para o número conectado de um corretor. Na lista de números do gatilho, eles aparecem separados dos números da imobiliária, em Números de corretores.

Nesse caso a ação é sempre Apenas salvar o lead no CRM: quando alguém que ainda não está no CRM manda uma mensagem com a frase do gatilho, o contato vira lead já atribuído ao corretor dono do número. A IA não responde por esse número e a conversa continua com o corretor, normalmente. Origem e imóvel de interesse valem do mesmo jeito, e o imóvel também é reconhecido sozinho quando a mensagem traz o link dele no seu site.

Um uso comum é a frase /imovel: a mensagem que o botão de WhatsApp do site envia traz o link do imóvel, então todo contato que chega por ali entra no CRM com o imóvel de interesse, sem o corretor precisar cadastrar.

Atenção: o número do corretor também é o pessoal dele. Prefira frases específicas (/imovel, "tenho interesse"). Palavras genéricas como "casa" ou "alugar" transformam conversa de família e fornecedor em lead.

Importante: quem já tem ficha no CRM não é alterado, e mensagem sem a frase do gatilho continua fora do CRM.

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 parar a IA (handoff)

Na mesma aba Delegar Depois, o campo Quando parar a IA (handoff) decide o que a IA faz depois que o lead vai para o corretor. São três opções:

Para ao delegar — assim que o lead vai para a roleta (objetivo concluído), a IA para de responder.
Para quando o corretor entrar — a IA continua atendendo até o corretor enviar a primeira mensagem na conversa.
Continua sempre — a IA segue conduzindo a conversa mesmo depois de delegar o lead. Quando o corretor clica em Assumir chat, a IA silencia e volta sozinha depois de 12 horas sem o corretor falar com o lead.

Atenção — WhatsApp Oficial com "IA primeiro" e "Continua sempre": nas conversas do número Oficial que passaram pelo pré-atendimento, esse modo faz a IA continuar respondendo mesmo depois do Assumir chat ou da mensagem do corretor. Se a sua equipe precisa que a IA pare quando o corretor assume, troque o campo para Para quando o corretor entrar.

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 › Equipe & Permissões › Usuários do sistema 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.

Mensagem de abertura para lead de formulário (WhatsApp por QR Code)

Quando um lead se cadastra pelo site, portais ou Facebook, a IA manda uma primeira mensagem pelo WhatsApp conectado por QR Code. Esse texto não vem do prompt: ele sai exatamente como está escrito no campo Mensagem de abertura para lead de formulário, na aba Geral do assistente. O campo já vem preenchido com o padrão do sistema; se você não mexer, nada muda.

Lead com imóvel de interesse — padrão: "Olá [nome], tudo bem? Vi seu interesse no imóvel Ref: [ref]. [link] Posso te ajudar?"
Lead sem imóvel — padrão: "Olá [nome], tudo bem? Vi seu cadastro no nosso site. Posso te ajudar a encontrar um imóvel?"

As variáveis entram pelos botões abaixo de cada campo (não digite colchetes): Nome do lead, Ref. do imóvel, Link do imóvel (com as fotos liberadas), Nome do assistente, Imobiliária e Corretor responsável. Referência, link e corretor somem sozinhos quando o lead não os tem. Uma variável que não existe impede o salvar. Quebra de linha vira mensagem separada no WhatsApp. Restaurar padrão volta ao texto do sistema.

Importante: no WhatsApp Oficial (Cloud) a abertura é o template aprovado pela Meta (bloco abaixo), não este campo. Se o assistente usa o modelo Primeiro contato, o texto do modelo vale enquanto estes campos estiverem no padrão.

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:

Use a busca para achar o template pelo nome — quem tem dezenas de templates não precisa rolar a lista inteira.
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.
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.
- Enviar imóvel semelhante — o sistema escolhe o imóvel disponível mais parecido com o perfil do lead (tipo, cidade, bairro, quartos e faixa de preço) e envia a foto com os dados, a mesma regra do bloco Enviar imóvel das automações com "Mais semelhante ao perfil do cliente". Nunca repete: imóvel que o lead já recebeu, pela reativação ou por uma automação, não volta. Você pode escrever uma mensagem para ir antes do imóvel (aceita {{primeiro_nome}}, {{imovel.bairro}} e as demais variáveis das automações). Sem imóvel novo no perfil, a abordagem é pulada e a reativação segue. No WhatsApp não oficial vão só a foto e os dados, sem link; na API oficial vai também o link do imóvel no seu site. Com a conversa fechada (cliente não falou nas últimas 24 horas) a Meta só aceita template: vai o template de imóvel escolhido na abordagem (ex.: novidade_imovel_destaque), preenchido com a foto, o imóvel, o preço e o link do imóvel escolhido — a mensagem antes do imóvel não entra no template. Nessa abordagem a lista de templates mostra só os de imóvel; em Automático (recomendado) o sistema usa um de imóvel aprovado no número. Se o número não tiver nenhum template de imóvel aprovado, vai o template de retomada, sem o imóvel, que fica para uma próxima vez.
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 ou deixe Automático (recomendado). O campo abre a janela de templates: a lista fica à esquerda (com busca, Automático e Não enviar nada no topo) e a prévia de como o cliente recebe à direita; confirme em Usar este template. Cada template aparece uma vez só, mesmo que exista uma cópia em cada conta da Meta: no envio vale a cópia do número que manda a mensagem. Dentro das 24 horas a mensagem vai como texto normal, e template reprovado ou de outro número cai no automático.
WhatsApp Oficial: fora da janela de 24 horas (no fim da aba): o que o assistente faz quando o cliente não fala há mais de 24 horas, momento em que a Meta só aceita template. Vale para as reativações e para as respostas da IA. As opções são Escolher um template automaticamente (padrão), Enviar sempre este template, Enviar sempre um imóvel semelhante ao perfil do lead e Não enviar nada. Com imóvel semelhante, vai sempre um imóvel do perfil do lead no template de imóvel escolhido (ou no automático), com foto, preço e link — a mesma escolha da abordagem Enviar imóvel semelhante: o mais parecido com foto e nunca um que o lead já recebeu. Sem imóvel novo no perfil, vai o template automático. A primeira mensagem para um lead novo continua sendo a de boas-vindas, e o template escolhido numa abordagem específica continua tendo preferência.
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.

Logo abaixo da barra de filtros vem o Funil do atendimento, lido de cima para baixo: total de Leads, quantos a IA atendeu (com quantos estão em atendimento agora), quantos estão Buscando e as Visitas marcadas pela IA — com a segunda conta de visita, Visita c/ atendimento da IA, logo abaixo dela. Ao lado do funil fica a medida Responderam (à IA ou ao corretor): leads que mandaram mensagem no período, mesmo quando a IA não rodou — por isso ela pode ser maior que "IA atendeu" e não entra na sequência. Em seguida vêm os desfechos em etiquetas (Compra futura, Já compraram, Sem resposta, Descadastrados) e dois alertas: quantos a IA não chegou a chamar (o motivo de cada um aparece na lista) e quantos envios deram erro. Cada etapa, etiqueta ou alerta é um filtro: clique 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 uma etapa, 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.

Acima do funil 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, funil incluído. O resumo dos últimos 30 dias (atendidos, responderam, visitas, não chamados e erros) também aparece na coluna Resumo da aba Configuração, com o atalho Ver auditoria completa.

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.

Parar a IA em um lead (Assumir chat)

Para a IA parar de responder um lead específico, abra a conversa dele (em Todos os Chats ou no chat da ficha do lead) e clique em Assumir chat, na barra de botões embaixo das mensagens. A IA para naquele lead, em todos os números da imobiliária, e o botão passa a mostrar Ativar IA — é por ele que você devolve a conversa. O passo a passo está em Inbox do WhatsApp (conversas).

Para desligar a IA automaticamente quando o lead chega numa etapa do funil, use o bloco Desativar a IA nas Automações.

Números bloqueados (contatos pessoais)

O WhatsApp da imobiliária também recebe mensagem de quem não é cliente: família, amigos, o contador, o fornecedor de sempre. Sem nada configurado, cada um desses contatos vira um lead no CRM, com a conversa salva na ficha. A lista de números bloqueados resolve isso: o telefone que estiver nela nunca entra no CRM.

Onde fica: no fim da tela Gestão › WhatsApp & Assistente IA › Assistentes IA & WhatsApp, na seção Números bloqueados (contatos pessoais). Só o administrador da imobiliária vê e altera a lista.

O que acontece com um número da lista:

Mensagem recebida dele não cria lead, não aparece em nenhum chat e não aciona o assistente de IA.
Mensagem enviada para ele, pelo celular ou pelo computador, também não fica registrada no CRM.
Vale para o WhatsApp conectado por QR Code e para o WhatsApp Oficial, em todos os números da imobiliária.

Passo a passo

Digite o telefone com DDD no campo Telefone com DDD. Para número de outro país, comece com o sinal de mais e o código do país.
Se quiser, preencha Quem é (por exemplo, "Esposa" ou "Contador") para lembrar depois.
Clique em Adicionar. O bloqueio vale na hora, para a próxima mensagem.
Para liberar um número, clique em Remover na linha dele. Aparece um Desfazer logo em seguida, caso tenha sido engano.

Importante: se o telefone adicionado já era um lead, esse lead é excluído na mesma hora, com o motivo Contato pessoal (bloqueado). A ficha e a conversa antiga saem das listas, mas nada é apagado: abra a ficha do lead excluído e use Reativar lead para desfazer.

Atenção: remover um número da lista só volta a aceitar as mensagens dele. O lead que foi excluído continua excluído até você reativá-lo na ficha.

Diferença para a Central de IA: em Central de IA existe o recurso Proibir conversas pessoais virarem leads, em que a própria IA lê a conversa e decide se é pessoal. A lista desta tela é manual: você escolhe os números, sem depender de IA nem de chave configurada. Os dois podem ficar ligados ao mesmo tempo.

O que não existe (e o que fazer no lugar)

Não existe botão "Pausar IA" nem "Intervenção humana" nesta tela nem na conversa. Para parar a IA de um lead, use Assumir chat na conversa dele.
Não existe um campo "mensagem de aviso de lead novo para o corretor" aqui. Esse aviso é configurado em Configurar notificações.
Não existe desligar a IA de um lead pela Central de IA. A Central cuida da chave de IA, dos recursos e do consumo.

Problemas comuns

A IA atende junto com o corretor — clique em Assumir chat na conversa do lead: a IA para naquele lead. Mandar mensagem pelo chat do CRM também pausa a IA naquela conversa. Se ela voltou a responder no dia seguinte, o assistente está em Continua sempre (volta depois de 12 horas sem o corretor falar); veja Quando parar a IA (handoff).
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.
A IA disse ao cliente que vocês não trabalham com um tipo de imóvel que existe no cadastro — a IA só oferece imóveis com Disponível no site ligado (e fora da lixeira). Imóvel cadastrado mas fora do site não entra nas sugestões dela; se o cliente citar a referência, ela reconhece o imóvel e avisa que ele está indisponível. Para a IA oferecer, ligue Disponível no site nos imóveis que devem ser divulgados.
O número desconectou — refaça a vinculação pelo QR Code ou pelo código do celular (abra a conexão em Gestão › WhatsApp & Assistente IA › Assistentes IA & WhatsApp). Enquanto o número está desconectado, os leads novos entram no CRM normalmente, mas a IA não faz o primeiro contato com eles. Depois que reconecta, ela atende só os leads que chegarem dali em diante: não volta atrás nos que entraram durante a queda. Peça aos corretores um contato manual com esses leads.
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 — …" — a IA não chegou a abordar o lead, e o complemento diz o porquê: assistente inativo (o assistente ligado à roleta estava desligado quando o lead entrou — ligue o assistente), sem canal de WhatsApp (todas as instâncias estavam desconectadas — reconecte os números), conta bloqueada na Meta ou falha no WhatsApp Oficial (veja a instância oficial e o alerta dela), ou motivo não registrado. Em todos os casos, leads novos passam a ser atendidos depois de corrigir a causa; os antigos não são reprocessados sozinhos.

Perguntas frequentes

O WhatsApp ficou desconectado. A IA vai abordar os leads que entraram nesse período? Não. Os leads que chegaram durante a queda estão no CRM, com nome e telefone, mas não receberam o primeiro contato da IA, e ela não volta atrás neles depois que o número reconecta. Reconecte o número e peça aos corretores para chamar esses leads manualmente. A partir da reconexão, os leads novos voltam a ser atendidos pela IA.

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? Em Menu Gestão › WhatsApp & Assistente IA › Todos os Chats, ou no chat da ficha do lead.

Como faço a IA parar de responder quando o corretor assume? Na conversa do lead, clique em Assumir chat. Para devolver, clique em Ativar IA no mesmo lugar.

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.