Como postar status (stories) no WhatsApp automaticamente pela API

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.

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:

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

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:

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, 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:

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:

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

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 e todos os parâmetros na documentação.