Solicitação de Visita

Além de detalhar o processo, este guia busca fornecer ferramentas e recursos para facilitar a gestão das solicitações e otimizar a experiência tanto dos clientes quanto dos colaboradores.

Trabalhando com Solicitações de Visita

Para trabalhar de forma eficaz com as solicitações de visita, além de ativar as publicações, é necessário configurar horários, métodos de contato e integração com o calendário, bem como receber notificações em tempo real sobre novas solicitações, alterações de disponibilidade e atualizações de contato. Isso permite responder rapidamente, evitar mal-entendidos e programar visitas eficientes para maximizar o sucesso das suas publicações.

Atualizações em Tempo Real

É fundamental que os vendedores utilizem ferramentas de gestão de calendário e recebam notificações instantâneas sobre solicitações de visita, alterações de disponibilidade e atualizações de contato. Isso facilita respostas rápidas, evita contratempos e otimiza a programação das visitas, aumentando as oportunidades de negócio.

As atualizações em tempo real sobre a intenção de visita beneficiam tanto o vendedor quanto a plataforma, permitindo fornecer informações precisas. É essencial que o vendedor configure completamente sua aplicação com a URL onde receberá as notificações e faça o uso correto dos recursos da API.

Passos para iniciar a integração

As solicitações de visita são parte importante da experiência de imóveis. Para habilitar essa funcionalidade, siga os passos a seguir:

1. A conta do vendedor profissional ou imobiliária deve estar registrada

• Registre uma conta de vendedor profissional neste link.
• Se for um usuário de teste, siga a guia de configuração do seu usuário.

2. Registrar a aplicação para obter o token

• Siga os passos para gerar autorizações e tokens conforme descrito na guia de obtenção do Access Token.

3. Publicar itens na plataforma

• Se você já publicou ou está pronto para publicar, crie suas primeiras publicações e habilite nelas a funcionalidade de solicitação de visita.

Após realizar os passos anteriores, este guia explica como:

• 1. Marcar suas publicações para que tenham disponível a solicitação de visita.
• 2. Obter detalhes desse lead para gerenciar sua agenda da melhor forma possível.

Ativar Solicitação de Visita em Publicações

Se sua conta estiver habilitada como imobiliária ou corretora em um dos países indicados no início deste guia, suas publicações terão automaticamente a opção de solicitação de visita habilitada. Certifique-se de enviar o atributo CONTACT_SCHEDULE junto aos demais atributos obrigatórios ao publicar o item.

Se a sua publicação não tiver a opção de solicitação de visita marcada, ou se você precisar desabilitá-la, siga os passos abaixo:

1. 1. Acesse o Mercado Livre com seu usuário de teste ou vendedor.
2. 2. Clique no seu nome de usuário, abra o menu e selecione “Publicações”.


3. 3. No painel de publicações, localize a publicação desejada, clique nos três pontos à direita e selecione “Modificar”.


4. 4. Na janela de modificação, acesse a seção “Solicitação de visita” e clique para expandir as opções.
5. 5. Para habilitar a solicitação online, selecione “Oferecer solicitação online de visita”. Caso prefira o método tradicional, selecione “Agendar visitas manualmente”.
6. 6. Clique em “Confirmar” para finalizar.

Notificações de Leads de Visita

Será gerada uma notificação automática através do canal público VIS Leads com o filtro “Visit Request” sempre que um cliente potencial (comprador) no marketplace do Mercado Livre demonstrar interesse em visitar uma propriedade ou quando for feita uma modificação na agenda (independentemente da mudança de status).

Para ativar essa notificação, acesse o gerenciador de aplicativos onde você criou sua aplicação (Argentina, Brasil, Chile, México, Colômbia, Uruguai, Peru, Equador e Venezuela). Faça login com o usuário que criou a aplicação e siga os passos abaixo:

1. 1. No menu de três pontos da aplicação, selecione a opção “Editar”.


2. 2. Na seção “Informações básicas”, clique em “Continuar”.


3. 3. Em “Configuração e permissões”, localize “VIS Leads” na seção “Tópicos” e selecione “Visit request”.


4. 4. Por fim, configure a URL para receber as notificações e clique em “Editar” para salvar as alterações.

Quando você receber uma notificação de solicitação de visita, ela será semelhante ao exemplo a seguir:

{
  "_id": "abcd-qwer-1234",
  "topic": "vis_leads",
  "resource": "/vis/leads/{lead_id}",
  "user_id": 123456789,
  "application_id": 123456789123456789,
  "sent": "2025-01-27T18:21:06.159Z",
  "attempts": 1,
  "received": "2025-01-27T18:21:06.057Z",
  "actions": [
    "visit_request"
  ]
}

Você pode obter mais informações sobre esse tipo de notificação utilizando os recursos descritos na seção de Leads.

Gestão de Agenda

Gerar Agenda

Atualmente, não há um endpoint da API disponível para criar agendas diretamente no modelo de dados. No entanto, é possível simular a geração de agendas em publicações de teste acessando a URL do item publicado e clicando em Solicitar visita. Posteriormente, a agenda poderá ser gerada.

Posteriormente, a agenda poderá ser gerada. É importante destacar que é necessário estar autenticado com um usuário de teste no navegador.

Após selecionar a disponibilidade e enviar a solicitação, a ação será confirmada com uma mensagem semelhante à seguinte:

Acesse com o seu usuário de teste que possui a publicação marcada com solicitação de visita e entre em seu perfil:

No menu à esquerda, acesse o painel de pessoas interessadas. Na parte superior do painel, aparecerá uma aba com as solicitações de visita pendentes. Ao clicar nessa aba, serão listadas as solicitações e, em seguida, clique no botão Agendar visita para gerenciá-las.

Obter Detalhes da Agenda

Para obter o detalhe de uma agenda através do seu identificador (scheduleId), execute o seguinte endpoint, incluindo como parâmetro o identificador do lead.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/leads/$LEAD_ID

Parâmetros

A resposta obtida será semelhante à seguinte:

{
  "id": "44115522",
  "item_id": "MLA4037459422",
  "created_at": "2024-06-14T00:00:00Z",
  "contact_type": "schedule",
  "external_id": "13864821",
  "status": "active",
  "buyer_id": 123654987,
  "name": "Test Test",
  "email": "john@example.com",
  "phone": "+55 01 1111-1111"
}

Leituras recomendadas

• Gerenciar Pacotes de Imóveis
• Publicar Imóveis

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações