Ativar e administrar o Chat IA para Site consiste em passos simples:

1. Assinar Mapaprop Business
2. Ativar API Token (dará acesso ao MapapropChatAi API Token)
3. Ativar Chat IA a partir da Seção Site > Console Site > Mapaprop Chat IA para Site
4. Configurar parâmetros, como nome do Chat, texto de apresentação.
5. Ler os Chats a partir do Inbox de Mensagens / Leads
6. Acessar o Contato para conhecer em detalhe suas Buscas, Perguntas e Imóveis Favoritos

Chat AI do Site

Configure o assistente de inteligência artificial que atende consultas 24/7 no seu site.

Visão geral

O Mapaprop Chat AI é um assistente inteligente que se integra ao seu site para responder consultas de visitantes automaticamente, captar leads e fornecer informação sobre imóveis e serviços 24 horas por dia.

Disponibilidade: Esta função é exclusiva do plano Business. Se você tiver outro plano, será oferecida a atualização quando tentar ativá-la.

Funcionalidades do Chat AI

O que o Chat AI faz?

Consumo de tokens

• Cada mensagem do Chat AI consome tokens da sua cota mensal de IA
• Os tokens são renovados automaticamente todo mês conforme seu plano Business
• Você pode ver o consumo detalhado em Serviços de IA

Ativar/Desativar o Chat AI

Ativar o chat

1. Clique no toggle na parte superior da página
2. O sistema verifica automaticamente se você tem plano Business
3. Se você não tiver Business, abre-se um modal para atualizar seu plano
4. Se você tiver Business, o chat é ativado imediatamente no seu site

Importante: A ativação é salva automaticamente. Você não precisa clicar em "Salvar".

Desativar o chat

1. Clique no toggle para desligá-lo
2. O widget desaparece imediatamente do seu site
3. As conversas anteriores permanecem no seu Inbox

Observação: Desativar o chat não afeta os tokens já consumidos, e as conversas anteriores permanecem disponíveis.

Configuração do Chat AI

Visão de tokens unificada

Na parte superior você verá um painel com link para a visão unificada de tokens que mostra:

• Tokens disponíveis no seu plano
• Consumo total de todos os serviços de IA
• Detalhamento por serviço (Chat AI, Instagram AI, outros)
• Histórico de consumo mensal

Acesso rápido: Clique em "Ver Consumo de IA" para ir à página de estatísticas.

Nome do assistente

Define como o assistente se apresenta aos visitantes.

Campo: Texto livre

Exemplos:

• "Assistente Virtual"
• "María - Assistente IA"
• "Bot de Consultas"

Recomendação: Use um nome amigável que gere confiança. Você pode incluir o nome da sua imobiliária.

Mensagem de boas-vindas

A primeira mensagem que o assistente envia quando um visitante abre o chat.

Campo: Área de texto (até 4 linhas)

Exemplo:

Olá! Sou a María, assistente virtual da Imobiliária Exemplo.
Em que posso ajudá-lo hoje? Posso fornecer informação sobre
nossos imóveis, serviços e responder suas consultas.

Dicas:

• Seja amigável e profissional
• Mencione o que o assistente pode fazer
• Convide a fazer perguntas

Tokens máximos por request

Limite de tokens que o assistente pode usar em cada resposta individual.

Faixa: 200 - 5000 tokens

Padrão: 2000 tokens

Incremento: 100 tokens

O que significa?

• Valor baixo (200-1000): Respostas mais curtas e diretas, consome menos tokens
• Valor médio (1000-3000): Respostas equilibradas, ideal para a maioria dos casos
• Valor alto (3000-5000): Respostas mais elaboradas e detalhadas, consome mais tokens

Recomendação: Comece com 2000 tokens e ajuste conforme a qualidade de respostas que você precisar.

Tokens máximos por conversa

Limite total de tokens que uma conversa completa pode consumir antes de ser fechada automaticamente.

Faixa: 10.000 - 100.000 tokens

Padrão: 30.000 tokens

Incremento: 5.000 tokens

Para que serve?

• Evita que uma única conversa consuma todos os seus tokens mensais
• Protege contra conversas infinitas ou mal-intencionadas
• Controla o gasto de recursos por cliente

Exemplo prático:

• Com 30.000 tokens e 2.000 por mensagem → máximo ~15 mensagens por conversa
• Com 50.000 tokens e 2.000 por mensagem → máximo ~25 mensagens por conversa

