Maytapi
Maytapi/Documentación/LID a teléfono
LID a teléfonoIncluido en todos los planesAPI de WhatsApp de LID a número de teléfono
WhatsApp envía cada vez más identificadores de privacidad como 112893567721673@lid en lugar de números. Resuélvelos a números reales con una sola petición — y obtén el LID de un número — para que tu CRM no cree contactos duplicados.
- @lid → teléfono
- teléfono → @lid
- participantes de grupos
- sin coste 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); // 3461xxxxx67lid = "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"]) # 3461xxxxx67{
"success": true,
"data": {
"id": "3461xxxxx67@c.us",
"name": "John Doe",
"phone": "3461xxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Dónde encontrarás @lid
Los LID aparecen donde WhatsApp oculta el número a los dispositivos vinculados.
-
grupos
Participantes de grupos
Los grupos grandes o nuevos suelen listar miembros como @lid en lugar de @c.us.
-
comunidades
Comunidades
Los grupos de anuncios y los miembros de comunidades suelen devolverse como LID.
-
webhook
Mensajes entrantes
Los eventos del webhook pueden traer un remitente identificado solo por @lid.
-
pedidos
Pedidos y respuestas
Los ids de mensajes y pedidos pueden referirse a la forma @lid de un chat.
Convierte @lid en un número de teléfono
Pasa el LID — con o sin el sufijo @lid — a lidToPhone. Obtienes el id del chat, el nombre y el número cuando WhatsApp los expone.
- ✓Acepta 112893567721673@lid o 112893567721673
- ✓Devuelve id (@c.us), name, phone y lid
- ✓success:false si el 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); // 3461xxxxx67lid = "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"]) # 3461xxxxx67{
"success": true,
"data": {
"id": "3461xxxxx67@c.us",
"name": "John Doe",
"phone": "3461xxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Encuentra el LID de un número
El sentido inverso sirve para asociar eventos @lid entrantes con contactos que ya tienes. Envía el número con su código de país.
- ✓Número con código de país, sin + ni espacios
- ✓Misma respuesta que lidToPhone
- ✓success:false si el número no está en WhatsApp
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/phoneToLid/3461xxxxx67" \ -H "x-maytapi-key: $TOKEN"
{
"success": true,
"data": {
"id": "3461xxxxx67@c.us",
"name": "John Doe",
"phone": "3461xxxxx67",
"lid": "112893567721673@lid"
}
}Resuelve participantes de grupos automáticamente
Añade refresh=true a getGroups cuando la lista de participantes tenga entradas @lid. Maytapi actualiza el grupo desde WhatsApp y devuelve los miembros como @c.us cuando el número está disponible.
- ✓Funciona en getGroups y getGroups/{group_id}
- ✓Una consulta por grupo actualizado: úsalo solo cuando veas @lid
- ✓Los miembros que ocultan su número siguen como @lid
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getGroups/3461xxxxx67-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": [ "3461xxxxx67@c.us", "3461xxxxx43@c.us", "184412209955301@lid" // hides their number ]
Por qué resolver LID
-
Registros de CRM limpios
Asocia cada conversación a un contacto en lugar de crear uno nuevo por cada @lid.
-
Exportar grupos y comunidades
Exporta listas de miembros con números reales para moderación e informes.
-
Bots que recuerdan al usuario
Mantén el historial y el estado vinculados a la persona correcta.
FAQ de LID a número de teléfono
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Qué es un LID de WhatsApp?
Un LID (identificador vinculado) es un id de privacidad como 112893567721673@lid que WhatsApp usa en lugar del número en algunos chats, grupos y eventos.
¿Se puede resolver cualquier LID?
No. Si la persona oculta su número o WhatsApp no lo comparte con tu sesión, la API devuelve success:false y el contacto queda como @lid.
¿Tiene coste adicional?
No. lidToPhone, phoneToLid y la actualización de grupos están incluidos en todos los planes.
¿Debo usar refresh=true en cada getGroups?
No. Cada grupo actualizado consume una consulta a WhatsApp; úsalo solo cuando la lista tenga entradas @lid o parezca desactualizada.
Más funciones de WhatsApp API
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.