Integração Mapaprop ↔ MercadoLibre — Guia para clientes

O que você pode fazer com esta integração?

Conectar sua conta do MercadoLibre ao Mapaprop permite que você:

1. Publique seus anúncios imobiliários no MercadoLibre diretamente pelo Mapaprop, sem carregar os dados novamente.
2. Receba as perguntas e consultas de interessados vindas do MercadoLibre na sua caixa de entrada do Mapaprop, junto com as mensagens dos seus outros canais (site, rede, etc.).
3. Responda as perguntas públicas do ML pelo Mapaprop — a resposta é publicada automaticamente no seu anúncio do MercadoLibre.
4. Entre em contato diretamente com os interessados que usam os botões de WhatsApp, ligação ou visita do MercadoLibre.
5. Veja as visitas que seus anúncios recebem no Relatório de Visitas do Mapaprop, junto com as visitas dos seus outros canais (site, portais, rede MLS). As visitas são sincronizadas uma vez por dia. Categoria visual: MercadoLibre (laranja).

1. Conectar sua conta do MercadoLibre

Pré-requisitos

• Assinatura Mapaprop Plus ou superior (Pro / Business). A integração com o MercadoLibre é uma funcionalidade premium.
• Conta do MercadoLibre do tipo "Imobiliária". Contas pessoais comuns não podem publicar anúncios de imóveis. Se sua conta for comum, você precisará convertê-la primeiro. Veja o guia oficial de conversão.

Passos para conectar

1. Dentro do Mapaprop, vá em Configurações → Contas Conectadas → MercadoLibre.
2. Clique em Conectar.
3. O site do MercadoLibre vai abrir no seu navegador. Faça login com sua conta de imobiliária.
4. Autorize as permissões que o Mapaprop precisa (publicar, receber mensagens, consultar imóveis).
5. Você será redirecionado ao Mapaprop, onde verá o status Conectado junto com seus planos de publicação disponíveis.

Manutenção da conexão

• O token de conexão com o MercadoLibre se renova automaticamente a cada poucas horas, sem que você precise fazer nada.
• Se por algum motivo o token expirar e não puder ser renovado, você verá um aviso "Reconectar conta" na página do MercadoLibre. Um clique e pronto.
• Somente usuários com papel de admin ou manager podem conectar ou desconectar a conta.

📖 Guia completo de configuração

2. Publicar um imóvel no MercadoLibre

Pré-requisitos para publicar

Um imóvel só pode ser publicado no ML se:

• Sua conta MercadoLibre estiver conectada e ativa (sem token expirado).
• Você tiver um plano de publicação disponível (Gratuito, Prata, Ouro, Ouro Premium, etc.). Os planos são comprados no MercadoLibre.
• O imóvel estiver publicado no Mapaprop (não em rascunho).
• O imóvel tiver os dados mínimos exigidos pelo MercadoLibre para sua categoria (preço válido, localização, título, descrição, imagens, atributos obrigatórios).

Passos para publicar

1. Vá em Imóveis → seu imóvel → Publicação.
2. Na seção Publicar em Redes → MercadoLibre, clique em Publicar.
3. O editor de publicação do ML vai abrir com um assistente que vai te guiar:
   • Passo 1 — Título e Plano: escolha o título (máx. 60 caracteres, sem dados de contato), e o plano que quer usar (os planos com cota disponível aparecem destacados).
   • Passo 2 — Categoria e Localização: o Mapaprop mapeia automaticamente sua operação (venda/aluguel) e o tipo de imóvel para a categoria correspondente do ML. A localização também é mapeada a partir dos dados do Mapaprop. Se a zona do seu imóvel nunca foi publicada no MercadoLibre antes, você vai ver a mensagem "Zona não mapeada" com um botão Mapear Zona — ao clicar nele, abre um diálogo onde você escolhe a Província, Cidade e Bairro do MercadoLibre correspondentes à sua zona. Isso é feito apenas uma vez por zona e fica configurado para todos os imóveis daquela mesma localização.
   • Passo 3 — Atributos: preencha os atributos obrigatórios e opcionais (quartos, ambientes, orientação, comodidades, etc.). O Mapaprop pré-preenche o que você já tem no seu imóvel.
   • Passo 4 — Revisão e Publicação: revise tudo e clique em Publicar.
4. O MercadoLibre pode levar de alguns segundos a vários minutos para ativar o anúncio. Durante esse tempo você verá o status "Em processamento".

Status possíveis do seu anúncio

Subestados de "Em processamento"

Quando o anúncio está Em processamento, o MercadoLibre nos informa por que ainda não foi ativado:

