---
title: "Mensagens temporárias no WhatsApp pela API"
description: "Como ativar mensagens temporárias no WhatsApp pela API não oficial, em conversa e em comunidade, quando faz sentido e os limites reais de privacidade."
url: "https://api-wa.me/blog/mensagens-temporarias-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)/Mensagens temporárias no WhatsApp pela API: quando ativar e o que elas não protegem

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

Compartilhar

# Mensagens temporárias no WhatsApp pela API: quando ativar e o que elas não protegem

Como ativar mensagens temporárias no WhatsApp pela API não oficial, em conversa e em comunidade, quando faz sentido e os limites reais de privacidade.

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

**Pela API não oficial do WhatsApp você ativa mensagens temporárias numa conversa com `POST /{key}/chat/disappearing`, informando o `jid` e o prazo em segundos (24 horas, 7 dias ou 90 dias; `0` desliga), e numa comunidade inteira com `POST /{key}/community/{id}/ephemeral`. É útil para conversas com dados sensíveis — códigos, documentos, laudos — mas tem limites claros: não impede print nem encaminhamento, e não apaga as cópias que o seu próprio sistema guardou.**

Mensagem temporária parece um recurso de privacidade pronto. É meio caminho. Este guia mostra como ativar por código, onde ela faz sentido e o que você precisa fazer do seu lado para que ela signifique alguma coisa.

> 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.

## Como funciona a mensagem temporária

Com a opção ligada numa conversa, cada mensagem nova enviada a partir daí some do app depois do prazo escolhido. Três pontos que costumam confundir:

- **Vale para mensagens novas.** O que já estava na conversa antes de ativar não é afetado.
- **Vale para os dois lados.** A configuração é da conversa, não de quem ativou. O cliente vê o aviso de que as mensagens temporárias foram ligadas.
- **Os prazos são fixos.** O WhatsApp trabalha com 24 horas, 7 dias e 90 dias.

| Prazo | `expiration` (segundos) |
| --- | --- |
| Desligado | `0` |
| 24 horas | `86400` |
| 7 dias | `604800` |
| 90 dias | `7776000` |

## Ativar numa conversa

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/chat/disappearing" \
  -H "Content-Type: application/json" \
  -d '{
    "jid": "[email protected]",
    "expiration": 86400
  }'
```

Para desligar, o mesmo endpoint com `"expiration": 0`.

Repare que aqui o campo é `jid`, com o sufixo completo (`@s.whatsapp.net` para contato). Se o contato chegou até você identificado por LID, use o JID `@lid` como ele veio — o guia sobre isso está em [LID no WhatsApp](https://api-wa.me/blog/lid-whatsapp-o-que-e-resolver-numero-api).

Um fluxo típico ativa antes do conteúdo sensível e desativa depois:

javascript

Copiar

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

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

async function enviarResultadoExame(telefone, urlPdf) {
  const jid = `${telefone}@s.whatsapp.net`;

  // 1. Liga as mensagens temporárias (7 dias) antes do documento
  await post('/chat/disappearing', { jid, expiration: 604800 });

  // 2. Avisa o paciente
  await post('/message/text', {
    to: telefone,
    text: 'Seu resultado está pronto. Por segurança, esta conversa ficará com mensagens temporárias por 7 dias — salve o PDF se precisar guardar.',
  });

  // 3. Envia o documento
  await post('/message/document', {
    to: telefone,
    url: urlPdf,
    mimetype: 'application/pdf',
    fileName: 'resultado-exame.pdf',
  });
}
```

O aviso do passo 2 não é detalhe. Se o paciente não souber que a mensagem vai sumir, ele volta daqui a dez dias procurando o exame e não encontra. Mensagem temporária sem aviso vira atendimento extra.

## Ativar numa comunidade inteira

Para comunidades — turmas, condomínios, grupos de clientes —, dá para ligar em todos os grupos de uma vez:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/community/ID_DA_COMUNIDADE/ephemeral" \
  -H "Content-Type: application/json" \
  -d '{ "expiration": 604800 }'
