Wazend

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
Respuesta
[
  {
    "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=asc
  • limit / offset — paginación.
  • sortBy — id o name.
  • sortOrder — desc o asc.

Obtener contacto

GET /api/contacts?contactId=5215551234567&session=S0001

El 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}
Cuerpo
{
  "firstName": "Juan",
  "lastName": "Pérez"
}

Verificar si el número existe

GET /api/contacts/check-exists?phone=5215551234567&session=S0001
Respuesta
{
  "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
Respuesta
{ "about": "¡Hola, uso WhatsApp!" }

Obtener foto de perfil

GET /api/contacts/profile-picture?contactId=5215551234567&session=S0001&refresh=true
Respuesta
{ "profilePictureURL": "https://ejemplo.com/perfil.jpg" }

Bloquear / desbloquear contacto

POST /api/contacts/block
POST /api/contacts/unblock
Cuerpo
{
  "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
Respuesta
[
  {
    "lid": "5215551234567@lid",
    "pn": "5215551234567@c.us"
  }
]

Obtener número de LIDs

GET /api/{session}/lids/count
Respuesta
{ "count": 123 }

Obtener número por LID

GET /api/{session}/lids/{lid}

Recuerda escapar @ con %40 o usa solo el número.

Respuesta
{
  "lid": "5215551234567@lid",
  "pn": "5215551234567@c.us"
}

Obtener LID por número de teléfono

GET /api/{session}/lids/pn/{phoneNumber}
Respuesta
{
  "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.

En esta página