Skip to main content
POST
https://api.enviaai.app
/
v1
/
groups
/
{groupId}
/
participants
Gerenciar Participantes
curl --request POST \
  --url https://api.enviaai.app/v1/groups/{groupId}/participants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceId": "<string>",
  "action": "<string>",
  "participants": [
    {}
  ]
}
'
{
  "success": true,
  "data": {
    "action": "add",
    "results": [
      {
        "phone": "5511966666666",
        "status": "success"
      },
      {
        "phone": "5511955555555",
        "status": "failed",
        "error": "Not on WhatsApp"
      }
    ]
  }
}

Path Parameters

groupId
string
required
ID do grupo

Request Body

instanceId
string
required
ID da instância
action
string
required
Ação: add, remove, promote, demote
participants
array
required
Lista de números

Ações

AçãoDescriçãoRequer Admin
addAdicionar ao grupoSim
removeRemover do grupoSim
promotePromover a adminSim
demoteRemover adminSim

Exemplo

Adicionar Participantes

await client.groups.updateParticipants('[email protected]', {
  instanceId: 'inst_abc123',
  action: 'add',
  participants: ['5511966666666', '5511955555555']
});

Promover a Admin

await client.groups.updateParticipants('[email protected]', {
  instanceId: 'inst_abc123',
  action: 'promote',
  participants: ['5511988888888']
});

Remover Participante

await client.groups.updateParticipants('[email protected]', {
  instanceId: 'inst_abc123',
  action: 'remove',
  participants: ['5511977777777']
});
{
  "success": true,
  "data": {
    "action": "add",
    "results": [
      {
        "phone": "5511966666666",
        "status": "success"
      },
      {
        "phone": "5511955555555",
        "status": "failed",
        "error": "Not on WhatsApp"
      }
    ]
  }
}

Erros Comuns

CódigoDescrição
not_adminVocê não é admin do grupo
not_participantNúmero não está no grupo
already_participantJá é participante
not_on_whatsappNúmero não está no WhatsApp