NODInfra

Newsletters e Canais

Buscar updates de mensagens de um canal

POSThttps://api.nodinfra.com.br/newsletter/updates
URL completa: https://api.nodinfra.com.br/newsletter/updates

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

idstringopcional

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

exemplo: 120363123456789012

jidstringopcional

JID completo do canal.

exemplo: 120363123456789012@newsletter

countintegeropcional

Quantidade máxima de updates retornados.

exemplo: 50

afteridintegeropcional

Retorna apenas updates posteriores ao `serverid` informado.

exemplo: 12345

sinceintegeropcional

Timestamp de corte. - Se maior que `1000000000000`, é interpretado como milissegundos. - Caso contrário, é interpretado como segundos.

exemplo: 1710000000

Exemplo

Buscar updates depois de um post conhecido
{
  "id": "120363123456789012",
  "count": 50,
  "afterid": 12345
}

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

Testar endpoint

POSThttps://api.nodinfra.com.br/newsletter/updates
cURL
curl -X POST 'https://api.nodinfra.com.br/newsletter/updates' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "120363123456789012",
  "count": 50,
  "afterid": 12345
}'