Newsletters

Gerencia canais (newsletters) do WhatsApp: listar inscrições, criar, seguir, enviar mensagens e reagir.

Listar inscrições

Retorna os canais que a sessão segue.

GET /newsletter/subscribed

Request

cURL

curl https://endpoint.wi.api.br/newsletter/subscribed \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01"

JavaScript

const response = await fetch("https://endpoint.wi.api.br/newsletter/subscribed", {
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
  },
});

const data = await response.json();

Python

import requests

response = requests.get(
    "https://endpoint.wi.api.br/newsletter/subscribed",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
)

data = response.json()

Response

{
  "success": true,
  "newsletters": [...]
}

Criar canal

POST /newsletter/create

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do canal
description	string	Não	Descrição do canal

Seguir canal

POST /newsletter/follow

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal (@newsletter)

Deixar de seguir

POST /newsletter/unfollow

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal

Silenciar canal

POST /newsletter/mute

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal
mute	boolean	Sim	true para silenciar, false para reativar

Enviar mensagem no canal

Envia texto em um canal que você administra.

POST /newsletter/send

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal
text	string	Sim	Texto da mensagem

Response

{
  "success": true,
  "messageId": "ABCDEF123456..."
}

Reagir a mensagem do canal

POST /newsletter/reaction

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal
server_id	number	Sim	ID da mensagem no canal
reaction	string	Sim	Emoji da reação

Buscar mensagens

POST /newsletter/messages

Nome	Tipo	Obrigatório	Descrição
jid	string	Sim	JID do canal
count	number	Não	Quantidade de mensagens (padrão: 20)