Configurar e Ativar um Agente de IA Configurar um agente de IA no Imobiturbo.OS leva poucos minutos e não requer conhecimentos técnicos. Para que serve Define como a IA deve se comportar na conversa: nome, tom de voz, regras de negócio, instruções do atendimento, o número de WhatsApp em que atua e quando deve passar para um humano. Antes de começar - Você é gerente ou administrador no Imobiturbo.OS. - Já existe um número de WhatsApp conectado (Conectar por QR Code ou API Oficial). Passo a passo Parte 1 — Criar o agente 1. No menu lateral, abra Agentes IA. 2. Clique em + Criar novo agente (ou edite um agente existente). 3. A tela do agente abre na aba Configuração: Configuração de Agente de IA Lista de agentes para iniciar a configuração Parte 2 — Preencher a configuração - Identificação - Nome: como a IA se apresenta (ex.: Sofia — Consultora Imobiliária); - Descrição: uma linha sobre o papel do agente; - Prioridade: usada quando mais de um agente pode assumir. - Número de WhatsApp: selecione a sessão/número em que este agente atende. - Quando este agente responde: condições de acionamento (ex.: em qual situação ele assume a conversa). - Instruções gerais: o que a IA deve e não deve fazer — aqui você pode vincular as Skills da sua organização. - Mensagem de abertura: como o agente começa o atendimento. - Estilo de resposta: tamanho das mensagens, uso de listas, etc. - Handoff humano: ativar a passagem para corretor quando o cliente pedir ou atingir o perfil (veja Handoff humano e retomada). - Casos humanos e Follow-up: opcionais, ligam o agente aos fluxos de Follow-ups. ℹ️ 🔎 Limites técnicos (avançado) As opções de max steps, token budget, custo máximo e janela de histórico controlam recursos da IA. Para a maioria das imobiliárias, os valores padrão funcionam bem — mude apenas se a equipe Imobiturbo orientar. Parte 3 — Publicar e ativar 1. Revise as instruções e a mensagem de abertura. 2. Clique em Publicar (ou Salvar e publicar). Um agente só atende depois de publicado. 3. Confira o estado do agente (veja Estados do agente): ele deve estar Ativo e Publicado. 💡 🆕 Teste antes de ligar no número real Use a aba Teste do agente para conversar com ele antes de liberar no WhatsApp. Assim você ajusta o tom sem atender cliente de verdade. Como saber que deu certo - O agente aparece na lista de Agentes IA com o estado correto. - Uma mensagem enviada para o número conectado recebe a resposta da IA em poucos segundos, identificada com o selo de IA na Inbox. - Na aba Execuções do agente você acompanha cada atendimento e o custo/uso. Problemas comuns | O que aconteceu | O que fazer | |---|---| | O agente não responde | Confira se o número de WhatsApp está conectado e se o agente está publicado e ativo. | | O agente erra o tom | Ajuste as Instruções gerais, use as Skills e teste na aba Teste. | | Não consigo salvar | Verifique se todos os campos obrigatórios estão preenchidos (nome, sessão, instruções). | | O agente não usa o conhecimento | Vincule as bases na aba Conhecimento do agente (veja Base de Conhecimento). | Próximos passos - Base de Conhecimento - Skills da IA - Roteadores de mensagens - Memória da IA

Gestão de Contatos & Oportunidades

Visão Geral de Contatos

Visão Geral de Contatos A seção de Contatos é a agenda centralizada de toda a sua operação imobiliária, reunindo clientes compradores, locatários, proprietários e parceiros de negócio. Para que serve Centraliza os dados cadastrais, telefones de WhatsApp, e-mails, preferências de imóveis, histórico de conversas e tags de todos os clientes atendidos pela imobiliária. Como funciona a tela de Contatos Ao acessar o menu Contatos na barra lateral, você tem acesso à lista completa da sua base: Lista de Contatos Tags e segmentação de contatos A tabela exibe: - Nome e Avatar: Identificação do cliente. - WhatsApp / Telefone: Número formatado para contato direto. - E-mail: Endereço eletrônico para envio de propostas e contratos. - Tags de Segmentação: Marcadores visuais de interesse e perfil. - Responsável: Corretor ou atendente vinculado. - Última Interação: Data e horário da última mensagem trocada. Ações rápidas disponíveis - Iniciar Conversa: Clique no ícone de mensagem para abrir a conversa diretamente na Inbox. - Editar Dados: Atualize telefone, e-mail, notas e tags do cliente. - Importar CSV: Adicione listas de contatos de outras plataformas em poucos segundos.

