Webhooks, importações, log de acesso e respostas prontas

Estas são as ferramentas operacionais de Gestão: receber leads de fora, importar imóveis de parceiros, auditar acessos e padronizar mensagens.

Webhooks de leads — Menu Gestão › Webhooks de leads

Recebe leads de portais e sistemas externos via POST HTTP. Você copia o endereço do webhook e informa ao portal; os leads chegam direto no CRM e passam pela Roleta. Para integração programável própria, veja também API de leads.

Cada portal manda o lead com nomes de campo diferentes. Em vez de adivinhar, o webhook mostra o que chegou de verdade e deixa você escolher para onde vai cada informação.

Capturar, mapear e ativar

1. Crie o webhook e copie o endereço.
2. Cole no painel do portal e mande um lead de teste. Enquanto o webhook está em Capturando, tudo que chega é guardado e nenhum lead é criado — é a hora de olhar o conteúdo com calma.
3. Na aba Mapeamento, cada linha liga um campo que chegou a um campo do CRM (nome, telefone, e-mail, código do imóvel, mensagem, origem, campanha). A prévia mostra o valor que seria gravado.
4. Ative. Se quiser, marque a opção para aproveitar os envios que já tinham sido capturados — eles viram leads na hora da ativação.

A partir daí o lead entra pelo caminho completo: cai na roleta, gera o card no funil e avisa o corretor.

O campo que só aparece no lead de verdade

Muitos portais mandam menos informação no teste do que no lead real. Por isso o webhook continua guardando os envios mesmo depois de ativo: quando aparecer um campo que não existia antes, a tela mostra o aviso "campos novos apareceram" e basta abrir o mapeamento e apontar o destino dele. Não é preciso desligar nada nem refazer a configuração.

Se você já sabe o nome do campo antes de ele chegar, use Digitar o caminho manualmente na coluna "O que chega".

Ajustes de valor

Cada campo aceita ajustes simples: remover espaços sobrando, deixar só os números do telefone, tirar o 55 do começo, juntar dois campos (ex.: primeiro nome + sobrenome) ou gravar um valor fixo. Campos que você não mapear entram no fim da mensagem do atendimento, para nada se perder.

Atenção: os campos do grupo Avançado mudam a distribuição. "Corretor responsável" faz o lead ir direto para uma pessoa, pulando a roleta; "Não notificar" silencia o aviso e a IA.

Importante: os envios guardados contêm dados do lead (nome, telefone, e-mail). Guardamos os 20 últimos de cada webhook por 30 dias, e você pode apagá-los quando quiser pelo botão na aba "O que chegou".

Importações XML — Menu Gestão › Importações XML

Atualiza seus imóveis a partir de um XML de parceiro. Útil para manter o estoque sincronizado com uma fonte externa. (Parceiros como Órulo/DWV ficam em Minhas integrações.)

Controle de acesso (log) — Menu Gestão › Controle de acesso

Registra quem acessou o sistema e quando — auditoria de segurança. Use para conferir acessos suspeitos ou confirmar quem fez login.

Respostas prontas — Menu Gestão › Respostas prontas

Mensagens reutilizáveis com variáveis (ex: {nomedolead}, {codigoimovel}) para agilizar o atendimento no WhatsApp sem digitar tudo de novo. As mesmas mensagens aparecem no botão Mensagem Rápida da ficha do lead.

Dica: a variável {linkimovelfotos} envia o link do imóvel de interesse do lead com as fotos liberadas no site (o visitante vê a galeria completa sem precisar se cadastrar). Use {linkimovel} quando quiser manter o pedido de cadastro para ver as fotos.

Problemas comuns

• Lead do portal não chegou — abra o webhook na aba "O que chegou". Se não houver nenhum envio, o problema está no cadastro do endereço no painel do portal. Se há envios mas nenhum virou lead, confira o estado: em Capturando ou Pausado o webhook guarda sem criar.
• O lead chegou sem nome ou sem telefone — o CRM recusa o lead que não tem pelo menos um dos dois. Confira no mapeamento se o campo de nome ou o de telefone está apontado para o campo certo do envio.
• Um campo aparece no lead real mas não veio no teste — é o normal. Ele fica marcado como campo novo na aba Mapeamento; aponte o destino e salve.
• Variável da resposta pronta não foi substituída — use exatamente o nome da variável (ex: {nomedolead}).

Perguntas frequentes

Qual a diferença entre Webhook e API de leads? O webhook é uma URL pronta para o portal mandar o lead; a API é para você programar o envio a partir de um sistema próprio.