> ## 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.

# Integração com Grupo OLX e Canal Pro

> Como receber na Morada.ai os leads gerados nos portais ZAP, Viva Real e OLX pelo Canal Pro.

A integração com **Grupo OLX / Canal Pro** permite que os leads gerados nos portais ZAP, Viva Real e OLX cheguem automaticamente à Morada.ai. Com isso, você centraliza o atendimento e pode iniciar o contato com o lead pela Mia conforme a configuração definida para sua operação.

<Info>
  Cada conta usa uma URL exclusiva para receber leads. Quando a integração estiver disponível no seu workspace, você pode criar a integração na plataforma e copiar essa URL pelo botão de cópia. Se a integração ainda não aparecer para você, fale com a equipe da Morada.ai.
</Info>

## Como funciona

Quando um interessado envia um contato em um anúncio publicado pelo Canal Pro, o Grupo OLX envia os dados desse lead para a URL configurada. A Morada.ai recebe o lead, identifica a conta conectada e aplica as regras configuradas para sua operação, como origem, empreendimento e modelo de mensagem.

<Note>
  A Morada.ai não solicita que você informe tokens ou chaves secretas nessa configuração. Se algum dado sensível for necessário, ele será tratado internamente pela equipe da Morada.ai.
</Note>

## Como configurar no Canal Pro

<Steps>
  <Step title="Acesse integrações na Morada.ai">
    Na plataforma da Morada.ai, acesse **Integrações** e clique em **Explorar Integrações**.

    <img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/explorar-integracoes.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=995ee48574ba7109f653a1d4b68ff0e9" alt="Tela de integrações da Morada.ai com destaque para o botão Explorar Integrações" width="1620" height="855" data-path="images/integracoes/grupo-olx/explorar-integracoes.png" />
  </Step>

  <Step title="Selecione Grupo OLX">
    Na lista de integrações disponíveis, selecione **Grupo OLX**.

    <img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/selecione-integracao.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=c71850a125abdcc2ed9407d6d3d4fce1" alt="Tela para selecionar a integração Grupo OLX na plataforma Morada.ai" width="1620" height="855" data-path="images/integracoes/grupo-olx/selecione-integracao.png" />
  </Step>

  <Step title="Crie a integração e copie a URL">
    Adicione a integração **Grupo OLX / Canal Pro** e copie a URL de recebimento de leads pelo botão de cópia.

    <img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/adicione-integracao.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=8e3d0dfe13a67d7a37fdb65c7d21ccae" alt="Tela da integração Grupo OLX com botão para copiar a URL de webhook" width="1620" height="855" data-path="images/integracoes/grupo-olx/adicione-integracao.png" />

    <Note>
      Se a integração ainda não estiver disponível no seu workspace, solicite a ativação para a equipe da Morada.ai.
    </Note>
  </Step>

  <Step title="Acesse o Canal Pro">
    No Canal Pro, acesse o menu lateral esquerdo.
  </Step>

  <Step title="Abra as configurações de integração">
    Clique em **Configurações** e depois em **Integrações**.
  </Step>

  <Step title="Configure o recebimento de leads">
    Na aba **Leads**, encontre a opção **Receber leads no CRM** e clique em **Configurar**.
  </Step>

  <Step title="Informe o CRM e a URL">
    Na tela de configuração, informe o nome do CRM como **Morada.ai** e cole a URL copiada na plataforma da Morada.ai no campo de URL de leads.
  </Step>

  <Step title="Salve as alterações">
    Clique em **Salvar alterações** para ativar o envio dos leads para a Morada.ai.
  </Step>
</Steps>

## O que acontece depois

Após a configuração, novos leads gerados nos anúncios do Canal Pro passam a ser enviados para a Morada.ai. Dependendo da configuração da sua operação, a plataforma pode:

* registrar a origem do lead como Grupo OLX / Canal Pro;
* relacionar o lead ao empreendimento ou anúncio correspondente;
* aplicar regras diferentes por tipo de contato recebido;
* iniciar uma conversa com a Mia quando houver um modelo de mensagem configurado.

