O Impacto Imediato: Como essa mudança afeta sua operação e o que fazer
A chegada do LID não é apenas uma atualização técnica de rotina, é uma mudança de paradigma na forma como lidamos com os dados dos clientes. O impacto imediato dessa nova política de privacidade do WhatsApp é que sistemas e integrações desatualizados começarão a falhar ao tentar registrar novos contatos, buscar históricos de conversas ou disparar mensagens, simplesmente porque o sistema buscará um número de telefone onde agora existe apenas um código anônimo.
Como você e sua equipe devem lidar com essa mudança? A resposta é: com tranquilidade, mas com ação estratégica rápida.
O CRM Zap já absorveu a parte mais pesada e complexa dessa atualização nos bastidores da nossa infraestrutura, garantindo que o seu fluxo de mensagens não pare de funcionar. No entanto, o seu papel agora é adaptar as rotinas do seu próprio software. Você precisará orientar sua equipe de desenvolvimento a deixar de tratar o número de telefone como a única forma de identificar um cliente. A partir de agora, o LID deve ser adotado como a chave principal e definitiva para todas as suas integrações, garantindo segurança e conformidade com as leis de proteção de dados.
Neste artigo, você vai entender de forma prática o que é esse novo padrão, por que ele foi criado, como o chatLid se comporta e como o CRM Zap trata esses retornos nos webhooks, com exemplos reais para preparar a sua software house.
Principais conclusões
- O impacto imediato exige que você pare de usar o telefone como chave única.
- Você deve começar a usar o @lid em vez do número para identificar usuários.
- Ajuste seu sistema para salvar o @lid recebido nos webhooks do CRM Zap.
- Se o chatLid vier nulo, trate como um chat não disponível e use o @lid do remetente.
- O CRM Zap já suporta @lid de forma nativa; você pode processar e buscar contatos normalmente.
- Atualize buscas, validações e logs do seu banco de dados para procurar por @lid.
O que é o LID e por que o WhatsApp está adotando esse identificador?
Você já deve ter notado que, em algumas situações, os webhooks não retornam mais o número de telefone tradicional. Isso ocorre porque o WhatsApp adotou o @lid como identificador padrão de contato.
O LID é uma etiqueta privada, um token que representa um usuário sem expor seu número de telefone real. É um apelido interno que o WhatsApp entrega ao seu sistema para referenciar aquele contato de forma segura.
Essa mudança é uma resposta direta às novas exigências globais de privacidade e proteção de dados (como a LGPD). O objetivo é reduzir a exposição direta do telefone nas requisições de API e logs de sistema. A vantagem prática é imensa: trabalhando apenas com identificadores anônimos, torna-se muito mais difícil o vazamento ou a cópia de bases de dados com milhões de telefones.
Para desenvolvedores e donos de software houses, isso significa repensar a modelagem de dados. O LID deve ser tratado como a nova chave primária estável para integrações com WhatsApp.
Diferença entre LID, phone e chatLid
Entender o papel de cada campo é vital para evitar falhas de integração no seu sistema:
- PHONE: Historicamente, era o número de telefone do usuário. Nas versões mais recentes, este campo pode trazer um LID mascarado em vez do número.
- LID (ou @lid): Identificador privado do usuário. É o token oficial que representa o contato sem revelar o telefone.
- CHATLID: Identificador da conversa ou do chat, e não do usuário. Em grupos ou threads específicas, ele aponta para o bate-papo. Pode retornar como nulo (null) quando não há um chat persistente associado ao evento.
Quando o phone retorna número? Geralmente em interações antigas ou webhooks de contas que ainda expõem o telefone.
Quando o phone retorna LID? Nas atualizações mais recentes focadas em privacidade (exemplo: g1ff3a2d@lid).
Seu sistema precisa tratar ambos os formatos. Validar esse campo exigindo “apenas números” vai gerar erros.
Como o CRM Zap trata o LID nos webhooks e integrações
O CRM Zap simplifica essa transição para você. Nossa infraestrutura normaliza os retornos do WhatsApp e apresenta campos estáveis. Se o webhook nativo varia – entregando telefone em um momento e LID em outro – o CRM Zap processa e estrutura isso para você.
Exemplos reais de retorno que você pode receber:
- Exemplo 1: from: “5511999999999”, messageId: “ABCD1234” (formato antigo, sem lid).
- Exemplo 2: from: “g1ff3a2d@lid”, messageId: “EFGH5678”, chatLid: null (formato novo).
O CRM Zap entrega um objeto de contato estruturado, garantindo que você sempre saiba onde buscar o identificador oficial. Além disso, quando um contato interage pela primeira vez com seu número disponível, nosso sistema registra essa relação. Se futuramente o WhatsApp passar a enviar apenas o LID daquele usuário, seu histórico de atendimento no CRM Zap permanecerá intacto.
Abaixo, um exemplo completo e testado de como você pode estruturar a recepção do webhook no seu backend, considerando o LID:
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook/crmzap', (req, res) => {
const payload = req.body;
if (payload.event === 'messages.upsert') {
const messageData = payload.data;
// Extraindo os identificadores de forma segura
const userLid = messageData.contact?.lid || null;
const userPhone = messageData.contact?.phone || null;
const chatIdentifier = messageData.chatLid || null;
// Lógica de prioridade para o sistema
const primaryIdentifier = userLid ? userLid : userPhone;
console.log('Novo evento recebido:');
console.log('Identificador Principal:', primaryIdentifier);
console.log('Telefone (se disponível):', userPhone);
// Aqui entra a sua lógica de salvar no banco de dados e rotear o atendimento
}
res.status(200).send('Webhook processado com sucesso');
});
app.listen(3000, () => console.log('Servidor de Webhook rodando na porta 3000'));
Posso enviar mensagens usando o LID?
Sim! Os endpoints de envio do CRM Zap aceitam perfeitamente o identificador LID no campo de destino. Em vez de enviar para 5511999999999, você envia para g1ff3a2d@lid. O CRM Zap se encarrega de traduzir isso e o WhatsApp entregará a mensagem ao destinatário correto.
Quando usar LID vs Phone?
- Use o LID sempre que estiver disponível no seu banco de dados. Ele é mais estável, à prova de mudanças futuras e evita falhas de roteamento.
- Use o PHONE apenas quando precisar exibir a informação visualmente para o seu usuário final em relatórios, ou em rotinas externas como envio de SMS.
Fluxo prático recomendado para seu software:
- Ao receber o webhook do CRM Zap, armazene o campo LID.
- Ao disparar mensagens, recupere este LID e envie para o nosso endpoint.
- Se houver falha, crie um log e faça uma tentativa de fallback usando o número de telefone (se você o tiver salvo).
Boas práticas para adaptar sua Software House
- Atualize seu banco de dados: Crie uma coluna ou campo dedicado e indexado para o LID na sua tabela de clientes/contatos.
- Mude a chave primária: Pare de usar o telefone como identificador único e exclusivo. Modele seu cliente usando um ID interno do seu sistema, atrelado ao LID e ao Telefone.
- Guarde o histórico: Armazene a data em que o LID foi coletado e faça reconciliação de dados.
- Evite duplicidade: Não deduplique contatos baseando-se apenas no telefone.
Posso converter LID em número ou vice-versa?
LID para Número: Não é possível fazer isso diretamente de forma pública. O objetivo do LID é justamente proteger o telefone.
Número para LID: É possível através das requisições, pois ao enviar uma mensagem para um número, as plataformas atualizadas já retornam o LID associado para futuras interações.
Projete seu banco de dados assumindo que você terá o mapeamento na maioria das vezes, mas não dependa de conversões mágicas. Atualize seus registros silenciosamente a cada novo webhook recebido.
Como o CRM Zap já está preparado para o futuro
Sistemas que dependem 100% da visibilidade do telefone vão sofrer com as próximas atualizações da Meta. O CRM Zap já implementou suporte completo e nativo ao LID e chatLid. Nós normalizamos os webhooks e aceitamos ambos os formatos no envio de mensagens para que a sua migração seja gradual e segura.
Checklist rápido de adoção para sua equipe de TI
- Adicionar campo LID indexado na tabela de contatos do banco de dados.
- Atualizar a recepção de webhooks para salvar o LID como prioridade.
- Adaptar rotinas de busca, validação e login para procurar por LID.
- Preparar o código para aceitar chatLid como nulo sem quebrar a aplicação.
- Implementar rotina de fallback de envio (tentar LID, se falhar, tentar telefone).
Conclusão
A mudança para o LID não é um detalhe passageiro, é o novo padrão de privacidade nas conversas. Enxergue o LID como um apelido seguro que garante a entrega das suas mensagens sem expor dados sensíveis. O CRM Zap já cuida da parte mais complexa dessa normalização para você. Basta adaptar seu banco de dados e suas rotinas de envio para garantir que sua operação escale com segurança e estabilidade.
Perguntas Frequentes (FAQ)
O que é o LID no WhatsApp?
É o novo identificador único de usuários que substitui a exposição do número de telefone em webhooks e retornos da API.
Por que o chatLid vem nulo e o que faço?
Ele retorna nulo em chats que não são persistentes ou em mensagens de sistema. Apenas trate o nulo como válido no seu código e faça a identificação pelo LID do remetente.
Como o CRM Zap facilita essa mudança?
Nossa plataforma aceita e retorna o LID em todos os endpoints e webhooks automaticamente. Você só precisa ajustar seu banco de dados para dar preferência a esse identificador, e o CRM Zap cuida de todo o roteamento e entrega das mensagens de ponta a ponta.