⚠️ Se seu anúncio ficar muito tempo nesse status sem passar para Ativo, o ML eventualmente o encerra sozinho e ele aparece como Finalizado. Isso geralmente indica que o plano está saturado e você precisa de mais cota ou trocar de plano.

Ações disponíveis conforme o status

Detalhe de cada ação:

• Ver anúncio: abre o anúncio público do ML em uma nova aba.
• Editar: modifique descrição, preço, atributos, etc. Alguns campos ficam bloqueados dependendo do status (veja a matriz abaixo).
• Pausar / Ativar: ocultar ou reativar o anúncio sem perder o registro nem as visitas acumuladas.
• Finalizar: encerra o anúncio no ML. Você também pode Finalizar e excluir para removê-lo completamente.
• Republicar (botão ↻ verde, apenas em Finalizado): cria um anúncio novo no MercadoLibre vinculado ao encerrado, transferindo visitas e vendas se foi encerrado há menos de 60 dias. Veja a seção 2.5.
• Excluir do MercadoLibre (botão lixeira): apaga o anúncio do ML mas mantém seus dados no Mapaprop para publicar novamente mais adiante.
• Atualizar Status: pergunta ao MercadoLibre o status atual do anúncio e atualiza a informação no Mapaprop. Útil quando o anúncio está "Em processamento" para ver se já foi ativado.
• Completar pagamento: só aparece no status "Requer pagamento". Abre a página de pagamento no MercadoLibre para contratar o pacote do plano escolhido.

O que pode ser modificado em cada status?

Os campos marcados como Sync são atualizados automaticamente quando você edita o imóvel no Mapaprop (preço, descrição, fotos, quartos, ambientes, etc.). O resto exige abrir o editor do MercadoLibre e salvar.

2.5 Republicar um anúncio finalizado

Quando um anúncio está no status Finalizado, você pode publicá-lo novamente sem perder o histórico usando o botão Republicar (ícone ↻ verde) que aparece no card do MercadoLibre no painel de publicação.

O que exatamente isso faz?

O Mapaprop usa o endpoint oficial do MercadoLibre /items/{id}/relist, que cria um anúncio novo vinculado ao encerrado por meio de um identificador parent_item_id. Não é uma cópia nem uma duplicata: o ML reconhece o vínculo e, sob certas condições, transfere as estatísticas.

Benefícios de republicar (vs. publicar um novo do zero)

• ✅ Transferência de visitas e vendas se o anúncio original foi encerrado há menos de 60 dias. Isso não se aplica ao plano Gratuito.
• ✅ Vínculo formal entre o anúncio novo e o anterior (melhor para a reputação da sua conta ML).
• ✅ Permite trocar o plano ao republicar (por exemplo, passar de Gratuito para Prata se agora você tiver um pacote contratado, ou de Prata para Gratuito se quiser economizar).
• ✅ Reaproveita todos os dados do anúncio original (atributos, localização, categoria, descrição, fotos).

Limitações

• ❌ Passaram mais de 60 dias: o botão Republicar continua funcionando, mas o ML não transfere mais visitas nem vendas (começa com estatísticas zeradas).
• ❌ Você quer trocar o título ou a categoria: não é possível via Republicar. É preciso Excluir e depois Publicar do zero como um anúncio novo.

Como trocar o plano ao republicar

1. Entre no card do MercadoLibre e clique no botão Editar (lápis).
2. Desça até a seção Título e Plano do editor.
3. No menu suspenso Plano de publicação, escolha o plano desejado.
4. Clique em Salvar (isso persiste a troca de plano no Mapaprop).
5. Clique no botão Republicar (↻ verde) do card.
6. O Mapaprop envia ao MercadoLibre a solicitação de relist com o novo plano. Seu anúncio fica criado com o plano escolhido.

💡 Se você escolher um plano pago (Prata, Ouro) e não tiver um pacote contratado no MercadoLibre, o anúncio ficará no status Requer pagamento. Complete o pagamento no ML para ativá-lo, ou mude para o plano Gratuito.

Regras importantes do MercadoLibre

• Não inclua dados de contato (telefone, e-mail, WhatsApp) no título ou na descrição. O MercadoLibre pode bloquear o anúncio.
• O preço deve estar dentro dos intervalos permitidos por cada categoria. Se ultrapassar ou ficar abaixo, o Mapaprop mostra a mensagem de erro com o limite exato.
• As fotos devem ser reais do imóvel, sem marcas d'água nem dados de contato sobrepostos.
• A categoria é escolhida pelo MercadoLibre com base nos dados do seu imóvel — se a categoria não estiver correta, verifique se o tipo de imóvel e a operação estão configurados corretamente no Mapaprop.

