Participantes

Gerencia participantes de um grupo: listar, entrar, sair e obter link de convite.

Listar participantes

POST /groups/participants

Parâmetros

Nome	Tipo	Obrigatório	Descrição
groupId	string	Sim	ID do grupo

Request

cURL

curl -X POST https://endpoint.wi.api.br/groups/participants \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{ "groupId": "120363012345678901@g.us" }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/groups/participants", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ groupId: "120363012345678901@g.us" }),
});

const data = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/groups/participants",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={"groupId": "120363012345678901@g.us"},
)

data = response.json()

Response

{
  "participants": [
    { "id": "5511999999999@s.whatsapp.net", "admin": true },
    { "id": "5511888888888@s.whatsapp.net", "admin": false },
    { "id": "5511777777777@s.whatsapp.net", "admin": false }
  ]
}

Entrar no grupo

POST /groups/join

Nome	Tipo	Obrigatório	Descrição
inviteCode	string	Sim	Código de convite (parte final do link)

Response

{ "groupId": "120363012345678901@g.us" }

Sair do grupo

POST /groups/leave

Nome	Tipo	Obrigatório	Descrição
groupId	string	Sim	ID do grupo

Link de convite

POST /groups/invitelink

Nome	Tipo	Obrigatório	Descrição
groupId	string	Sim	ID do grupo

Response

{ "inviteLink": "https://chat.whatsapp.com/ABC123xyz" }