---
title: "Postar status no WhatsApp pela API (automático)"
description: "Publique status de texto, imagem, vídeo e áudio no WhatsApp por código, escolha quem vê e agende stories sem incomodar ninguém. Exemplos em cURL e Node."
url: "https://api-wa.me/blog/postar-status-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)/Como postar status (stories) no WhatsApp automaticamente pela API

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

Compartilhar

# Como postar status (stories) no WhatsApp automaticamente pela API

Publique status de texto, imagem, vídeo e áudio no WhatsApp por código, escolha quem vê e agende stories sem incomodar ninguém. Exemplos em cURL e Node.

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

**Sim, dá para postar status no WhatsApp automaticamente: a API não oficial da WAME tem endpoints para publicar status de texto, imagem, vídeo e áudio por código, escolher quem vê cada publicação e até mencionar um contato.** Isso é algo que a API oficial da Meta não oferece — e que transforma o status em um canal de marketing agendável, sem mandar nenhuma mensagem para quem não pediu.

Neste guia você vê cada endpoint com exemplo, como agendar publicações e por que o status é, talvez, o canal mais "anti-spam" que existe dentro do WhatsApp.

## Por que o status é um canal diferente

Mensagem direta chega no celular da pessoa, vibra, aparece na tela. Status não: ele fica esperando. **Só vê quem abre**, e só abre quem tem interesse em você. Isso muda a lógica inteira:

- **Não interrompe ninguém.** Não há notificação push de status para o seu contato.
- **Não gera denúncia.** Ninguém denuncia um story que escolheu assistir.
- **Alcança sua base inteira** sem disparo: todo contato que salvou seu número pode ver.
- **Dura 24 horas**, o que combina com promoções do dia, cardápio, agenda e avisos rápidos.

Para lojas, restaurantes, clínicas e prestadores de serviço, o status costuma ser a "vitrine" que o cliente já tem o hábito de olhar. Automatizar a publicação tira da rotina alguém tendo que lembrar de postar todo dia.

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

## Status de texto

O mais simples: texto puro, com o fundo colorido que o app escolhe.

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/status/text" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hoje tem feijoada 🍲 — pedidos até 11h pelo WhatsApp!"
  }'
```

Sem o campo `statusJidList`, a publicação segue a sua configuração de privacidade de status — normalmente, todos os seus contatos.

## Status de imagem e vídeo

Imagem e vídeo recebem uma `url` pública e uma `caption` opcional:

bash

Copiar

```
# Imagem
curl -X POST "https://us.api-wa.me/SUA_KEY/status/image" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/cardapio-hoje.jpg",
    "caption": "Cardápio de hoje"
  }'

# Vídeo (mp4, de preferência até 30 segundos)
curl -X POST "https://us.api-wa.me/SUA_KEY/status/video" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/bastidores.mp4",
    "caption": "Bastidores da produção"
  }'
```

Duas dicas práticas: sirva a mídia de um endereço estável (CDN ou storage) e respeite o formato — vídeo em mp4 curto funciona melhor e carrega rápido no celular de quem assiste.

## Status de áudio

O status de áudio sai como mensagem de voz (PTT), aquela com a onda sonora:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/status/audio" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/recado-do-dia.ogg"
  }'
```

É um formato pouco usado por empresas — e justamente por isso chama atenção. Um recado curto do dono da loja soa muito mais próximo que um banner.

## Escolhendo quem vê: `statusJidList`

Todos os endpoints de status aceitam `statusJidList`, uma lista de contatos (no formato JID) que podem ver aquela publicação:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/status/image" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/oferta-vip.jpg",
    "caption": "Só para clientes VIP: 20% até meia-noite",
    "statusJidList": [
      "[email protected]",
      "[email protected]"
    ]
  }'
