API do WhatsApp para imobiliária: responder lead na hora, qualificar e agendar visita

Na imobiliária, a API não oficial do WhatsApp resolve o que mais perde negócio: o lead que espera horas por resposta. O sistema responde em segundos, qualifica o interesse com uma lista, envia fotos, vídeo e localização do imóvel, convida para a visita com um evento de agenda e distribui a conversa para o corretor certo — tudo no número da imobiliária. Abaixo, o fluxo completo com os endpoints da WAME e os cuidados para não transformar follow-up em insistência.

A camada não oficial não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

O problema: lead de imóvel esfria rápido

Quem procura imóvel manda mensagem para várias imobiliárias ao mesmo tempo. A primeira que responde com informação útil — valor atualizado, fotos, disponibilidade de visita — costuma ficar com a conversa. As outras recebem "já encontrei, obrigado".

O corretor, por sua vez, está em visita, no trânsito, em reunião. Não tem como responder em segundos. É aqui que a automação entra: o sistema faz a primeira resposta e a qualificação, e o corretor entra com o lead pronto.

A camada não oficial se encaixa bem nesse cenário porque não exige template aprovado nem janela de 24h — o follow-up de uma visita marcada para semana que vem sai em texto livre — e porque fotos, vídeos, localização e convite de evento são recursos nativos do app. Veja o panorama em vantagens da API não oficial.

Etapa 1: resposta imediata ao lead

Há dois pontos de entrada:

• O cliente escreve primeiro (clicou no botão do anúncio ou no link do site). O webhook recebe a mensagem e o bot responde.
• O lead chega por formulário de portal ou site, com telefone e o código do imóvel. O seu sistema faz o primeiro contato.

No segundo caso, a pessoa acabou de pedir contato sobre aquele imóvel — é comunicação esperada. Personalize com o que ela pediu:

curl -X POST "https://us.api-wa.me/SUA_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "text": "Oi, Mariana! Aqui é da Imobiliária Horizonte. Vi seu interesse no apartamento de 2 quartos na Vila Mariana (cód. VM-204). Ele segue disponível. Quer que eu te mande as fotos e o vídeo?"
  }'

Antes de disparar, vale confirmar que o número informado no formulário tem WhatsApp, para não gastar envio com telefone fixo ou digitado errado: verificar se o número tem WhatsApp.

Note que a primeira mensagem é texto. Botões e listas enviados como primeira mensagem para quem nunca falou com o número podem não aparecer no celular do destinatário. Abra com texto; o menu vem depois.

Etapa 2: qualificação por lista

Com a conversa aberta, uma mensagem de lista pergunta o essencial sem obrigar ninguém a digitar:

curl -X POST "https://us.api-wa.me/SUA_KEY/message/list" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "text": "Pra eu te mostrar opções parecidas, me conta: qual a sua faixa de valor?",
    "buttonText": "Escolher faixa",
    "sections": [
      {
        "title": "Compra",
        "rows": [
          { "title": "Até R$ 400 mil", "rowId": "compra_ate400" },
          { "title": "R$ 400 a 700 mil", "rowId": "compra_400_700" },
          { "title": "Acima de R$ 700 mil", "rowId": "compra_700mais" }
        ]
      },
      {
        "title": "Aluguel",
        "rows": [
          { "title": "Até R$ 3 mil", "rowId": "aluguel_ate3" },
          { "title": "Acima de R$ 3 mil", "rowId": "aluguel_3mais" }
        ]
      }
    ]
  }'

A escolha volta como interactive.list_reply.id no webhook formato meta. Repita para bairro e número de quartos, se fizer sentido. Três perguntas bastam; mais que isso vira formulário e o cliente desiste.

Se quiser um agente de IA conduzindo essa conversa em linguagem natural, o desenho está em agente de IA SDR no WhatsApp.

Etapa 3: fotos, vídeo, ficha e localização

Material do imóvel sai pelos endpoints de mídia, cada um com URL e legenda:

# Fotos (uma por mensagem, com legenda curta)
curl -X POST "https://us.api-wa.me/SUA_KEY/message/image" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999", "url": "https://cdn.exemplo.com/vm204/sala.jpg", "caption": "Sala com varanda — VM-204" }'

# Vídeo do tour
curl -X POST "https://us.api-wa.me/SUA_KEY/message/video" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999", "url": "https://cdn.exemplo.com/vm204/tour.mp4", "caption": "Tour completo" }'

# Ficha técnica em PDF
curl -X POST "https://us.api-wa.me/SUA_KEY/message/document" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999", "url": "https://cdn.exemplo.com/vm204/ficha.pdf", "mimetype": "application/pdf", "fileName": "VM-204.pdf" }'

