NODAPI

Newsletters e Canais

Buscar mensagens de um canal

POST/newsletter/messages

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Busca diretamente no WhatsApp os posts/mensagens de um canal (newsletter).

Esta rota não depende de mensagens salvas localmente e é útil para:

  • carregar o histórico recente de posts de um canal
  • paginar mensagens anteriores usando beforeid
  • consumir conteúdo de newsletters sem persistência em banco

Identificação do canal:

  • envie id com o identificador numérico do canal; o backend converte para @newsletter
  • ou envie jid completo no formato 1234567890@newsletter

Observações:

  • count controla quantos posts retornar
  • use preferencialmente beforeid
  • beforeid pagina para trás a partir de um serverid
  • o retorno vem no campo response

Corpo da requisição (JSON)

CampoTipoDescrição
idstring

ID numérico do canal. Se informado sem domínio, será convertido para @newsletter.

Exemplo: 120363123456789012

jidstring

JID completo do canal.

Exemplo: 120363123456789012@newsletter

countinteger

Quantidade de mensagens/posts a buscar.

Exemplo: 20

beforeidinteger

Retorna mensagens anteriores ao serverid informado. Use para paginação retroativa.

Exemplo: 12345

* obrigatório

Exemplos de corpo

Buscar últimos posts do canal

{
  "id": "120363123456789012",
  "count": 20
}

Buscar posts anteriores a um server id

{
  "jid": "120363123456789012@newsletter",
  "count": 20,
  "beforeid": 12345
}

Respostas

  • 200Mensagens do canal recuperadas com sucesso
  • 400Payload inválido ou ID/JID do canal inválido
  • 401Instância não autenticada ou cliente não encontrado
  • 500Erro interno ao consultar mensagens do canal no WhatsApp

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.