Se a publicação falhar

O Mapaprop vai te mostrar:

• Uma sugestão amigável na parte superior quando o erro é autossolucionável (ex.: "Segundo o MercadoLibre, o preço é inválido para esta categoria. O máximo permitido é X").
• A mensagem técnica do MercadoLibre abaixo, caso você precise reportá-la ao suporte.
• Um botão "Copiar Relatório" para que você possa colá-lo em um chamado de suporte se o problema persistir.

Erros comuns e como resolvê-los

2.7 Editar um imóvel publicado no MercadoLibre

Quando você entra para editar um imóvel que já está publicado no MercadoLibre (a partir de Editar imóvel, Preços, Imagens, Vídeos ou Plantas), o Mapaprop mostra um banner informativo acima do formulário que avisa:

• Em que status o anúncio está no MercadoLibre (Ativo / Pausado / Finalizado / Requer pagamento / Em processamento / etc.) com a cor do status.
• Quais campos NÃO vão ser sincronizados ao salvar — chips com ícone 🔒 indicando os campos bloqueados pelas regras do MercadoLibre.

Exemplo

Se seu anúncio está Ativo, o banner verde diz:

✓ Publicado no MercadoLibre — Ativo As alterações vão sincronizar automaticamente com o anúncio publicado. O MercadoLibre NÃO permite modificar título, zona, categoria nem plano em anúncios ativos: esses campos não serão refletidos no ML.

⚠ ATENÇÃO! Não são sincronizados: 🔒 Título · 🔒 Zona · 🔒 Categoria · 🔒 Plano

Por que esse banner é importante

Antes de ele existir, os clientes editavam o título do imóvel esperando que fosse atualizado no ML — mas o ML rejeita essa alteração silenciosamente em anúncios ativos. O banner avisa antes de editar quais campos não vão para o portal, para que você saiba o que esperar.

Status e comportamento

3. Receber mensagens do MercadoLibre

Quando um interessado consulta um dos seus anúncios no MercadoLibre, a mensagem dele aparece automaticamente na sua caixa de entrada do Mapaprop (aba principal Caixa de Entrada).

Tipos de consulta que você pode receber

O MercadoLibre oferece diferentes vias de contato ao interessado. Na sua caixa de entrada, cada consulta aparece com um badge indicando o tipo:

Como identificar as mensagens do MercadoLibre

Na lista da caixa de entrada, as mensagens do ML têm uma tag amarela "MercadoLibre", junto com o badge do tipo de consulta. Assim você as diferencia rapidamente das mensagens do seu site, rede de portais, etc.

Dados do interessado

Cada mensagem inclui os dados que o MercadoLibre compartilha com você:

• Nome
• E-mail
• Telefone
• Documento (se o interessado o forneceu)

Esses dados são salvos automaticamente como um contato no Mapaprop. Você pode usá-los para fazer acompanhamento ou adicioná-los a campanhas.

4. Responder a uma pergunta pública do MercadoLibre

As perguntas do MercadoLibre são públicas no seu anúncio e têm regras especiais que vale a pena conhecer antes de responder.

Regras do MercadoLibre para as respostas

1. Você só pode enviar UMA resposta por pergunta. Não é possível editar nem adicionar uma segunda resposta.
2. A resposta é pública e fica visível no anúncio para todos os compradores.
3. Não inclua dados de contato (telefone, e-mail, WhatsApp) na resposta. O MercadoLibre pode bloqueá-la.
4. Responda rápido. O MercadoLibre mede seu tempo médio de resposta e o usa como parte da sua reputação como vendedor. Respostas atrasadas ou perguntas sem resposta reduzem seu ranking.
5. Máximo de 2000 caracteres por resposta.

Como responder pelo Mapaprop

1. Entre na caixa de entrada e clique na pergunta que quer responder.
2. Você verá o texto da pergunta junto com:
   • Um painel informativo com as regras do MercadoLibre (lembrete do que não pode ser feito).
   • Uma caixa de texto para escrever sua resposta, com contador de 2000 caracteres.
3. Escreva sua resposta e clique no botão amarelo de enviar.
4. O Mapaprop vai pedir sua confirmação (é a única resposta pública — queremos ter certeza).
5. Ao confirmar, a resposta é publicada imediatamente no MercadoLibre e exibida na conversa com o badge "Publicada no ML".

Se você já respondeu pelo painel do MercadoLibre

Se preferir responder diretamente pelo app ou painel web do MercadoLibre:

• O Mapaprop detecta automaticamente e sincroniza a resposta na sua caixa de entrada (leva entre alguns segundos e 1-2 minutos).
• A conversa mostra a resposta com o badge "Respondida no ML" (se distingue do caso anterior).
• Não há conflito nem duplicação — sempre existe uma única resposta pública no ML.