Recomendação: 30.000 tokens é suficiente para conversas úteis sem consumir excessivamente.

Configuração de Tipos de Chat (Prompt duplo)

O assistente pode se comportar de forma diferente conforme o que o visitante está fazendo. Por isso, dentro de "Configuração de Tipos de Chat" você vai encontrar duas abas, cada uma com seu próprio campo de instruções (prompt):

As regras gerais do Mapaprop já estão aplicadas em ambos os casos (não inventar imóveis, não dar assessoria jurídica definitiva, tratar sempre como intermediário). Você só adiciona a personalidade e a informação própria da sua imobiliária.

Exemplo (aba Busca):

Você é o assistente de busca da nossa imobiliária. Tom próximo e
profissional. Você sempre destaca as características principais de cada
imóvel e nossos 20 anos de experiência na região.

O Chat livre é configurado à parte (com seu próprio prompt e um sistema de tópicos). Explicamos em detalhe mais abaixo, em "Modos de conversa e como montar seus prompts".

💡 Quer um exemplo completo pronto para copiar? Veja o guia Como configurar seu agente de Chat AI (exemplo completo).

Salvar alterações

Salvamento automático (toggle)

O estado ativado/desativado é salvo automaticamente ao mudar o toggle. Você não precisa fazer mais nada.

Salvar configuração

Para salvar alterações no nome, mensagem de boas-vindas, tokens ou prompt:

1. Modifique os campos que você quer alterar
2. O botão "Salvar" será habilitado quando houver alterações pendentes
3. Clique em "Salvar"
4. Confirme a ação na caixa de diálogo que aparece
5. As alterações são aplicadas imediatamente ao site

Observação: As alterações não afetam conversas em andamento, apenas as novas que forem iniciadas.

Modelo de inteligência artificial (opcional)

Abaixo da configuração você vai encontrar o cartão "Modelo de inteligência artificial", onde você escolhe qual modelo de IA responde no seu chat.

Opção 1: Padrão do Mapaprop (recomendado)

É a opção predefinida. Seu chat usa o modelo otimizado da plataforma Mapaprop, sem configurar nada. O consumo é descontado da sua cota mensal de tokens como sempre.

Opção 2: Conectar sua própria conta (Anthropic ou OpenAI)

Se você tiver uma conta de API da Anthropic (Claude) ou da OpenAI (ChatGPT), pode fazer com que seu chat responda com o modelo que você escolher, usando sua própria API key:

1. Em Provedor, escolha Anthropic ou OpenAI
2. Em Modelo, escolha um da lista (qualidade vs velocidade/custo)
3. Em API Key, cole a key da sua conta do provedor
4. Clique em "Testar conexão" para verificar se a key funciona
5. Salve — o sistema valida a key contra o provedor antes de salvá-la; se for inválida, nada é salvo

Segurança da sua API key

• A key é salva criptografada e nunca é mostrada novamente na tela (você verá "Key configurada ✓")
• Você pode alterá-la ou removê-la quando quiser
• Remover a key volta seu chat ao modelo padrão do Mapaprop (você tem um botão "Desfazer" antes de salvar caso se arrependa)

O que acontece se minha key falhar?

Se sua key deixar de funcionar (você a revogou, ficou sem crédito, etc.), o chat não quebra: responde automaticamente com o modelo padrão do Mapaprop até você corrigi-la.

Onde criar sua API key

Modos de conversa e como montar seus prompts

Esta seção explica como o assistente conversa com seus visitantes e como configurá-lo para que responda exatamente o que você quer.

Os caminhos do visitante

Quando alguém abre o chat no seu site, o assistente oferece duas opções para começar:

Se você não ativou o chat livre, a segunda opção é "📝 Realizar consulta", que deixa uma mensagem para que sua equipe responda.

O bom é que o visitante não fica preso em um caminho. Enquanto conversa com o assistente pode:

• Pular para buscar imóveis a qualquer momento.
• Deixar uma consulta para que sua equipe entre em contato.

E se estiver buscando imóveis, pode voltar a consultar com o assistente. Tudo na mesma conversa, sem perder o fio.

Chat livre: conversas sobre seus temas

O chat livre transforma o assistente em alguém que responde as consultas frequentes da sua imobiliária (financiamento, garantias, requisitos, zonas, etc.) sem que um humano precise estar presente.

Para ativá-lo:

