Skip to Content
Wazend

Contatos

Gerencie contatos de WhatsApp com a Wazend: listar, obter, atualizar, verificar números, bloquear e consultar LIDs.

Métodos para gerenciar contatos de WhatsApp. O WhatsApp Web não permite adicionar contatos, por isso a API também não o admite.

@lid e @c.us

O WhatsApp atribui um LID (identificador local) único a cada usuário para ocultar seu número de telefone em grupos e outros lugares. Você pode enviar mensagem a qualquer pessoa usando seu LID ou seu PN (número de telefone, @c.us).

Dica

Use a API de LIDs para mapear entre um número de telefone (@c.us) e um @lid.

Obter todos os contatos

GET /api/contacts/all?session=S0001
Resposta
[
  {
    "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 — paginação.
  • sortBy — id ou name.
  • sortOrder — desc ou asc.

Obter contato

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

O contactId pode ser um número de telefone (5215551234567) ou um chat id (5215551234567@c.us ou 5215551234567@lid).

Atualizar contato

Atualiza o contato na sua agenda telefônica e no WhatsApp:

PUT /api/{session}/contacts/{chatId}
Corpo
{
  "firstName": "Juan",
  "lastName": "Pérez"
}

Verificar se o número existe

GET /api/contacts/check-exists?phone=5215551234567&session=S0001
Resposta
{
  "numberExists": true,
  "chatId": "5215551234567@c.us",
  "pn": "5215551234567@c.us"
}

Números do Brasil

Use check-exists antes de enviar para um número novo para obter o chatId correto (por causa do dígito 9 adicionado após 2012).

Obter "about" do contato

GET /api/contacts/about?contactId=5215551234567&session=S0001
Resposta
{ "about": "Olá, estou usando o WhatsApp!" }

Obter foto de perfil

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

Bloquear / desbloquear contato

POST /api/contacts/block
POST /api/contacts/unblock
Corpo
{
  "contactId": "5215551234567",
  "session": "S0001"
}

API de LIDs

Mapeie um identificador vinculado (@lid) para um número de telefone (@c.us) nos dois sentidos.

Obter todos os LIDs conhecidos

GET /api/{session}/lids?limit=100&offset=0
Resposta
[
  {
    "lid": "5215551234567@lid",
    "pn": "5215551234567@c.us"
  }
]

Obter número de LIDs

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

Obter número por LID

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

Lembre-se de escapar @ com %40 ou use apenas o número.

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

Obter LID por número de telefone

GET /api/{session}/lids/pn/{phoneNumber}
Resposta
{
  "lid": "5215551234567@lid",
  "pn": "5215551234567@c.us"
}

Lids FAQ

Se você não encontrar um número por LID, não tem esse número na sua lista de contatos ou não é administrador do grupo. Para grupos, tente atualizar grupos.