<Tip>
  Após salvar a integração no Canal Pro, faça um teste com a equipe da Morada.ai para confirmar se o lead chegou corretamente e se a conversa foi iniciada quando houver um modelo de mensagem configurado.
</Tip>

## Vínculo com o empreendimento

Para que a Morada.ai entenda qual empreendimento está por trás de um lead enviado pelo Canal Pro, é necessário relacionar o código do anúncio da plataforma externa com o empreendimento cadastrado na Morada.ai.

No envio do lead, o Canal Pro informa um identificador chamado `clientListingId`. Esse identificador representa o código do anúncio ou imóvel na plataforma externa, como ZAP, Viva Real ou OLX. Ao mapear esse código para um empreendimento da Morada.ai, a plataforma consegue identificar qual empreendimento interno deve ser usado naquele atendimento.

Quando esse vínculo está correto, a plataforma consegue:

* associar o lead ao empreendimento certo;
* usar as informações do empreendimento no atendimento da Mia;
* aplicar regras de mensagem e atendimento específicas para aquele caso;
* usar um modelo de mensagem específico quando houver essa necessidade;
* registrar a origem e o contexto do lead com mais precisão.

Para criar esse vínculo, acesse a integração Grupo OLX e clique em **Gerenciar Integrações**.

<img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/gerenciar-integracao.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=9e979a7115d3e4cb92780725933f3bc1" alt="Tela de integrações conectadas com destaque para Gerenciar Integrações no card do Grupo OLX" width="1620" height="855" data-path="images/integracoes/grupo-olx/gerenciar-integracao.png" />

Depois, abra a aba **Mapeamento de Evento Externo**.

<img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/mapeamento-de-eventos.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=85afaedd6d58322566c76bc64783cbe2" alt="Tela da integração Grupo OLX com destaque para a aba Mapeamento de Evento Externo" width="1620" height="855" data-path="images/integracoes/grupo-olx/mapeamento-de-eventos.png" />

Clique em **Adicionar novo** para cadastrar um novo mapeamento.

<img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/adicionar-novo-mapeamento.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=83b5dd3deae8d514767a4e93d1642a7e" alt="Tela de mapeamento de evento externo com destaque para o botão Adicionar novo" width="1620" height="855" data-path="images/integracoes/grupo-olx/adicionar-novo-mapeamento.png" />

No campo **Nome do evento (Regex)**, informe o `clientListingId` enviado pelo Canal Pro. Em seguida, selecione o empreendimento, o agente e o modelo de mensagem que devem ser usados para esse lead.

<img src="https://mintcdn.com/moradaai-f7bfc739/HTnZu3CFtOPp6UTZ/images/integracoes/grupo-olx/preencher-mapeamento.png?fit=max&auto=format&n=HTnZu3CFtOPp6UTZ&q=85&s=598e74118e7b26547596b5cb3fbc08f7" alt="Modal de mapeamento de evento externo preenchido com clientListingId, empreendimento, agente e modelo de mensagem" width="1620" height="855" data-path="images/integracoes/grupo-olx/preencher-mapeamento.png" />

<Warning>
  Leads com `clientListingId` mapeado usam a regra específica daquele empreendimento. Para leads sem mapeamento, a equipe da Morada.ai pode configurar um modelo de mensagem padrão. Sem mapeamento e sem modelo padrão, o lead ainda será ingerido, mas nenhuma conversa automática será iniciada.
</Warning>

## Quando falar com o suporte

Entre em contato com a equipe da Morada.ai se:

* você ainda não recebeu a URL da integração;
* a integração **Grupo OLX / Canal Pro** ainda não aparece no seu workspace;
* os leads não estão chegando na plataforma;
* o lead chegou sem vínculo com o empreendimento esperado;
* você precisa revisar o mapeamento entre `clientListingId` e empreendimento;
* você precisa alterar ou configurar o modelo de mensagem usado após a chegada do lead;
* você quer configurar regras diferentes para tipos de lead do Canal Pro.

## Referência do Canal Pro

O passo a passo oficial do Canal Pro está disponível na Central de Ajuda do ZAP Imóveis: [Como integrar leads via CRM?](https://ajuda.zapimoveis.com.br/s/article/como-solicitar-a-integracao-de-leads-com-o-meu-software)
