NODAPI

Newsletters e Canais

Buscar updates de mensagens de um canal

POST/newsletter/updates

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

Consulta diretamente no WhatsApp os updates de posts já existentes de um canal.

Esta rota é diferente de /newsletter/messages:

  • /newsletter/messages retorna o conteúdo dos posts
  • /newsletter/updates retorna mudanças posteriores nos posts, especialmente métricas

Esta rota também não é um evento de webhook:

  • não existe webhook newsletter_messages_update
  • para views e reactions de canais, consulte /newsletter/updates sob demanda

Casos de uso:

  • atualizar contadores de views de posts já carregados
  • atualizar reactionCounts de posts do canal
  • consultar sob demanda os mesmos tipos de métricas que chegam nos live updates internos do WhatsApp

Observações:

  • use preferencialmente afterid
  • afterid filtra updates depois de um serverid
  • since filtra pelo momento do update
  • since aceita timestamp em segundos ou milissegundos
  • 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 máxima de updates retornados.

Exemplo: 50

afteridinteger

Retorna apenas updates posteriores ao serverid informado.

Exemplo: 12345

sinceinteger

Timestamp de corte.

  • Se maior que 1000000000000, é interpretado como milissegundos.
  • Caso contrário, é interpretado como segundos.

Exemplo: 1710000000

* obrigatório

Exemplos de corpo

Buscar updates depois de um post conhecido

{
  "id": "120363123456789012",
  "count": 50,
  "afterid": 12345
}

Buscar updates a partir de um timestamp

{
  "jid": "120363123456789012@newsletter",
  "count": 50,
  "since": 1710000000
}

Respostas

  • 200Updates de mensagens do canal recuperados 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 updates 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.