> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cadastro de empreendimento

> Guia detalhado sobre o processo de cadastro de empreendimentos na plataforma, incluindo cadastro manual e importação por IA.

Este guia tem como objetivo detalhar o processo de cadastro de empreendimentos na plataforma, ajudando você a compreender os recursos disponíveis para garantir que o cadastro seja realizado de forma completa, padronizada e eficiente.

## O que e?

O cadastro de empreendimentos e a ferramenta da plataforma que permite incluir informações detalhadas sobre os imóveis de uma empresa. Com ele, a IA passa a ter todo o contexto necessário para oferecer os empreendimentos mais adequados de acordo com o perfil do lead, aumentando a assertividade no atendimento.

Atualmente, oferecemos duas formas principais de cadastro:

1. **Cadastro manual**: indicado para clientes com poucos empreendimentos. Permite inserir dados detalhados de forma individual, configurando unidades, endereço e mídias.

<img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/cadastro-manual-empreendimento.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=8fb0867c7ea16f35c63627a4862e7361" alt="Cadastro Manual Empreendimento" width="2948" height="976" data-path="images/empreendimentos/cadastro-manual-empreendimento.png" />

2. **Importação por IA**: ideal para clientes com muitos empreendimentos. A ferramenta sincroniza os dados a partir de uma URL, garantindo que as informações sejam atualizadas todos os dias, de forma automática.

<img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/importacao-ia-empreendimento.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=194fb982c59d4a4be921db2f3b16778d" alt="Importação Ia Empreendimento" width="2948" height="976" data-path="images/empreendimentos/importacao-ia-empreendimento.png" />

## Como funciona?

### Cadastro Manual

<Steps>
  <Step title="Acesse Gerenciar > Empreendimento > Adicionar novo > Adicionar manualmente" />

  <Step title="Preencha Nome e Parceiro">
    <img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/novo-produto-campos.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=b788dc7cc556e9764d7fdec981d5500a" alt="Novo Produto Campos" width="674" height="333" data-path="images/empreendimentos/novo-produto-campos.png" />
  </Step>

  <Step title="Configure as informações em Configurações Gerais">
    * Descrição (obrigatório)
    * Agentes (obrigatório)
    * Tipo de empreendimento (obrigatório)
    * Renda mínima
    * Status da obra (fase e datas de início e fim)
    * Pré-agendamento de visita
    * Informações de simulação e financiamento
  </Step>

  <Step title="Configure tipologias na aba Tipos de unidades">
    Exemplo: Apartamento tipo — 2 quartos, 2 banheiros, possui suíte, valor e área.
  </Step>

  <Step title="Cadastre o endereço">
    Use **Encontrar endereço** para que a IA busque longitude e latitude automaticamente. Preencha os campos restantes manualmente, se necessário.
  </Step>

  <Step title="Adicione mídias">
    Em **Mídias**, adicione imagens, vídeos, plantas, books, tabelas e links.

    | Tipo    | Formatos                  | Tamanho máximo          |
    | ------- | ------------------------- | ----------------------- |
    | Imagens | .jpeg, .png, .webp        | 5MB e 100 Mega Pixels   |
    | Videos  | .mp4                      | 16MB                    |
    | Plantas | .jpeg, .png, .webp, .pdf  | 100MB e 100 Mega Pixels |
    | Books   | .pdf, .pptx, .docx, .xlsx | 100MB e 100 Mega Pixels |

    <Tip>
      Utilize palavras-chave no campo "grupo da imagem" para que a IA interprete e encaminhe a mídia correta ao lead.
    </Tip>

    <video controls width="100%">
      <source src="https://mintlify.s3.us-west-1.amazonaws.com/moradaai-f7bfc739/images/empreendimentos/video-cadastro-empreendimento.mov" type="video/mp4" />
    </video>
  </Step>
</Steps>

### Importação Inteligente

<Steps>
  <Step title="Acesse Gerenciar > Empreendimento > Adicionar novo > Importação por IA">
    <img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/importacao-ia-empreendimento.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=194fb982c59d4a4be921db2f3b16778d" alt="Importação Ia Empreendimento" width="2948" height="976" data-path="images/empreendimentos/importacao-ia-empreendimento.png" />
  </Step>

  <Step title="Preencha os campos obrigatórios">
    * **Nome** para identificação da importação
    * **URL** que contém os dados dos empreendimentos
    * **Agentes**

          <img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/importacao-ia-formulario.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=d77a5f8a83ac83be473ad3e8fc0ca1bc" alt="Importação Ia Formulário" width="2870" height="1509" data-path="images/empreendimentos/importacao-ia-formulario.png" />
  </Step>

  <Step title="Inicie e acompanhe a sincronização">
    Após aplicar, a sincronização inicia automaticamente. Acompanhe em **Gerenciar importações**.

    <img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/gerenciar-importacoes.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=4e123fdf5e8b2abfc96d2c37e8fb1b55" alt="Gerenciar Importações" width="1118" height="368" data-path="images/empreendimentos/gerenciar-importacoes.png" />

    <Warning>
      A importação realiza buscas diárias. Se quiser editar empreendimentos manualmente, **desative a importação** antes — as alterações serão sobrescritas caso contrário.
    </Warning>
  </Step>