```

Isso abre segmentação real: status para clientes ativos, outro para quem comprou no último mês, outro para a equipe interna. O contato fora da lista simplesmente não vê. Se você organiza seus contatos com [labels](https://api-wa.me/blog/labels-api-whatsapp-organizar-conversas-sem-crm), dá para montar a lista a partir delas.

## Mencionando um contato no status

Publicou um status com a foto do pedido de um cliente, ou um agradecimento? Você pode mencioná-lo. O endpoint recebe o `jid` do contato e o `statusMsgId` da publicação:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/status/mention" \
  -H "Content-Type: application/json" \
  -d '{
    "jid": "[email protected]",
    "statusMsgId": "ID_DO_STATUS"
  }'
```

O contato recebe o aviso de que foi mencionado. Use com parcimônia: menção é notificação, e notificação sem contexto incomoda. Um cliente que aparece no status porque deu um depoimento e autorizou é o caso ideal.

## Agendando publicações

O WhatsApp não tem agendamento de status, mas a API resolve do seu lado. Um exemplo em Node.js com `node-cron`, publicando o cardápio de segunda a sexta às 10h:

javascript

Copiar

```
import cron from 'node-cron';

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

async function postarStatusImagem(url, caption) {
  const res = await fetch(`${BASE}/status/image`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ url, caption }),
  });
  if (!res.ok) throw new Error(`status falhou: ${res.status}`);
}

// Segunda a sexta, 10h (horário do servidor)
cron.schedule('0 10 * * 1-5', async () => {
  const hoje = new Date().toISOString().slice(0, 10);
  await postarStatusImagem(
    `https://seusite.com/cardapio/${hoje}.jpg`,
    'Cardápio de hoje — pedidos até 11h'
  );
});
```

A mesma ideia vale para uma fila (BullMQ, SQS) quando o conteúdo vem de um painel onde a equipe de marketing agenda as publicações da semana.

## Frequência: quanto é demais

Status é pouco intrusivo, mas o número continua sendo observado como qualquer outro. Algumas regras de bom senso:

- **Espalhe ao longo do dia.** Três ou quatro publicações em horários diferentes parecem uma pessoa; vinte em cinco minutos parecem um robô.
- **Evite repetir a mesma mídia** várias vezes no mesmo dia.
- **Não use status como gatilho de mensagem em massa.** Publicar e, logo depois, mandar DM para toda a base "viu meu status?" junta o pior dos dois mundos.
- **Combine com conversa real.** Número que publica status e também responde clientes tem um padrão de uso saudável.

A WAME ainda aplica, na própria infraestrutura, uma camada de proteção de comportamento — ritmo de envio, reconexão espaçada, identidade de dispositivo coerente com o país do número. É um dos motivos pelos quais a taxa de bloqueio é muito baixa para quem usa do jeito certo. Detalhamos isso em [anti-detecção na API não oficial](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial). Mas nenhuma camada técnica salva um uso abusivo: a WAME não apoia spam.

## Recebendo status de outros contatos

O caminho inverso também existe. Pelo `PATCH /{key}/instance` com `receiveStatusMessage=true`, a instância passa a receber no webhook os status publicados pelos seus contatos:

bash

Copiar

```
curl -X PATCH "https://us.api-wa.me/SUA_KEY/instance?receiveStatusMessage=true"
```

Útil para monitorar status de parceiros, fornecedores ou da sua própria equipe de vendas. Se você não precisa disso, deixe desligado — menos eventos, webhook mais limpo.

## Ideias de uso que funcionam

- **Restaurante:** cardápio do dia às 10h, prato especial às 17h.
- **Loja:** novidades do estoque com link de compra na legenda.
- **Clínica:** horários livres da semana para quem quer encaixe.
- **Infoprodutor:** bastidores e prova social, com status segmentado para alunos.
- **Imobiliária:** imóvel do dia com vídeo curto do tour.

Em todos os casos, o status complementa o atendimento: a pessoa vê, se interessa e **ela** manda mensagem. É o fluxo ideal — conversa iniciada pelo cliente.

## Conclusão

Postar status pela API é uma das vantagens mais subestimadas da API não oficial do WhatsApp: você ganha um canal de alcance amplo, agendável e segmentável, sem enviar uma única mensagem não solicitada. Com os endpoints `/status/text`, `/status/image`, `/status/video` e `/status/audio`, mais o `statusJidList` para escolher quem vê, dá para automatizar a vitrine do seu negócio em poucas linhas. Veja os demais recursos em [API não oficial do WhatsApp: recursos e exemplos](https://api-wa.me/blog/api-nao-oficial-whatsapp-recursos-exemplos) e todos os parâmetros na [documentação](https://api-wa.me/docs).

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

Dá para postar status no WhatsApp pela API?+

Sim, pela camada não oficial da WAME API. Há endpoints para status de texto (POST /{key}/status/text), imagem (/status/image), vídeo (/status/video) e áudio (/status/audio). A API oficial da Meta (Cloud API) não oferece publicação de status.

Quem vê o status publicado pela API?+

As mesmas pessoas que veriam se você postasse pelo celular: contatos que salvaram o seu número e que você não excluiu nas configurações de privacidade. Com o campo statusJidList você restringe a publicação a uma lista específica de contatos.

Posso agendar status no WhatsApp?+

O WhatsApp não tem agendamento nativo, mas pela API você resolve isso do seu lado: um cron ou fila chama o endpoint de status no horário desejado. O status publicado fica visível por 24 horas, como qualquer outro.

Postar muitos status por dia pode bloquear o número?+

Status é um canal pouco intrusivo, porque só vê quem quer. Ainda assim, dezenas de publicações seguidas em poucos minutos fogem do comportamento humano. Espalhe as publicações ao longo do dia e mantenha uma frequência que uma pessoa real teria.

Consigo mencionar um contato em um status pela API?+

Sim. O endpoint POST /{key}/status/mention recebe o jid do contato e o statusMsgId da publicação, e o contato é avisado de que foi mencionado naquele status.

## 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": "Como postar status (stories) no WhatsApp automaticamente pela API",
  "description": "Publique status de texto, imagem, vídeo e áudio no WhatsApp por código, escolha quem vê e agende stories sem incomodar ninguém. Exemplos em cURL e Node.",
  "image": "https://api-wa.me/blog/postar-status-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/postar-status-whatsapp-api"
  },
  "keywords": "api whatsapp não oficial, api não oficial whatsapp, postar status whatsapp api, status whatsapp automático, stories whatsapp api, agendar status whatsapp, api whatsapp status",
  "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": "Como postar status (stories) no WhatsApp automaticamente pela API",
      "item": "https://api-wa.me/blog/postar-status-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Dá para postar status no WhatsApp pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, pela camada não oficial da WAME API. Há endpoints para status de texto (POST /{key}/status/text), imagem (/status/image), vídeo (/status/video) e áudio (/status/audio). A API oficial da Meta (Cloud API) não oferece publicação de status."
      }
    },
    {
      "@type": "Question",
      "name": "Quem vê o status publicado pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "As mesmas pessoas que veriam se você postasse pelo celular: contatos que salvaram o seu número e que você não excluiu nas configurações de privacidade. Com o campo statusJidList você restringe a publicação a uma lista específica de contatos."
      }
    },
    {
      "@type": "Question",
      "name": "Posso agendar status no WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O WhatsApp não tem agendamento nativo, mas pela API você resolve isso do seu lado: um cron ou fila chama o endpoint de status no horário desejado. O status publicado fica visível por 24 horas, como qualquer outro."
      }
    },
    {
      "@type": "Question",
      "name": "Postar muitos status por dia pode bloquear o número?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Status é um canal pouco intrusivo, porque só vê quem quer. Ainda assim, dezenas de publicações seguidas em poucos minutos fogem do comportamento humano. Espalhe as publicações ao longo do dia e mantenha uma frequência que uma pessoa real teria."
      }
    },
    {
      "@type": "Question",
      "name": "Consigo mencionar um contato em um status pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim. O endpoint POST /{key}/status/mention recebe o jid do contato e o statusMsgId da publicação, e o contato é avisado de que foi mencionado naquele status."
      }
    }
  ]
}
```