Consultar grupos e participantes

  • POST /v2/api/external/{ApiID}/group/list recebe whatsappId.
  • POST .../group/showById recebe whatsappId e groupId.
  • POST .../group/listParticipants recebe whatsappId e groupIds[].
  • POST .../listGroupInfo recebe listGroups e listParticipants como booleanos.
  • Todas as consultas dessa família usam POST, inclusive as listagens.
Tela de gestão de grupos com dados e ações do grupo
Compare o groupId retornado pela API com o grupo de homologação antes de qualquer mudança.

Criar e alterar dados do grupo

  • POST .../group/create recebe whatsappId, titles[] e number.
  • POST .../group/changeTitle recebe whatsappId, groupIds[] e title.
  • POST .../group/changeDescription recebe whatsappId, groupIds[] e description.
  • POST .../group/changePicture recebe whatsappId, groupIds[] e picture.
  • POST .../group/getInviteLink recebe whatsappId e groupId.
  • POST .../group/setAdminsOnly recebe whatsappId, groupIds[] e adminsOnly.

Adicionar, remover e mudar administradores

  • POST .../group/addParticipant adiciona participantes.
  • POST .../group/removeParticipant remove participantes.
  • POST .../group/promote promove participantes a administradores.
  • POST .../group/demote remove a função de administrador.
  • As quatro rotas publicam whatsappId, groupIds[] e participants[].
  1. 1

    Confirme que o número conectado é administrador do grupo de teste.

  2. 2

    Selecione um único groupId na primeira validação.

  3. 3

    Adicione somente um participante autorizado e consulte novamente.

  4. 4

    Antes de rebaixar ou remover alguém, confirme que existe outro administrador responsável.

  5. 5

    Só use vários groupIds depois de validar o comportamento unitário.

Reconhecer o que não está disponível nessa API

  • Não há paginação, campos obrigatórios nem schema de resposta detalhado nas rotas auditadas.
  • Não há contrato de resultado parcial quando uma operação recebe vários groupIds.
  • Não há rotas publicadas para excluir ou sair de grupo, revogar convite, Ban List, Word List, saudação ou despedida.

Resolver alterações recusadas ou parciais

  • Grupo ausente: confira canal ativo, participação do número conectado e whatsappId.
  • Grupo incorreto: interrompa a integração e compare groupId com a listagem atual.
  • Mudança negada: confirme se o número conectado é administrador.
  • Participante recusado: valide o formato e a permissão no grupo de teste.
  • Resultado parcial: consulte individualmente todos os grupos antes de repetir a operação.
  • Timeout: reconcilie título, descrição ou participantes antes de nova chamada.