# Fixar ou desafixar mensagem

`POST /message/pin`

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

## Autenticação

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

## Descrição

# Fixar ou desafixar mensagem

Fixa (ou remove o pin) de uma mensagem no chat para todos os participantes (`PinInChatMessage`).

## Endpoint

`POST {{baseUrl}}/message/pin`

## 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 | Autor da mensagem (recomendado em grupos) |
| pin | boolean | Não | `true` fixa (padrão), `false` desafixa |

* Informe `chatid` ou `number`.

## Exemplo de Requisição

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

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0PINMSG",
    "timestamp": "2026-07-17T06:45:00Z"
  }
}
```

## Erros comuns

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

## Observações

- Não existe campo `duration` neste endpoint: o pin é PIN_FOR_ALL / UNPIN_FOR_ALL.

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "messageid": "3A12345678901234567890123456789012",
  "pin": true
}
```

## cURL

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

---

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