---
title: "Fixar mensagem no WhatsApp pela API (grupo e chat)"
description: "Como fixar e desafixar mensagens, marcar com estrela e fixar conversas no topo pela API não oficial do WhatsApp, com exemplos para grupos e atendimento."
url: "https://api-wa.me/blog/fixar-mensagem-whatsapp-api"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Fixar mensagem no WhatsApp pela API: regras do grupo, aviso do dia e conversa no topo

Raphael Serafim· Publicado em 28 de setembro de 2026· 7 min de leitura

Compartilhar

# Fixar mensagem no WhatsApp pela API: regras do grupo, aviso do dia e conversa no topo

Como fixar e desafixar mensagens, marcar com estrela e fixar conversas no topo pela API não oficial do WhatsApp, com exemplos para grupos e atendimento.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/fixar-mensagem-whatsapp-api.md)

**Pela API não oficial do WhatsApp você fixa uma mensagem no topo de uma conversa ou grupo com `POST /{key}/message/pin` (informando o `id` e, se quiser, a duração em segundos — o padrão é 7 dias), desafixa com `POST /{key}/message/unpin`, marca com estrela com `POST /{key}/message/{id}/keep` e fixa a conversa inteira no topo da sua lista com `PATCH /{key}/chat?action=pin`. Regras do grupo, aviso do dia e pedido em aberto passam a ficar sempre à vista.**

Grupo sem mensagem fixada é grupo onde a mesma pergunta é feita dez vezes por semana. Conversa importante sem destaque é conversa que o atendente perde no meio de outras cem. Fixar resolve os dois — e, por API, dá para automatizar a troca do que está fixado.

> A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

## Quatro recursos que parecem iguais

| Recurso | Endpoint | Quem vê | Para que serve |
| --- | --- | --- | --- |
| Fixar mensagem | `POST /message/pin` | Todos na conversa ou grupo | Regras, avisos, links importantes |
| Desafixar mensagem | `POST /message/unpin` | Todos | Trocar ou encerrar um aviso |
| Marcar com estrela | `POST /message/{id}/keep` | Só o seu número | Guardar comprovante, combinado |
| Fixar conversa | `PATCH /chat?action=pin` | Só o seu número | Chat prioritário no topo da lista |

A distinção importa: fixar mensagem é **comunicação** com os participantes; estrela e conversa fixada são **organização** do seu lado.

## Fixar uma mensagem

Para fixar, você precisa do `id` da mensagem. Ele vem de dois lugares: da resposta do envio (quando a mensagem é sua) ou do webhook (quando a mensagem chegou). O fluxo mais comum é enviar e fixar em seguida:

bash

Copiar

```
# 1. Envia as regras no grupo
curl -X POST "https://us.api-wa.me/SUA_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "text": "📌 Regras do grupo\n1. Só assuntos da turma\n2. Nada de propaganda\n3. Dúvidas no privado com a coordenação"
  }'

# 2. Fixa a mensagem usando o id retornado no envio
curl -X POST "https://us.api-wa.me/SUA_KEY/message/pin" \
  -H "Content-Type: application/json" \
  -d '{ "id": "ID_DA_MENSAGEM", "duration": 2592000 }'
```

A `duration` é em segundos e, se omitida, a mensagem fica fixada por **7 dias** (`604800`). Alguns valores úteis:

| Duração | Segundos |
| --- | --- |
| 24 horas | `86400` |
| 7 dias (padrão) | `604800` |
| 30 dias | `2592000` |

O WhatsApp trabalha com prazos próprios para mensagens fixadas; se você passar um valor fora do que o app aceita, confira na [documentação](https://api-wa.me/docs) como a API trata. Para uma regra permanente, o caminho mais seguro é refixar periodicamente, com um job simples.

Em Node, envio e fixação juntos:

javascript

Copiar

```
const BASE = 'https://us.api-wa.me/SUA_KEY';

async function post(path, body) {
  const r = await fetch(`${BASE}${path}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });
  return r.json();
}

async function publicarEFixar(grupo, texto, duracao = 604800) {
  const enviada = await post('/message/text', { to: grupo, text: texto });
  // A resposta do envio traz o id da mensagem no campo `id`.
  const { id } = enviada;
  await post('/message/pin', { id, duration: duracao });
  return id;
}
```

Guarde o `id` fixado no seu banco. Você vai precisar dele para desafixar depois.

## Desafixar e trocar o aviso

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/message/unpin" \
  -H "Content-Type: application/json" \
  -d '{ "id": "ID_DA_MENSAGEM" }'
```

