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[
{
"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— paginação.sortBy—idouname.sortOrder—descouasc.
Obter contato
GET /api/contacts?contactId=5215551234567&session=S0001O 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}{
"firstName": "Juan",
"lastName": "Pérez"
}Verificar se o número existe
GET /api/contacts/check-exists?phone=5215551234567&session=S0001{
"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{ "about": "Olá, estou usando o WhatsApp!" }Obter foto de perfil
GET /api/contacts/profile-picture?contactId=5215551234567&session=S0001&refresh=true{ "profilePictureURL": "https://ejemplo.com/perfil.jpg" }Bloquear / desbloquear contato
POST /api/contacts/blockPOST /api/contacts/unblock{
"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[
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}
]Obter número de LIDs
GET /api/{session}/lids/count{ "count": 123 }Obter número por LID
GET /api/{session}/lids/{lid}Lembre-se de escapar @ com %40 ou use apenas o número.
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}Obter LID por número de telefone
GET /api/{session}/lids/pn/{phoneNumber}{
"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.