# Localização do imóvel
curl -X POST "https://us.api-wa.me/SUA_KEY/message/location" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999", "location": { "latitude": -23.5889, "longitude": -46.6388, "name": "Apartamento VM-204", "address": "Vila Mariana, São Paulo - SP" } }'

Mande quatro ou cinco fotos, não trinta. Álbum gigante empurra a conversa para cima e o cliente perde a pergunta do corretor. O tour em vídeo e a ficha resolvem o resto.

Para quem prefere um vídeo pessoal do corretor ("oi, sou o Carlos, vou te mostrar o apartamento"), o vídeo redondo (/message/video-note) tem cara de mensagem gravada na hora e costuma ter mais atenção que um link.

Etapa 4: convite de visita com evento

Quando o cliente topa visitar, um convite de evento aparece no chat com nome, descrição, data e endereço — muito mais claro que "combinado, quinta às 15h":

curl -X POST "https://us.api-wa.me/SUA_KEY/message/event" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "name": "Visita — Apartamento VM-204",
    "description": "Corretor: Carlos. Levar documento com foto.",
    "startTime": "2026-10-08T18:00:00Z",
    "locationName": "Portaria do edifício",
    "locationAddress": "Rua Exemplo, 120 — Vila Mariana, São Paulo"
  }'

Repare no horário em UTC: 18h UTC são 15h em Brasília. Converta antes de montar o convite. No dia, um lembrete em texto algumas horas antes reduz a falta; o padrão de lembretes está em lembrete de agendamento no WhatsApp.

Etapa 5: distribuir o lead entre corretores

Aqui há dois modelos, e os dois funcionam pela API.

Modelo A — tudo no número da imobiliária. O cliente continua falando com o número central, e cada conversa recebe a label do corretor responsável. O corretor atende pela plataforma de atendimento da imobiliária (um Chatwoot, por exemplo), filtrando pela sua label:

# Criar a label do corretor (uma vez)
curl -X POST "https://us.api-wa.me/SUA_KEY/labels" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Corretor Carlos", "color": 3 }'

# Atribuir a conversa ao corretor
curl -X POST "https://us.api-wa.me/SUA_KEY/labels/ID_DA_LABEL" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999" }'

O rodízio — próximo corretor livre, por bairro, por faixa de valor — fica no seu sistema. Mais sobre labels em labels na API do WhatsApp, e sobre vários atendentes no mesmo número em multiatendimento.

Modelo B — o cliente fala direto com o corretor. O bot qualifica e, no final, envia o cartão de contato do corretor escolhido:

curl -X POST "https://us.api-wa.me/SUA_KEY/message/contact" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "contact": { "fullName": "Carlos — Imobiliária Horizonte", "organization": "Imobiliária Horizonte", "phoneNumber": "5511988887777" }
  }'

O modelo A mantém o histórico com a imobiliária (corretor que sai não leva a carteira). O modelo B é mais pessoal, mas espalha as conversas por números que você não controla. Muitas imobiliárias usam A para o primeiro contato e B só depois da proposta.

Follow-up sem insistência

Imóvel tem ciclo longo: a pessoa visita, pensa, conversa com a família, volta semanas depois. O follow-up automático ajuda — desde que respeite o ritmo de quem está decidindo:

• Uma mensagem útil vale mais que três "e aí?". "O proprietário aceitou avaliar proposta abaixo do anúncio" é motivo para escrever. "Ainda tem interesse?" toda semana não é.
• Novos imóveis só dentro do perfil informado e com pedido explícito: "Quer que eu te avise quando aparecer 2 quartos nessa região?"
• Aceite o não. Quem diz "já comprei" sai da sequência na hora.

Lista comprada, base antiga de anos atrás ou disparo do mesmo texto para centenas de números é outra conversa: gera bloqueio e denúncia, e esbarra no freio da própria API, que responde 429 quando o mesmo conteúdo vai para números demais em poucos minutos. A WAME não apoia spam — as regras estão em uso responsável da API não oficial. Trabalhando com leads que pediram contato, a taxa de bloqueio fica muito baixa para quem usa do jeito certo.

Status e canal para a vitrine

Para divulgar imóveis sem mandar mensagem a ninguém, dois recursos da camada não oficial funcionam como vitrine:

• Status, visto por quem salvou o número da imobiliária — "imóvel da semana" com foto e link: postar status pela API.
• Canal do WhatsApp, que só alcança quem escolheu seguir: canal pela API.

Conclusão

Para imobiliárias e corretores, a API não oficial do WhatsApp encurta o tempo entre o interesse e a conversa: resposta imediata ao lead, qualificação por lista, fotos, vídeo, ficha e localização do imóvel, convite de visita com evento e distribuição por labels ou cartão de contato. O que mantém o número saudável é falar com quem pediu e fazer follow-up com motivo, não com insistência. Os endpoints de cada etapa estão na documentação.