O padrão "aviso do dia" junta tudo: todo dia de manhã, o sistema desafixa o aviso de ontem, publica o de hoje e fixa.

javascript

Copiar

```
async function trocarAvisoDoDia(grupo, textoDeHoje, idDeOntem) {
  if (idDeOntem) await post('/message/unpin', { id: idDeOntem });
  return publicarEFixar(grupo, textoDeHoje, 86400);
}
```

Funciona para cardápio do dia no grupo de clientes de um restaurante, escala do plantão no grupo da equipe, pauta da aula no grupo da turma. Com duração de 24 horas, mesmo que o job falhe um dia, o aviso velho não fica pendurado.

## Casos de uso em grupos

- **Regras do grupo.** O caso clássico. Fixe na criação do grupo e refixe quando mudar. Combina com o `!regras` do [bot de comandos para grupo](https://api-wa.me/blog/bot-comandos-grupo-whatsapp-api): quem pergunta recebe a resposta citando a mensagem fixada.
- **Link de convite ou de inscrição.** Em comunidades, o link da próxima turma fixado no grupo de avisos.
- **Evento da semana.** Envie o [convite de evento](https://api-wa.me/blog/convite-evento-whatsapp-api) e fixe até o dia.
- **Comunicado importante.** Mudança de horário, feriado, manutenção programada.

Um detalhe de permissão: em grupos configurados para que só administradores editem as informações (`setting=locked` no `PATCH /groups/{id}`), fixar mensagem exige que o número da instância seja admin. Se o pin não aparecer, é a primeira coisa a conferir. A gestão de configurações e admins está em [automatizar grupos pela API](https://api-wa.me/blog/automatizar-grupos-whatsapp-api).

## Casos de uso no atendimento 1:1

Em conversa individual, fixar mensagem é menos comum, mas tem usos bons:

- **Pedido em aberto.** Fixe o resumo do pedido na conversa com o cliente até a entrega. Ele não precisa rolar a conversa para lembrar o que pediu.
- **Dados de pagamento.** A chave Pix ou o link de pagamento fixados até a confirmação — o guia de cobrança está em [cobrança por Pix pela API](https://api-wa.me/blog/cobrar-pix-whatsapp-api).
- **Combinado de serviço.** Data da visita técnica fixada até o dia.

## Estrela e conversa fixada: organização do seu lado

Marcar com estrela é o "favoritos" do WhatsApp — só o seu número vê:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/message/ID_DA_MENSAGEM/keep"
```

Útil quando a equipe também usa o app no celular: o bot marca com estrela os comprovantes que chegaram, e quem abre o WhatsApp encontra tudo na lista de mensagens com estrela. Se você usa o celular e a API no mesmo número, esse tipo de sinal ajuda os dois lados a trabalharem juntos.

Fixar a **conversa** coloca o chat no topo da sua lista:

bash

Copiar

```
curl -X PATCH "https://us.api-wa.me/SUA_KEY/[email protected]&action=pin&value=true"
```

Com `value=false`, desafixa. Um uso prático: fixar automaticamente as conversas de clientes com problema em aberto, e desafixar quando o ticket fecha. O mesmo endpoint também marca conversa como lida ou não lida (`action=markRead`). Combinado com [labels para organizar conversas](https://api-wa.me/blog/labels-api-whatsapp-organizar-conversas-sem-crm), dá uma triagem visual sem CRM.

## Fixar mensagem coloca o número em risco?

Não. Fixar, desafixar e marcar com estrela são ações comuns de qualquer usuário. O que pesa no anti-spam do WhatsApp é para quem você manda e como: mensagens não solicitadas, fan-out para desconhecidos, texto idêntico em massa. Num grupo que você administra, com gente que entrou por escolha, fixar as regras é o oposto de spam — é organização. Nesse tipo de uso, a taxa de bloqueio é muito baixa para quem usa do jeito certo. Os fatores reais estão em [o que derruba um número](https://api-wa.me/blog/api-whatsapp-nao-oficial-bane-o-que-derruba-numero).

Só evite o exagero de automação: desafixar e refixar a cada poucos minutos, em dezenas de grupos, é um padrão que nenhum humano faz. Um aviso por dia é natural.

## Conclusão

Fixar é um recurso pequeno com efeito grande na organização: `POST /{key}/message/pin` coloca regras, avisos e pedidos no topo para todos, `message/unpin` troca o que está fixado, `message/{id}/keep` marca com estrela no seu número e `PATCH /chat?action=pin` deixa as conversas prioritárias à vista. Automatizando a troca, o aviso do dia se atualiza sozinho e o grupo para de repetir as mesmas perguntas. Os parâmetros completos estão na [documentação](https://api-wa.me/docs), e os outros recursos da camada não oficial estão em [API do WhatsApp não oficial: vantagens](https://api-wa.me/blog/api-whatsapp-nao-oficial-vantagens).

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

Como fixar uma mensagem no WhatsApp pela API?+

Faça POST /{key}/message/pin com o id da mensagem e, opcionalmente, duration em segundos. Sem duration, a mensagem fica fixada por 7 dias (604800 segundos). A mensagem aparece no topo da conversa ou do grupo para todos.

Como desafixar uma mensagem pela API?+

Use POST /{key}/message/unpin enviando o id da mensagem fixada. É útil para trocar o aviso do dia ou remover uma regra que mudou.

Qual a diferença entre fixar mensagem e fixar conversa?+

Fixar mensagem (POST /message/pin) coloca uma mensagem no topo de um chat ou grupo, visível para os participantes. Fixar conversa (PATCH /chat com action=pin) coloca o chat inteiro no topo da lista de conversas do próprio número, só para você.

Posso fixar mensagem em grupo pela API?+

Sim, desde que a instância tenha permissão no grupo. Em grupos configurados para só administradores editarem as informações, o número da instância precisa ser admin para fixar.

Para que serve marcar mensagem com estrela pela API?+

POST /{key}/message/{id}/keep marca a mensagem com estrela no próprio número, como um favorito. É útil para a equipe achar rápido comprovantes, combinados e endereços dentro do app.

## Continue lendo

[### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio

Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número

Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook

Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Fixar mensagem no WhatsApp pela API: regras do grupo, aviso do dia e conversa no topo",
  "description": "Como fixar e desafixar mensagens, marcar com estrela e fixar conversas no topo pela API não oficial do WhatsApp, com exemplos para grupos e atendimento.",
  "image": "https://api-wa.me/blog/fixar-mensagem-whatsapp-api/opengraph-image",
  "datePublished": "2026-09-28",
  "dateModified": "2026-09-28",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/fixar-mensagem-whatsapp-api"
  },
  "keywords": "api whatsapp não oficial, api não oficial whatsapp, fixar mensagem whatsapp api, fixar mensagem grupo whatsapp, pin message whatsapp api, fixar conversa whatsapp api, mensagem com estrela whatsapp api",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Fixar mensagem no WhatsApp pela API: regras do grupo, aviso do dia e conversa no topo",
      "item": "https://api-wa.me/blog/fixar-mensagem-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Como fixar uma mensagem no WhatsApp pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Faça POST /{key}/message/pin com o id da mensagem e, opcionalmente, duration em segundos. Sem duration, a mensagem fica fixada por 7 dias (604800 segundos). A mensagem aparece no topo da conversa ou do grupo para todos."
      }
    },
    {
      "@type": "Question",
      "name": "Como desafixar uma mensagem pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Use POST /{key}/message/unpin enviando o id da mensagem fixada. É útil para trocar o aviso do dia ou remover uma regra que mudou."
      }
    },
    {
      "@type": "Question",
      "name": "Qual a diferença entre fixar mensagem e fixar conversa?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Fixar mensagem (POST /message/pin) coloca uma mensagem no topo de um chat ou grupo, visível para os participantes. Fixar conversa (PATCH /chat com action=pin) coloca o chat inteiro no topo da lista de conversas do próprio número, só para você."
      }
    },
    {
      "@type": "Question",
      "name": "Posso fixar mensagem em grupo pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, desde que a instância tenha permissão no grupo. Em grupos configurados para só administradores editarem as informações, o número da instância precisa ser admin para fixar."
      }
    },
    {
      "@type": "Question",
      "name": "Para que serve marcar mensagem com estrela pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "POST /{key}/message/{id}/keep marca a mensagem com estrela no próprio número, como um favorito. É útil para a equipe achar rápido comprovantes, combinados e endereços dentro do app."
      }
    }
  ]
}
```