# Configurar mensagens temporárias do chat

`POST /chat/ephemeral`

Pasta: **Chats**

## Autenticação

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

## Descrição

# Configurar mensagens temporárias do chat

Define o timer de mensagens que desaparecem em um chat (privado ou grupo — o mesmo handler de `/group/ephemeral`).

## Endpoint

`POST {{baseUrl}}/chat/ephemeral`

## Autenticação

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| chatid | string | Sim* | JID do chat |
| number | string | Sim* | Alternativa a `chatid` |
| jid | string | Sim* | Alternativa a `chatid` |
| seconds | integer | Não** | Duração em segundos (`0` desliga) |
| timer | integer | Não** | Alias de `seconds` |
| duration | string|number | Não** | Atalho: `"off"`/`"0"`, `"1d"`, `"7d"`, `"90d"` ou número |

* Informe `chatid`, `number` ou `jid`.
** Use um de `seconds`, `timer` ou `duration`. Valores: 86400 (1d), 604800 (7d), 7776000 (90d).

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/chat/ephemeral" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "chatid": "5511999999999@s.whatsapp.net",
    "duration": "7d"
  }'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `400` — `number or chatid is required`
- `400` — `unsupported duration "..."`
- `401` — token ausente ou inválido
- `500` — sessão offline

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "duration": "7d"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/chat/ephemeral" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "5511999999999@s.whatsapp.net",
  "duration": "7d"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=chats/configurar-mensagens-temporarias-do-chat)