Contactos
Gestiona contactos de WhatsApp con Wazend: listar, obtener, actualizar, verificar números, bloquear y consultar LIDs.
Métodos para gestionar contactos de WhatsApp. WhatsApp Web no permite añadir contactos, por lo que la API tampoco lo admite.
@lid y @c.us
WhatsApp asigna un LID (identificador local) único a cada usuario para ocultar su número de teléfono en grupos y otros lugares. Puedes mensajear a cualquiera usando su LID o su PN (número de teléfono, @c.us).
Consejo
Usa la API de LIDs para mapear entre un número de teléfono (@c.us) y un @lid.
Obtener todos los contactos
GET /api/contacts/all?session=S0001[
{
"id": "5215551234567@c.us",
"number": "5215551234567",
"name": "Juan Pérez",
"pushname": "Juan",
"shortName": "Juan",
"isMe": false,
"isGroup": false,
"isWAContact": true,
"isMyContact": true,
"isBlocked": false
}
]Parámetros de consulta:
GET /api/contacts/all?session=S0001&limit=100&offset=0&sortBy=id&sortOrder=asclimit/offset— paginación.sortBy—idoname.sortOrder—descoasc.
Obtener contacto
GET /api/contacts?contactId=5215551234567&session=S0001El contactId puede ser un número de teléfono (5215551234567) o un chat id (5215551234567@c.us o 5215551234567@lid).
Actualizar contacto
Actualiza el contacto en tu agenda telefónica y en WhatsApp:
PUT /api/{session}/contacts/{chatId}{
"firstName": "Juan",
"lastName": "Pérez"
}Verificar si el número existe
GET /api/contacts/check-exists?phone=5215551234567&session=S0001{
"numberExists": true,
"chatId": "5215551234567@c.us",
"pn": "5215551234567@c.us"
}Números de Brasil
Usa check-exists antes de enviar a un número nuevo para obtener el chatId correcto (por el dígito 9 añadido tras 2012).
Obtener "about" del contacto
GET /api/contacts/about?contactId=5215551234567&session=S0001{ "about": "¡Hola, uso WhatsApp!" }Obtener foto de perfil
GET /api/contacts/profile-picture?contactId=5215551234567&session=S0001&refresh=true{ "profilePictureURL": "https://ejemplo.com/perfil.jpg" }Bloquear / desbloquear contacto
POST /api/contacts/blockPOST /api/contacts/unblock{
"contactId": "5215551234567",
"session": "S0001"
}API de LIDs
Mapea un identificador vinculado (@lid) a un número de teléfono (@c.us) en ambas direcciones.
Obtener todos los LIDs conocidos
GET /api/{session}/lids?limit=100&offset=0[
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}
]Obtener número de LIDs
GET /api/{session}/lids/count{ "count": 123 }Obtener número por LID
GET /api/{session}/lids/{lid}Recuerda escapar @ con %40 o usa solo el número.
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}Obtener LID por número de teléfono
GET /api/{session}/lids/pn/{phoneNumber}{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}Lids FAQ
Si no encuentras un número por LID, no tienes ese número en tu lista de contactos o no eres administrador del grupo. Para grupos, intenta refrescar grupos.