NODAPI

Grupos e Comunidades

Gerenciar participantes do grupo

POST/group/updateParticipants

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

Gerencia participantes do grupo através de diferentes ações:

  • Adicionar ou remover participantes
  • Promover ou rebaixar administradores
  • Aprovar ou rejeitar solicitações pendentes

Requer que o usuário seja administrador do grupo para executar as ações.

Corpo da requisição (JSON)

CampoTipoDescrição
groupjid*string

JID (identificador) do grupo

Exemplo: [email protected]

action*string

Ação a ser executada:

  • add: Adicionar participantes ao grupo
  • remove: Remover participantes do grupo
  • promote: Promover participantes a administradores
  • demote: Remover privilégios de administrador
  • approve: Aprovar solicitações pendentes de entrada
  • reject: Rejeitar solicitações pendentes de entrada

Exemplo: promote

participants*array<string>

Lista de números de telefone ou JIDs dos participantes. Para números de telefone, use formato internacional sem '+' ou espaços.

Exemplo: 5521987654321,5511999887766

* obrigatório

Respostas

  • 200Sucesso na operação
  • 400Erro nos parâmetros da requisição
  • 403Usuário não é administrador do grupo
  • 500Erro interno do servidor

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.