# Configurar delay entre mensagens async

`POST /instance/updateDelaySettings`

Pasta: **Mensagem Async**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Configurar delay entre mensagens async

Ajusta o intervalo aleatório entre envios da fila assíncrona e os parâmetros de presença automática ("digitando…"). Valores negativos são normalizados para `0`; se `max < min`, o max é elevado ao min.

## Endpoint

`POST {{baseUrl}}/instance/updateDelaySettings`

## Autenticação

Header obrigatório: `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| msg_delay_min_ms | integer | Não | Delay mínimo entre mensagens async (ms) |
| msg_delay_max_ms | integer | Não | Delay máximo entre mensagens async (ms) |
| auto_presence_delay | boolean | Não | Ativa presença automática antes do envio |
| presence_ms_per_char | integer | Não | Ms de "digitando" por caractere do texto |
| presence_jitter_min_ms | integer | Não | Jitter mínimo da presença (ms) |
| presence_jitter_max_ms | integer | Não | Jitter máximo da presença (ms) |

Corpo opcional: campos omitidos podem ser gravados como zero/`false` conforme o bind.

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/updateDelaySettings" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "msg_delay_min_ms": 1000,
    "msg_delay_max_ms": 3000,
    "auto_presence_delay": true,
    "presence_ms_per_char": 50,
    "presence_jitter_min_ms": 100,
    "presence_jitter_max_ms": 500
  }'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "instance": {
    "id": "r183e2ef9597845",
    "msg_delay_min_ms": 1000,
    "msg_delay_max_ms": 3000,
    "auto_presence_delay": true
  },
  "runtime": {
    "connected": true
  }
}
```

## Erros comuns

- `401` — token ausente ou inválido
- `400` — JSON inválido
- `500` — falha ao persistir configurações

## Corpo (exemplo)

```json
{
  "msg_delay_min_ms": 1000,
  "msg_delay_max_ms": 3000,
  "auto_presence_delay": true,
  "presence_ms_per_char": 50,
  "presence_jitter_min_ms": 100,
  "presence_jitter_max_ms": 500
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/updateDelaySettings" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "msg_delay_min_ms": 1000,
  "msg_delay_max_ms": 3000,
  "auto_presence_delay": true,
  "presence_ms_per_char": 50,
  "presence_jitter_min_ms": 100,
  "presence_jitter_max_ms": 500
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=mensagem-async/configurar-delay-entre-mensagens-async)