</Steps>

## Configurações avançadas

O ID Externo (também conhecido tecnicamente como *idOnPartner*) e o código único que identifica um empreendimento dentro do seu CRM. Ele funciona como a "chave de ligação" entre a Morada.ai e o seu sistema de vendas.

O preenchimento correto desse campo e indispensável para o sucesso da integração. Isso porque, sempre que um negócio e enviado ao seu sistema, o ID Externo e utilizado para indicar exatamente em qual empreendimento o lead demonstrou interesse.

<Warning>
  Se o campo estiver em branco ou com o código errado, o lead pode ser criado no CRM sem empreendimento correto vinculado, cair em uma fila genérica, ou, dependendo das regras do seu CRM, a criação do lead pode até mesmo ser bloqueada pela integração.
</Warning>

### Como configurar o ID Externo?

<Steps>
  <Step title="Acesse Gerenciar > Empreendimentos e clique em Editar" />

  <Step title="Em Configurações avançadas, localize o campo ID Externo" />

  <Step title="Insira o código do CRM e clique em Aplicar">
    Insira o código exato (numérico ou alfanumérico) que representa o empreendimento no seu CRM e verifique se o esquema é válido.

    <img src="https://mintcdn.com/moradaai-f7bfc739/fwcb_rT6vN2GwLQ5/images/empreendimentos/id-externo-configuracao.png?fit=max&auto=format&n=fwcb_rT6vN2GwLQ5&q=85&s=bf4d0ebd2d6096c9f761304c0cdaac35" alt="Id Externo Configuração" width="1511" height="612" data-path="images/empreendimentos/id-externo-configuracao.png" />
  </Step>
</Steps>

## Limitações atuais

* A **Importação inteligente** depende diretamente da qualidade dos dados da URL fornecida. Caso as informações estejam incompletas ou desatualizadas, isso impactará o cadastro dos empreendimentos.
* Não e possível mesclar manualmente os dados importados com informações cadastradas manualmente sem antes **desativar a sincronização**.
* O **Cadastro manual** pode se tornar mais demorado em casos de grandes bases de empreendimentos. Para entender melhor qual ferramenta utilizar em sua operação, entre em contato com o nosso time de suporte.
* A importação por IA não suporta imagens no formato **WEBP** do seu site.

***

## FAQ -- Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso cadastrar empreendimentos manualmente e também por importação?">
    Sim. E possível importar por IA e, depois, alterar as informações manualmente. No entanto, recomendamos desativar a importação por IA caso queira realizar edições manuais nos empreendimentos importados, para evitar que as alterações sejam sobrescritas.
  </Accordion>

  <Accordion title="Quantos empreendimentos posso cadastrar manualmente?">
    Não há limite. Porém, para bases grandes, a importação inteligente e mais prática e eficiente.
  </Accordion>

  <Accordion title="Preciso cadastrar imagens obrigatoriamente?">
    Não e obrigatório, mas fortemente recomendado. As mídias enriquecem o atendimento da IA e aumentam a conversão de leads.
  </Accordion>

  <Accordion title="O que acontece se eu não usar palavras-chave no grupo da imagem?">
    A IA pode não interpretar corretamente o conteúdo das imagens, o que pode resultar no envio de uma mídia diferente daquela solicitada pelo lead ou em ordem incorreta.
  </Accordion>

  <Accordion title="A importação inteligente atualiza os empreendimentos automaticamente?">
    Sim. Quando ativa, ela executa buscas diárias na URL cadastrada e atualiza os dados sempre que houver alterações no banco de dados do site.
  </Accordion>

  <Accordion title="O que acontece se a URL estiver offline ou com erros?">
    Nesse caso, a importação não será realizada automaticamente. No dia seguinte, durante a atualização diária, ocorrerá nova tentativa.
  </Accordion>

  <Accordion title="Posso alterar a URL após criar a importação automática?">
    Sim, e possível editar a URL sempre que necessário através do botão "Editar", na opção indicada pelos três pontinhos no canto lateral direito do empreendimento.
  </Accordion>
</AccordionGroup>