E se eu tentar responder pelo Mapaprop algo que já foi respondido no ML?

O Mapaprop detecta o caso e sincroniza automaticamente a resposta existente. Você verá um aviso: "Já respondida pelo MercadoLibre. A resposta existente foi sincronizada." Nada novo é publicado, nada é duplicado.

Depois da resposta

Uma vez que a pergunta foi respondida (de onde quer que seja):

• O botão de resposta pública desaparece.
• Aparece uma nova caixa de texto (cor verde) que permite continuar a conversa com o interessado por e-mail privado pelo Mapaprop.
• As mensagens posteriores NÃO são publicadas no MercadoLibre — são comunicação privada vendedor ↔ interessado via e-mail.

5. Entrar em contato diretamente por WhatsApp, ligação ou e-mail

Para as consultas que não são perguntas (WhatsApp, ligação, visita, cotação), o Mapaprop mostra botões de ação direta dentro da mensagem do interessado:

• Abrir WhatsApp → abre o WhatsApp Web/App com uma mensagem pré-montada pronta para enviar.
• Ligar → usa o discador do seu telefone ou computador para ligar diretamente.
• Enviar e-mail → abre seu cliente de e-mail com o assunto pré-preenchido (ex.: "Agendamento de visita", "Cotação solicitada").

Esses contatos não exigem resposta pública no ML — o interessado pediu explicitamente para ser contatado por aquele meio.

6. Reputação no MercadoLibre — por que responder rápido importa

O MercadoLibre avalia seu perfil de vendedor com base em:

• Tempo médio de resposta às perguntas.
• Percentual de perguntas respondidas (deixar perguntas sem resposta conta como negativo).
• Qualidade das respostas (respostas detalhadas > respostas genéricas).

Uma boa reputação posiciona você melhor nos resultados de busca e gera mais consultas.

O Mapaprop ajuda você a manter uma boa reputação:

• As mensagens chegam à caixa de entrada em tempo quase real (segundos a poucos minutos).
• Você pode responder pelo celular, tablet ou computador sem abrir o MercadoLibre.
• Se você responder pelo painel do ML diretamente, o Mapaprop sincroniza mesmo assim — sem atrito.

7. Perguntas frequentes

Posso ter mais de uma conta do MercadoLibre conectada? Não. Cada cliente Mapaprop só pode conectar UMA conta do MercadoLibre. Se você quiser trocar de conta, primeiro desconecte a atual e depois conecte a nova.

O que acontece se um vendedor / usuário da minha equipe quiser publicar mas não for admin? Ele pode publicar imóveis no ML normalmente, mas a conexão/desconexão da conta do MercadoLibre só pode ser feita pelo admin. O que acontece se eu mudar o preço ou os dados do imóvel no Mapaprop? O Mapaprop sincroniza automaticamente as alterações com o MercadoLibre quando você edita o imóvel em Editar imóvel, Preços, Imagens, Mapa ou Plantas. Você não precisa fazer nada manualmente. Os campos que sincronizam automaticamente são: preço, descrição, fotos (até 30), coordenadas, vídeo, e atributos numéricos/booleanos mapeados (quartos, ambientes, área, comodidades). Ao salvar, você verá um toast com o resultado real:

• 🟢 "MercadoLibre — Anúncio sincronizado" (verde) se o anúncio está ativo e o ML aceitou as alterações.
• 🟡 "MercadoLibre — Alterações pendentes" (amarelo) se as alterações foram salvas no Mapaprop mas não foram enviadas ao portal (por exemplo: anúncio pausado, finalizado, aguardando pagamento, em processamento, em revisão). O detalhe do toast explica o motivo.
• 🔴 "MercadoLibre — Erro ao sincronizar" (vermelho) se o ML rejeitou a atualização por algum motivo técnico.

Quais alterações NÃO são sincronizadas automaticamente com o MercadoLibre? O MercadoLibre impõe restrições para anúncios ativos ou pausados: NÃO permite modificar título, zona/localização, categoria nem plano. Se você mudar o título do imóvel no Mapaprop enquanto o anúncio ML está ativo, o Mapaprop mostra um toast informativo: o banner preventivo acima do formulário (que aparece assim que você entra para editar) — com um aviso ATENÇÃO! Não são sincronizados: Título · Zona · Categoria · Plano. A descrição, o preço, as fotos e os atributos são atualizados corretamente. Para trocar o título ou a categoria, você precisa finalizar o anúncio, excluí-lo do MercadoLibre e publicá-lo novamente do zero.