Conexões (WhatsApp & Meta Lead Ads)

Central de Conexões

Central de Conexões A Central de Conexões é o painel onde você gerencia os números de WhatsApp e os canais que trazem clientes para o Imobiturbo.OS: WhatsApp por QR, WhatsApp API Oficial (Meta) e os Formulários dos seus anúncios. O que você conecta aqui | Canal | Para que serve | Tutorial | |---|---|---| | Números por QR | Cada corretor conecta o próprio WhatsApp (como o WhatsApp Web) | Conectar por QR Code | | API Oficial (Meta) | Número oficial do WhatsApp Business, sem celular ligado, com templates | WhatsApp API Oficial | | Formulários Meta | Leads dos anúncios do Facebook/Instagram direto no funil | Meta Lead Ads | No painel de Conexões, cada canal por QR é representado por um cartão que exibe: - Nome de identificação do canal. - Número de telefone cadastrado. - Corretor ou administrador responsável pelo número. - Indicador de status em tempo real (🟢 Conectado, 🟡 Conectando ou 🔴 Desconectado). - Total de mensagens processadas hoje e tempo médio de resposta. Central de Conexões Formulários Meta na Central de Conexões Vários Números por Imobiliária No Imobiturbo.OS: - Administradores podem visualizar todos os números conectados da organização. - Corretores visualizam e gerenciam a conexão do seu próprio número de WhatsApp. - Todas as mensagens de todos os canais confluem para a Inbox de acordo com as permissões de atendimento. O que acontece depois Com os números conectados: - As mensagens enviadas pelos clientes chegam instantaneamente no CRM. - As automações e agentes de IA podem ser vinculados a números específicos ou a todos os canais. Próximos passos - Conectar WhatsApp por QR Code - Pedir para o corretor conectar seu número - WhatsApp API Oficial (Meta) - Meta Lead Ads (Formulários de anúncios)

Conexões (WhatsApp & Meta Lead Ads)

Reconectar e Gerenciar Sessões

Reconectar e Gerenciar Sessões Eventualmente, o aplicativo do WhatsApp no celular pode desconectar uma sessão devido a atualizações do aparelho, economia de bateria ou perda prolongada de sinal de internet. Para que serve Saber identificar e restabelecer rapidamente o status de conexão evita que mensagens de clientes fiquem represadas ou sem resposta. Estados da Conexão - 🟢 CONECTADO: A sessão está ativa e operando normalmente. Mensagens são enviadas e recebidas em tempo real. - 🟡 CONECTANDO / RECONECTANDO: O sistema está tentando restabelecer o contato com o aparelho automaticamente. - 🔴 DESCONECTADO: A sessão foi encerrada no celular ou expirou. É necessário fazer uma nova leitura de QR Code. Gerenciar Sessões e Reconectar Lista de conexões e status Como reconectar 1. Acesse o menu Conexões. 2. Localize o canal que está com aviso de desconexão. 3. Clique no botão Reiniciar Sessão ou Reconectar. 4. Uma nova janela com o QR Code será exibida. 5. Abra o WhatsApp no smartphone, acesse Aparelhos Conectados e leia o novo QR Code. Dicas para manter a conexão estável 1. Evite encerrar o WhatsApp no celular: Não force o fechamento do aplicativo do WhatsApp nas tarefas em segundo plano do celular. 2. Mantenha o aparelho conectado: Certifique-se de que o aparelho não passe dias desligado ou sem bateria. 3. Desative otimização de bateria severa: Em alguns aparelhos Android, adicione o WhatsApp à lista de exceções de economia de bateria. O que acontece depois - Assim que a reconexão for concluída, o sistema processará automaticamente qualquer mensagem que tenha chegado durante a interrupção. Problemas comuns - O status fica em 'Conectando' por muito tempo: Clique em Reiniciar Sessão para forçar a inicialização limpa da instância de conexão.

Primeiros Passos & Onboarding

