Newsletters e Canais
Buscar updates de mensagens de um canal
/newsletter/updatesAutenticaçã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/messagesretorna o conteúdo dos posts/newsletter/updatesretorna 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/updatessob demanda
Casos de uso:
- atualizar contadores de
viewsde posts já carregados - atualizar
reactionCountsde 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 afteridfiltra updates depois de umserveridsincefiltra pelo momento do updatesinceaceita timestamp em segundos ou milissegundos- o retorno vem no campo
response
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | ID numérico do canal. Se informado sem domínio, será convertido para Exemplo: 120363123456789012 |
| jid | string | JID completo do canal. Exemplo: 120363123456789012@newsletter |
| count | integer | Quantidade máxima de updates retornados. Exemplo: 50 |
| afterid | integer | Retorna apenas updates posteriores ao Exemplo: 12345 |
| since | integer | Timestamp de corte.
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.