```

Em grupo e comunidade, o efeito prático é outro: além de privacidade, é **higiene**. Grupo de avisos com mensagens de 7 dias não acumula meses de conversa velha, e quem entra encontra só o que é atual. O que precisa ficar, você [fixa no topo](https://api-wa.me/blog/fixar-mensagem-whatsapp-api) ou publica de novo. A gestão de comunidades por API está em [criar e gerenciar comunidade pela API](https://api-wa.me/blog/tutorial-criar-comunidade-whatsapp-api).

## Quando faz sentido ativar

- **Códigos e credenciais** — código de acesso, senha provisória, token de retirada.
- **Documentos pessoais** — laudos, exames, contratos, comprovantes com CPF.
- **Dados financeiros** — boletos com dados do pagador, extratos, negociação de dívida.
- **Suporte técnico com acesso** — quando o cliente precisa mandar print de tela com informação sensível.
- **Grupos operacionais** — avisos do dia que perdem validade rápido.

E quando **não** faz sentido:

- **Pedido, orçamento e combinado comercial.** Você e o cliente querem o histórico. Some a mensagem, some a prova do que foi combinado.
- **Atendimento que depende de contexto.** O atendente de amanhã precisa ler o que foi dito hoje.
- **Qualquer coisa que o cliente vai procurar depois** sem ter sido avisado.

## O que a mensagem temporária não protege

Aqui está a parte que quase ninguém conta.

**1\. Não impede print, cópia nem encaminhamento.** A mensagem some do app depois do prazo; até lá, quem recebeu pode fazer o que quiser com ela. É higiene de dados, não sigilo.

**2\. Não apaga as cópias do seu sistema.** Esse é o ponto mais importante para quem integra por API. Quando a mensagem passa pela sua integração, ela pode ficar em vários lugares:

- no seu **banco de dados** de conversas;
- no **log** do servidor que recebe o webhook;
- no **CRM** ou na ferramenta de atendimento;
- no **armazenamento de mídia**, se você baixa anexos.

O WhatsApp apagar da conversa não apaga nada disso. Se o objetivo é minimizar dados, sua política de retenção precisa acompanhar o mesmo prazo. Ligar mensagem temporária no WhatsApp e guardar o laudo para sempre no seu banco é incoerente — e, num incidente, é exatamente o laudo guardado que vaza.

**3\. Não substitui base legal nem contrato.** A LGPD pede finalidade, necessidade e segurança. Mensagem temporária ajuda na necessidade (guardar só o que precisa, pelo tempo que precisa), mas não é, sozinha, conformidade. O que sua software house precisa garantir está em [API de WhatsApp e LGPD](https://api-wa.me/blog/whatsapp-api-lgpd-contrato-cliente).

## Coerência: alinhe a sua retenção

Uma checklist curta para quem ativa mensagens temporárias por API:

- Defina o prazo por **tipo de conteúdo**, não por conversa inteira quando não for necessário.
- **Não logue o corpo** de mensagens sensíveis; logue só metadados (id, horário, status).
- Configure **expiração** no seu armazenamento de mídia com o mesmo prazo.
- Se usa armazenamento próprio de mensagens, aplique a mesma política lá — o caminho de dados sob seu controle está em [MongoDB próprio para os dados da API](https://api-wa.me/blog/mongodb-proprio-whatsapp-api-dados).
- **Avise o cliente** antes do conteúdo, sempre.
- Revise o [checklist de segurança de token e webhook](https://api-wa.me/blog/seguranca-api-whatsapp-token-webhook): mensagem que some do app, mas trafega por webhook sem proteção, não está protegida.

## E o número, corre risco?

Não. Ligar e desligar mensagens temporárias é uma ação comum de usuário, feita todos os dias no app. O que coloca número em risco é comportamento de disparo — mensagens não solicitadas, volume desproporcional, texto idêntico para muitos desconhecidos. Numa conversa de atendimento que o cliente iniciou, com um documento que ele pediu, o risco é o mesmo de qualquer atendimento: muito baixo 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).

## Conclusão

Mensagem temporária é uma boa ferramenta de higiene: `POST /{key}/chat/disappearing` liga numa conversa, `POST /{key}/community/{id}/ephemeral` liga numa comunidade inteira, e o prazo vai de 24 horas a 90 dias. Use para códigos, documentos e dados sensíveis, avise o cliente antes e — o mais importante — alinhe a retenção do seu próprio sistema com o mesmo prazo. Sem isso, a mensagem some do WhatsApp e continua no seu banco. Os detalhes dos endpoints estão na [documentação](https://api-wa.me/docs), e o que mais a camada não oficial oferece está 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 ativar mensagens temporárias pela API do WhatsApp?+

Faça POST /{key}/chat/disappearing com o jid da conversa e expiration em segundos: 86400 para 24 horas, 604800 para 7 dias ou 7776000 para 90 dias. Para desativar, envie expiration 0.

Dá para ativar mensagens temporárias em uma comunidade inteira?+

Sim. POST /{key}/community/{id}/ephemeral com expiration em segundos liga ou desliga as mensagens temporárias em todos os grupos da comunidade de uma vez. Use 0 para desativar.

Mensagem temporária impede print ou encaminhamento?+

Não. Ela some do app depois do prazo, mas quem recebeu pode tirar print, copiar o texto ou encaminhar antes disso. É uma ferramenta de higiene de dados, não de sigilo absoluto.

Se eu ativar mensagens temporárias, meu sistema também apaga as mensagens?+

Não automaticamente. O WhatsApp apaga das conversas, mas cópias que o seu sistema guardou, como banco de dados, webhook, logs ou CRM, continuam existindo. Se a intenção é minimizar dados, sua retenção precisa acompanhar o mesmo prazo.

Mensagem temporária ajuda com a LGPD?+

Ajuda como parte de uma política de minimização de dados, especialmente para códigos, documentos e dados sensíveis. Mas não substitui base legal, política de retenção e contrato com o cliente. Ela é um reforço, não a solução inteira.

## 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": "Mensagens temporárias no WhatsApp pela API: quando ativar e o que elas não protegem",
  "description": "Como ativar mensagens temporárias no WhatsApp pela API não oficial, em conversa e em comunidade, quando faz sentido e os limites reais de privacidade.",
  "image": "https://api-wa.me/blog/mensagens-temporarias-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/mensagens-temporarias-whatsapp-api"
  },
  "keywords": "api whatsapp não oficial, api não oficial whatsapp, mensagens temporárias whatsapp api, ativar mensagens temporárias whatsapp, whatsapp disappearing messages api, mensagem que some whatsapp, privacidade whatsapp api lgpd",
  "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": "Mensagens temporárias no WhatsApp pela API: quando ativar e o que elas não protegem",
      "item": "https://api-wa.me/blog/mensagens-temporarias-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Como ativar mensagens temporárias pela API do WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Faça POST /{key}/chat/disappearing com o jid da conversa e expiration em segundos: 86400 para 24 horas, 604800 para 7 dias ou 7776000 para 90 dias. Para desativar, envie expiration 0."
      }
    },
    {
      "@type": "Question",
      "name": "Dá para ativar mensagens temporárias em uma comunidade inteira?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim. POST /{key}/community/{id}/ephemeral com expiration em segundos liga ou desliga as mensagens temporárias em todos os grupos da comunidade de uma vez. Use 0 para desativar."
      }
    },
    {
      "@type": "Question",
      "name": "Mensagem temporária impede print ou encaminhamento?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Não. Ela some do app depois do prazo, mas quem recebeu pode tirar print, copiar o texto ou encaminhar antes disso. É uma ferramenta de higiene de dados, não de sigilo absoluto."
      }
    },
    {
      "@type": "Question",
      "name": "Se eu ativar mensagens temporárias, meu sistema também apaga as mensagens?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Não automaticamente. O WhatsApp apaga das conversas, mas cópias que o seu sistema guardou, como banco de dados, webhook, logs ou CRM, continuam existindo. Se a intenção é minimizar dados, sua retenção precisa acompanhar o mesmo prazo."
      }
    },
    {
      "@type": "Question",
      "name": "Mensagem temporária ajuda com a LGPD?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Ajuda como parte de uma política de minimização de dados, especialmente para códigos, documentos e dados sensíveis. Mas não substitui base legal, política de retenção e contrato com o cliente. Ela é um reforço, não a solução inteira."
      }
    }
  ]
}
```