1. Vá até a aba "Chat livre" dentro de "Configuração de Tipos de Chat".
2. Ative o interruptor "Habilitar chat livre".
3. Carregue o prompt de chat livre (a personalidade e o conhecimento do assistente).
4. Carregue ao menos um tópico (os temas permitidos).
5. Salve.

Atenção: o chat livre consome tokens de IA a cada mensagem, igual à busca. Por isso é controlado com tópicos: o assistente só responde sobre o que você define e encaminha o resto para sua equipe.

Sistema de tópicos: defina sobre o que ele pode falar

Os tópicos são a lista de temas sobre os quais o assistente está autorizado a responder no chat livre. Funcionam como um menu: o visitante os vê ao iniciar a conversa e o assistente se mantém dentro desses limites.

• Você carrega os tópicos como etiquetas (até 20).
• Cada um é um tema curto: "Créditos imobiliários", "Garantias de aluguel", "Requisitos para alugar", etc.
• Se um visitante perguntar algo fora dos tópicos, o assistente não improvisa: oferece deixar a consulta para que sua equipe entre em contato.

Os tópicos definem o alcance (sobre o que se pode falar). O prompt define o conhecimento (o que responder sobre cada tema). Os dois trabalham juntos.

Como montar um bom prompt de chat livre

O prompt é onde você escreve a personalidade do assistente e a informação real da sua imobiliária. A melhor forma de estruturá-lo:

1. Uma linha com quem é o assistente e o tom.
2. Um bloco por cada tópico, com o título do tema em maiúscula e abaixo a informação que você quer que ele use.

Exemplo (para os tópicos "Créditos imobiliários", "Garantias de aluguel" e "Requisitos para alugar"):

Você é o assistente da nossa imobiliária. Tom cordial e próximo,
respostas breves. Se pedirem algo pontual de um caso concreto,
você orienta em geral e encaminha para a equipe.

CRÉDITOS IMOBILIÁRIOS:
Trabalhamos com linhas de bancos como Nación e Provincia. Financiam
até 75% do valor do imóvel. A aprovação final é definida por
cada banco. Para uma simulação com o salário real, encaminhe para a equipe.

GARANTIAS DE ALUGUEL:
Aceitamos fiador proprietário, contracheques, seguro-fiança
ou garantia de contribuinte individual. Cada imóvel pode pedir uma
combinação diferente: isso é confirmado pela equipe conforme o caso.

REQUISITOS PARA ALUGAR:
Pedimos documento de identidade, comprovante de renda, uma garantia válida e o
depósito e mês adiantado do contrato. Para os requisitos exatos
de um imóvel, encaminhe para a equipe.

Conselhos:

• Use títulos em maiúscula para cada tópico. O assistente os segue melhor.
• Não coloque dados que mudam com frequência (taxas exatas, preços do dia). Melhor "encaminho você a um assessor para o número atual".
• Seja concreto. Quanto mais informação real você colocar, menos o assistente improvisa.
• Teste seus tópicos. Depois de salvar, abra o chat do seu site e pergunte sobre cada tema para ver como responde.

Chat de consultas: quando convém um humano

Nem tudo a IA resolve. Quando um visitante quer falar com uma pessoa, ou pergunta algo fora dos tópicos, o assistente oferece deixar uma consulta.

• A consulta é salva no seu Inbox como um contato, com todo o histórico da conversa.
• Não consome tokens de IA (é uma mensagem direta para sua equipe).
• Sua equipe responde a partir do Inbox quando puder.

Assim você combina o melhor dos dois mundos: a IA atende as consultas frequentes 24/7 e sua equipe se concentra nos casos que realmente precisam de atenção humana.

Perguntas frequentes

Por que não consigo ativar o Chat AI?

Esta função é exclusiva do plano Business. Se você tentar ativá-la com outro plano, abrirá um modal oferecendo atualizar sua assinatura. Você pode revisar os planos disponíveis em Administrar Plano.

Quantos tokens cada conversa consome?

O consumo varia conforme:

• Comprimento das perguntas do visitante
• Complexidade das respostas geradas
• Quantidade de mensagens na conversa

Em média, uma conversa típica consome entre 2.000 e 10.000 tokens. Você pode monitorar o consumo em Serviços de IA.

As conversas do Chat AI aparecem no meu Inbox?

Sim. Cada conversa do Chat AI é salva automaticamente no seu Inbox como um novo contato ou é adicionada ao histórico se o contato já existir. As conversas têm uma tag especial "Chat AI" para identificá-las facilmente.

O que acontece se meus tokens se esgotarem?

Quando os tokens mensais se esgotam:

