Pular para o conteúdo principal
Use users e contacts para consultar perfis no WhatsApp e gerenciar contatos da instância. Para instâncias, veja Instâncias e billing.

​
Contatos

​
client.contacts.list(instance_id, instance_token=...)

contacts = client.contacts.list("VZ...", instance_token="instance-token")
Retorno: envelope { code, success, data } com data[] de contatos (jid, Name, IsInWhatsapp, etc.).

​
client.contacts.add(...)

client.contacts.add(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511888888888",
    first_name="Maria",
    full_name="Maria Silva",
)
Retorno: envelope { code, success, data } com mensagem de confirmacao (ex.: "Contact added").

​
Usuários

​
client.users.info(...)

info = client.users.info(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Retorno: envelope { code, success, data } com perfil do usuario (VerifiedName, Status, PictureId, etc.).

​
client.users.check(...)

exists = client.users.check(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Retorno: envelope { code, success, data.users[] } com phone, exists, jid por numero consultado.

​
client.users.avatar(...)

avatar = client.users.avatar(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Retorno: envelope { code, success, data } com base64 e mimetype da foto.

​
client.users.contacts(instance_id, instance_token=...)

contacts = client.users.contacts("VZ...", instance_token="instance-token")
Retorno: envelope { code, success, data } — mapa JID → contato (FirstName, FullName, PushName, etc.).