# Enviar presença no chat

`POST /message/presence`

Pasta: **Enviar Mensagem**

## Autenticação

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

## Descrição

# Enviar presença no chat

Mostra no chat o indicador de "digitando…" ou "gravando áudio…". Use antes de responder para parecer mais humano. Não envia mensagem de texto.

## Endpoint

```http
POST {{baseUrl}}/message/presence
```

## Autenticação

Envie o token da instância no header:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Chat alvo |
| chatid | string | Sim* | Alternativa a number |
| state | string | Sim* | composing / typing / digitando, recording / gravando / audio, paused / pause / parado |
| presence | string | Sim* | Alias de state |
| media | string | Não | audio / recording / voice / ptt para indicar gravação de áudio |
| isAudio | bool | Não | Se true e media vazio, usa media=audio |
| delay | number | Não | Segundos (ou valor numérico) mantendo a presença antes de enviar paused automaticamente |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/message/presence" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "state": "composing", "delay": 3}'
```

## Resposta de Sucesso

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

## Erros comuns

- Destinatário ausente
- Instância desconectada
- Token inválido

## Observações

- Resposta de sucesso: apenas `{ "success": true }` (sem objeto message).
- Aliases: `typing`/`digitando` → composing; `recording`/`gravando` → composing + áudio.

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "state": "composing",
  "delay": 3
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/message/presence" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "state": "composing",
  "delay": 3
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-presenca-no-chat)