> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vzaps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usuários e contatos

> Consultar usuários, avatar e gerenciar contatos da instância

Use `users` e `contacts` para consultar perfis no WhatsApp e gerenciar contatos da instância.

Para instâncias, veja [Instâncias e billing](/pt-BR/sdk/python/instances-and-billing).

## Contatos

### `client.contacts.list(instance_id, instance_token=...)`

```python theme={null}
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(...)`

```python theme={null}
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(...)`

```python theme={null}
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(...)`

```python theme={null}
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(...)`

```python theme={null}
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=...)`

```python theme={null}
contacts = client.users.contacts("VZ...", instance_token="instance-token")
```

**Retorno:** envelope `{ code, success, data }` — mapa JID → contato (`FirstName`, `FullName`, `PushName`, etc.).