Navegação Principal

Navegação Principal O menu lateral do Imobiturbo.OS reúne os atalhos para todas as áreas operacionais da sua imobiliária. Para que serve Permite que você alterne instantaneamente entre atender clientes, acompanhar negociações, gerenciar agentes de inteligência artificial e configurar a operação da sua equipe. Seções disponíveis Menu de Navegação Visão geral do menu lateral 1. Inbox (Atendimento): Central unificada de conversas em tempo real com clientes do WhatsApp. 2. Radar: Conversas que esfriaram e precisam de ação (leads em risco). 3. Conexões: Números de WhatsApp (QR e API Oficial da Meta) e Formulários de anúncios. 4. Kanban: Funil visual de vendas dividido por etapas comerciais. 5. Contatos: Base cadastral completa de clientes, proprietários e investidores. 6. Equipe: Gestão de corretores, gerentes, convites e métricas individuais de atendimento. 7. Desempenho: Relatórios de funil e performance por atendente. 8. Templates: Modelos de mensagens rápidas e textos padronizados para envio em um clique. 9. Agentes IA: Criação e calibração de assistentes inteligentes para triagem e qualificação. 10. Roteadores: Distribuem a primeira mensagem para o agente certo (compra, aluguel, captação). 11. Follow-ups: Fluxos automáticos de reengajamento e fila de retornos. 12. Memória da IA: Regras gerais da operação que todos os agentes respeitam. 13. Skills da IA: Habilidades especializadas que os agentes ativam conforme o assunto. 14. Evolução da IA: Acompanhamento do que o agente aprendeu, negócios fechados/perdidos e lacunas do atendimento. 15. Webhooks / Automações: Regras QUANDO/SE/ENTÃO (resposta por frase, distribuição de leads) e recebimento/envio de dados entre sistemas. 16. LGPD: Solicitações de dados e anonimização com trilha de auditoria. 17. Configurações: Ajustes de dados da empresa, segurança e permissões de acesso. ℹ️ 🔎 Itens que dependem de permissão Algumas seções (Agentes IA, Roteadores, Follow-ups, Memória, Skills, Webhooks/Automações, LGPD) aparecem de acordo com o papel na imobiliária: Corretor, Gestor ou Administrador. Se uma seção não aparece, peça ao administrador da conta para ajustar suas permissões. O que acontece depois Você pode clicar em qualquer uma das opções para abrir a funcionalidade correspondente sem perder o estado das outras abas. Problemas comuns - Algum item do menu não aparece: Algumas seções (como Agentes IA ou Configurações avançadas) são exibidas de acordo com as permissões do seu papel na imobiliária (Corretor, Gerente ou Administrador). Caso precise de acesso, solicite ao administrador da sua conta.

Funis & Gestão Kanban

Descartar e Ações do Lead

Descartar e Ações do Lead Quando uma negociação não avança ou o lead perde o interesse, é importante registrar o motivo do descarte no sistema para manter o funil limpo e gerar métricas comerciais confiáveis. Para que serve Remove o cartão da visão ativa do funil sem apagar o histórico de mensagens e dados do cliente, permitindo futuras campanhas de reativação de base. Como fazer 1. Localize o cartão do lead no Kanban. 2. Clique no menu de opções (três pontinhos) no canto superior direito do cartão ou abra os detalhes do lead. 3. Selecione a opção Descartar Oportunidade (ou arraste o cartão para a área inferior de descarte). 4. Uma janela de confirmação solicitará o motivo do descarte. Modal de Descarte de Oportunidade Detalhes do card do lead 5. Selecione o motivo correspondente (ex: Sem orçamento, Comprou com outra imobiliária, Contato inválido, Desistiu da compra). 6. (Opcional) Adicione uma observação explicativa. 7. Clique em Confirmar Descarte. O que acontece depois - O cartão é removido das colunas ativas do funil. - O contato permanece salvo na base de Contatos com seu histórico e conversas preservados. - As automações ativas para aquela oportunidade são pausadas. Como reabrir uma oportunidade descartada Caso o cliente volte a entrar em contato: 1. Acesse o menu Contatos. 2. Localize o cliente e abra seus detalhes. 3. Clique em Criar Nova Oportunidade para reinseri-lo no funil comercial.