# Enviar status (stories)

`POST /send/status`

Pasta: **Enviar Mensagem**

## Autenticação

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

## Descrição

# Enviar status (stories)

Publica um status/stories no WhatsApp (texto, imagem, vídeo, áudio ou GIF). Não envia para um chat específico — publica no broadcast de status.

## Endpoint

```http
POST {{baseUrl}}/send/status
```

## Autenticação

Envie o token da instância no header:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| type | string | Sim | text, image, video, audio/voice, gif |
| content | object | Não | Conteúdo tipado (text, background_color, font, image/video/audio/file, caption, text_color) |
| text | string | Não | Atalho flat para content.text (type=text) |
| caption | string | Não | Atalho flat para content.caption |
| background_color | string|number | Não | Preset (ex. solid_blue) ou ARGB |
| font | string|number | Não | none, serif, sans_serif, norse, bubble, italic, bold, script/dancing |
| file / image / video / audio | string | Não | Atalhos flat de URL de mídia em content |
| status_jid_list | string[] | Não | Audiência privada deste status (JIDs) |
| recipients | string[] | Não | Alias de status_jid_list |
| mentions | string[] | Não | Até 5 contatos notificados sobre o status |
| status_setting | string | Não | contacts | whitelist | blacklist (omitir no Web com mentions) |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/status" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"type": "text", "text": "Novidades chegando!", "background_color": "solid_blue", "font": "sans_serif"}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "result": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `type is required`
- `text is required for text status`
- `media url or base64 is required` (tipos de mídia)
- `mentions limited to N contacts`

## Observações

- A resposta usa `result` (não `message`).
- Presets de cor: solid_green, solid_blue, solid_red, solid_purple, solid_orange, solid_teal, solid_pink, solid_indigo, solid_yellow, solid_cyan, solid_black, solid_white, gradient_*.

## Corpo (exemplo)

```json
{
  "type": "text",
  "text": "Novidades chegando!",
  "background_color": "solid_blue",
  "font": "sans_serif"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/status" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "text",
  "text": "Novidades chegando!",
  "background_color": "solid_blue",
  "font": "sans_serif"
}'
```

---

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