Posso programar publicações automáticas? Ainda não. Atualmente cada publicação é ativada manualmente pelo botão Publicar. Publicações programadas automaticamente estão no roadmap.

O que acontece se um comprador fizer a mesma pergunta duas vezes? O MercadoLibre as mostra como perguntas separadas (cada uma com seu próprio ID). Você verá as duas na sua caixa de entrada. Responda-as individualmente.

Os dados de contato do interessado são reais? Sim. O MercadoLibre compartilha os dados reais do comprador com você (nome, e-mail, telefone). São dados verificados pelo ML.

O Mapaprop publica meus dados ou os da minha imobiliária no MercadoLibre? No anúncio público só aparece o nome da sua imobiliária e os dados do imóvel. Os dados seus/do corretor ficam internos no MercadoLibre para que os compradores entrem em contato com você pelos canais habilitados (pergunta, WhatsApp, ligação, etc.).

O que acontece se o MercadoLibre bloquear meu anúncio? O mais comum é que o título, a descrição ou as fotos tenham incluído dados de contato ou algo que viole as políticas. Verifique a mensagem de erro no Mapaprop, corrija o anúncio e publique novamente. Se o bloqueio persistir sem motivo aparente, entre em contato com o suporte do MercadoLibre.

Por que muitos dos meus anúncios ficam no status "Em processamento" e não ativam? O mais comum é que o plano escolhido não tem cota disponível (pack_quota_pending). Cada plano do MercadoLibre (Gratuito, Prata, Ouro) tem uma cota limitada de publicações simultâneas. Se você publicou mais anúncios do que o plano permite, os excedentes ficam aguardando. Soluções: comprar mais pacote no MercadoLibre, trocar para um plano superior, ou finalizar anúncios antigos para liberar cota. Veja a FAQ específica de anúncios "Em processamento".

O que faço se o anúncio diz "Requer pagamento"? Significa que você escolheu um plano pago (Prata ou Ouro) mas não tem um pacote contratado na sua conta do MercadoLibre. Você tem duas opções: clicar em Completar pagamento pelo Mapaprop para contratar o pacote no ML, ou cancelar o anúncio e republicar com o plano Gratuito. Veja a FAQ específica de "Requer pagamento".

Posso trocar o plano de um anúncio já finalizado? Sim. Quando o anúncio está no status Finalizado, você pode trocar o plano no editor do MercadoLibre, salvar, e depois clicar no botão Republicar (↻ verde). O anúncio novo será publicado com o plano escolhido. Isso não é possível enquanto o anúncio está ativo. Veja a FAQ específica de troca de plano em anúncio finalizado.

Quanto tempo leva para um anúncio ativar depois de publicado? Depende do plano e do status da conta. Com cota disponível e fotos saudáveis, os anúncios ativam em segundos a poucos minutos. Se o plano não tiver cota ou as fotos demorarem para baixar, pode levar horas ou ficar bloqueado até o problema ser resolvido. Use o botão Atualizar Status para consultar o status atual.

O que significa "Imagens em download"? O MercadoLibre tenta baixar as fotos do servidor do Mapaprop para incluí-las no anúncio. Se por algum motivo não conseguir baixá-las (lentidão de rede, IP bloqueado, etc.), o anúncio fica nesse subestado e não ativa. Geralmente se resolve sozinho em poucos minutos. Se persistir por mais de 1 hora, reporte ao suporte.

O que acontece com as visitas e vendas se eu republicar um anúncio finalizado? Se você republicar dentro de 60 dias desde o encerramento, o MercadoLibre transfere as visitas e vendas para o anúncio novo (exceto no plano Gratuito). Depois de 60 dias, ainda é possível republicar, mas as estatísticas começam do zero.

Posso importar meus anúncios atuais do ML para o Mapaprop? Essa funcionalidade está em planejamento e vem em breve. Por enquanto, os anúncios existentes no ML continuam sendo administrados pelo painel do MercadoLibre até você publicá-los pelo Mapaprop.

Suporte

Se você tiver problemas com a integração:

1. Leia o guia de configuração detalhado: Notion - Configuração do MercadoLibre.
2. Converter sua conta em imobiliária: Notion - Converter conta.
3. Reportar um problema técnico: abra um chamado na seção Configurações → Reportar um problema.
4. Problemas com sua conta no MercadoLibre (faturamento, cotas, bloqueios): entre em contato diretamente com o suporte oficial do MercadoLibre.

Outras ajudas do MercadoLibre

Publicar no MercadoLibre

Converter sua conta MercadoLibre em Imobiliária

Configuração do MercadoLibre

Reconectar conta do MercadoLibre