Maytapi
Maytapi/Documentação/LID para telefone
LID para telefoneIncluído em todos os planosAPI do WhatsApp de LID para número de telefone
O WhatsApp envia cada vez mais identificadores de privacidade como 112893567721673@lid em vez de números. Resolva-os em números reais com uma única requisição — e descubra o LID de um número — para o seu CRM não criar contatos duplicados.
- @lid → telefone
- telefone → @lid
- participantes de grupos
- sem custo extra
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/lidToPhone/112893567721673@lid" \ -H "x-maytapi-key: $TOKEN"
const lid = "112893567721673@lid";
const res = await fetch(
`https://api.maytapi.com/api/${PID}/${PHONE_ID}/getContacts/lidToPhone/${lid}`,
{ headers: { "x-maytapi-key": TOKEN } }
);
const { success, data } = await res.json();
if (success) console.log(data.phone); // 55119xxxxxx67lid = "112893567721673@lid"
res = requests.get(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/getContacts/lidToPhone/{lid}",
headers={"x-maytapi-key": TOKEN},
timeout=10,
).json()
if res["success"]:
print(res["data"]["phone"]) # 55119xxxxxx67{
"success": true,
"data": {
"id": "55119xxxxxx67@c.us",
"name": "John Doe",
"phone": "55119xxxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Onde você vai encontrar @lid
LIDs aparecem sempre que o WhatsApp oculta o número dos dispositivos conectados.
-
grupos
Participantes de grupos
Grupos grandes ou novos costumam listar membros como @lid em vez de @c.us.
-
comunidades
Comunidades
Grupos de avisos e membros de comunidades costumam vir como LID.
-
webhook
Mensagens recebidas
Eventos do webhook podem trazer um remetente identificado apenas por @lid.
-
pedidos
Pedidos e respostas
Ids de mensagens e pedidos podem referenciar a forma @lid de um chat.
Converta @lid em número de telefone
Envie o LID — com ou sem o sufixo @lid — para lidToPhone. Você recebe o id do chat, o nome e o número quando o WhatsApp os disponibiliza.
- ✓Aceita 112893567721673@lid ou 112893567721673
- ✓Retorna id (@c.us), name, phone e lid
- ✓success:false quando o número está oculto
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/lidToPhone/112893567721673@lid" \ -H "x-maytapi-key: $TOKEN"
const lid = "112893567721673@lid";
const res = await fetch(
`https://api.maytapi.com/api/${PID}/${PHONE_ID}/getContacts/lidToPhone/${lid}`,
{ headers: { "x-maytapi-key": TOKEN } }
);
const { success, data } = await res.json();
if (success) console.log(data.phone); // 55119xxxxxx67lid = "112893567721673@lid"
res = requests.get(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/getContacts/lidToPhone/{lid}",
headers={"x-maytapi-key": TOKEN},
timeout=10,
).json()
if res["success"]:
print(res["data"]["phone"]) # 55119xxxxxx67{
"success": true,
"data": {
"id": "55119xxxxxx67@c.us",
"name": "John Doe",
"phone": "55119xxxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Encontre o LID de um número
O caminho inverso ajuda a associar eventos @lid recebidos aos contatos que você já tem. Envie o número com o código do país.
- ✓Número com código do país, sem + nem espaços
- ✓Mesma resposta de lidToPhone
- ✓success:false se o número não estiver no WhatsApp
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/phoneToLid/55119xxxxxx67" \ -H "x-maytapi-key: $TOKEN"
{
"success": true,
"data": {
"id": "55119xxxxxx67@c.us",
"name": "John Doe",
"phone": "55119xxxxxx67",
"lid": "112893567721673@lid"
}
}Resolva participantes de grupos automaticamente
Adicione refresh=true ao getGroups quando a lista de participantes tiver entradas @lid. A Maytapi atualiza o grupo no WhatsApp e retorna os membros como @c.us sempre que o número estiver disponível.
- ✓Funciona em getGroups e getGroups/{group_id}
- ✓Uma consulta por grupo atualizado — use só quando aparecer @lid
- ✓Membros que ocultam o número continuam como @lid
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getGroups/55119xxxxxx67-1574073754@g.us?refresh=true" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getGroups?refresh=true&sort=true&page=1" \ -H "x-maytapi-key: $TOKEN"
// before: "112893567721673@lid" // after refresh=true: "participants": [ "55119xxxxxx67@c.us", "55119xxxxxx43@c.us", "184412209955301@lid" // hides their number ]
Por que resolver LIDs
-
CRM sem duplicatas
Associe cada conversa a um contato em vez de criar um novo registro por @lid.
-
Exportar grupos e comunidades
Exporte listas de membros com números reais para moderação e relatórios.
-
Bots que lembram o usuário
Mantenha histórico e estado ligados à pessoa certa.
FAQ de LID para número de telefone
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →O que é um LID do WhatsApp?
Um LID (identificador vinculado) é um id de privacidade como 112893567721673@lid que o WhatsApp usa no lugar do número em alguns chats, grupos e eventos.
Todo LID pode ser resolvido?
Não. Se a pessoa oculta o número ou o WhatsApp não o compartilha com sua sessão, a API retorna success:false e o contato continua como @lid.
Tem custo adicional?
Não. lidToPhone, phoneToLid e a atualização de grupos estão incluídos em todos os planos.
Devo usar refresh=true em todo getGroups?
Não. Cada grupo atualizado consome uma consulta ao WhatsApp; use apenas quando a lista tiver entradas @lid ou parecer desatualizada.
Mais recursos da WhatsApp API
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.