• O Chat AI é desativado automaticamente no seu site
• Os visitantes não verão o widget de chat
• Você recebe uma notificação para ficar sabendo

Os tokens são renovados automaticamente no início de cada período de faturamento conforme seu plano Business.

Posso personalizar a aparência do widget?

Atualmente o widget de Chat AI usa as cores configuradas em Design do Site. A personalização avançada do widget estará disponível em futuras atualizações.

O Chat AI responde em outros idiomas?

O Chat AI está otimizado para o espanhol argentino, que é o idioma principal do seu mercado. Se um visitante escrever em outro idioma, o assistente tentará responder no mesmo idioma, mas a qualidade pode variar.

Como melhoro a qualidade das respostas?

Para melhorar as respostas do Chat AI:

1. Complete seu perfil: Certifique-se de ter informação atualizada na sua conta
2. Mantenha atualizado seu inventário: Mais imóveis = melhores respostas
3. Configure os dois prompts: O de Busca (como comenta imóveis) e o de Chat livre (o que responde sobre seus temas). Veja "Modos de conversa e como montar seus prompts"
4. Carregue tópicos claros: No chat livre, defina os temas permitidos e coloque a informação de cada um no prompt
5. Aumente os tokens por request: Permite respostas mais elaboradas
6. Revise as conversas: Analise quais consultas você recebe e ajuste seus prompts e tópicos

Posso ver as conversas do Chat AI?

Sim. Todas as conversas são salvas no seu Inbox e você pode:

• Ver o histórico completo de cada conversa
• Filtrar pela tag "Chat AI"
• Responder manualmente se necessário
• Ver dados de contato captados

O Chat AI pode agendar visitas?

Atualmente o Chat AI capta a intenção do cliente (solicitar visita) e salva os dados no Inbox, mas não agenda diretamente no seu calendário. A confirmação de compromissos deve ser feita manualmente entrando em contato com o cliente.

Qual é a diferença entre o chat livre e deixar uma consulta?

O chat livre é atendido pela IA: responde na hora sobre os tópicos que você configurou e consome tokens. Deixar uma consulta envia uma mensagem direta para sua equipe (fica no Inbox), não usa IA nem tokens, e é respondida por uma pessoa. O assistente oferece deixar consulta quando o visitante quer falar com alguém ou pergunta algo fora dos seus tópicos.

O assistente responde qualquer coisa no chat livre?

Não. No chat livre o assistente só responde sobre os tópicos que você carregou, usando a informação do seu prompt de chat livre. Se perguntarem algo fora desses temas, ele não improvisa: oferece deixar a consulta para que sua equipe entre em contato. Assim você mantém o controle sobre o que o assistente diz em nome da sua imobiliária.

Casos de uso comuns

Caso 1: Imobiliária com alto tráfego web

Configuração recomendada:

• Tokens por request: 2000 (respostas equilibradas)
• Tokens por conversa: 50.000 (conversas longas permitidas)
• Prompt: Concentre-se em captar dados de contato rapidamente

Benefício: Você capta mais leads sem aumentar a equipe.

Caso 2: Especialista em zona específica

Configuração recomendada:

• Nome: "Assistente Zona Norte"
• Prompt: "Somente imóveis da zona norte, mencione nosso conhecimento do bairro"
• Tokens por request: 2500 (respostas detalhadas)

Benefício: Você reforça sua especialização geográfica.

Caso 3: Controle de custos

Configuração recomendada:

• Tokens por request: 1500 (respostas concisas)
• Tokens por conversa: 20.000 (limite mais baixo)
• Monitoramento frequente em /config/ai

Benefício: Você otimiza o uso de tokens mensais.

Dicas para maximizar o Chat AI

• Atualize os imóveis regularmente: O assistente usa seu inventário atualizado
• Configure páginas institucionais: O assistente usa info de "Sobre nós" e "Serviços"
• Monitore os tokens semanalmente: Evite ficar sem tokens no meio do mês
• Revise as conversas: Aprenda o que seus clientes buscam e ajuste a estratégia
• Use o prompt personalizado: Adicione sua proposta de valor única
• Teste diferentes configurações: Experimente com os tokens para encontrar o equilíbrio ideal

Mensagens de Chat

A partir do Inbox de Mensagens / Leads você poderá ler as mensagens

Ao tocar em um contato você poderá ver os Imóveis Consultados, os favoritos e as buscas realizadas

Se você acessar o contato, verá que cada contato tem informação relacionada