# Favoritar ou desfavoritar mensagem

`POST /message/star`

Pasta: **Ações na mensagem e Buscar**

## Autenticação

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

## Descrição

# Favoritar ou desfavoritar mensagem

Marca (ou remove a estrela de) uma mensagem via app state, sincronizando entre seus dispositivos.

## Endpoint

`POST {{baseUrl}}/message/star`

## 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` |
| messageid | string | Sim | ID da mensagem (`messageId` também aceito) |
| sender | string | Não | Remetente; se omitido, usa o próprio chat |
| fromMe | boolean | Não | Se a mensagem foi enviada por você (padrão `false`) |
| starred | boolean | Não | `true` favorita (padrão), `false` remove a estrela |

* Informe `chatid` ou `number`.

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/message/star" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "chatid": "5511999999999@s.whatsapp.net",
    "messageid": "3EB0538DA65A59F6D8A251",
    "fromMe": false,
    "starred": true
  }'
```

## Resposta de Sucesso

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

## Erros comuns

- `401` — token ausente ou inválido
- `500` — `messageid is required` / sessão offline

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "messageid": "3EB0538DA65A59F6D8A251",
  "fromMe": false,
  "starred": true
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/message/star" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "5511999999999@s.whatsapp.net",
  "messageid": "3EB0538DA65A59F6D8A251",
  "fromMe": false,
  "starred": true
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=acoes-na-mensagem-e-buscar/favoritar-ou-desfavoritar-mensagem)