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

# Configurações do Número

> Obtém ou atualiza as configurações de um número de telefone Business, incluindo chamadas (calling), criptografia de payload e armazenamento de dados.

<Note>
  Requer token de instância associado ao número de telefone. O número é resolvido automaticamente pelo token — não é necessário informar o `phone-number-id`.
</Note>

## Obter Configurações

### Parâmetros

#### Query

<ParamField query="include_sip_credentials" type="boolean" default="false">
  Quando `true`, inclui as credenciais SIP (senha) na resposta. Requer permissões adicionais.
</ParamField>

### Exemplo de Requisição

```bash theme={null}
curl --request GET \
  --url https://apis.vectalk.com.br/api/phone-numbers/settings \
  --header 'Authorization: Bearer {seu_token}'
```

### Resposta

```json theme={null}
{
  "calling": {
    "status": "NOT_SET",
    "call_icon_visibility": "NOT_SET",
    "callback_permission_status": "NOT_SET"
  },
  "storage_configuration": {
    "status": "DEFAULT"
  }
}
```

### Campos da Resposta

| Campo                                                  | Tipo   | Descrição                                                                                                           |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------- |
| `calling`                                              | object | Configurações de chamadas — veja [Configurações de Chamadas](/api-reference/calls/settings) para detalhes completos |
| `payload_encryption.status`                            | string | `enabled` ou `disabled`                                                                                             |
| `payload_encryption.client_encryption_key_fingerprint` | string | Fingerprint da chave (quando habilitado)                                                                            |
| `payload_encryption.cloud_encryption_key`              | string | Chave de criptografia da cloud (quando habilitado)                                                                  |
| `storage_configuration.status`                         | string | `DEFAULT` ou `IN_COUNTRY_STORAGE_ENABLED`                                                                           |
| `storage_configuration.data_localization_region`       | string | Região de armazenamento (quando in-country storage habilitado)                                                      |

<Note>
  O campo `password` nos servidores SIP só é retornado quando `include_sip_credentials=true`.
</Note>

***

## Atualizar Configurações

**`POST /phone-numbers/settings`**

Apenas **uma seção** de feature pode ser enviada por requisição.

### Seções Disponíveis

| Seção                   | Descrição                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| `calling`               | Configurações de chamadas (status, SIP, vídeo, ícone, SRTP) — veja [detalhes](/api-reference/calls/settings) |
| `payload_encryption`    | Criptografia de payload                                                                                      |
| `storage_configuration` | Configuração de armazenamento de dados                                                                       |
| `user_identity_change`  | Notificações de mudança de identidade do usuário                                                             |

### Exemplos

#### Habilitar Chamadas

```bash theme={null}
curl --request POST \
  --url https://apis.vectalk.com.br/api/phone-numbers/settings \
  --header 'Authorization: Bearer {seu_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "calling": {
      "status": "enabled",
      "call_icon_visibility": "DEFAULT"
    }
  }'
```

#### Habilitar SIP

```bash theme={null}
curl --request POST \
  --url https://apis.vectalk.com.br/api/phone-numbers/settings \
  --header 'Authorization: Bearer {seu_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "calling": {
      "status": "enabled",
      "sip": {
        "status": "enabled"
      },
      "srtp_key_exchange_protocol": "DTLS"
    }
  }'
```

#### Habilitar Criptografia de Payload

```bash theme={null}
curl --request POST \
  --url https://apis.vectalk.com.br/api/phone-numbers/settings \
  --header 'Authorization: Bearer {seu_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "payload_encryption": {
      "status": "enabled",
      "client_encryption_key": "BASE64_ENCODED_PUBLIC_KEY"
    }
  }'
```

### Resposta

```json theme={null}
{
  "success": true
}
```