Pular para o conteúdo

Remover participantes

Remove números de um grupo. Mesmo envelope de resposta do endpoint de adicionar: resultado por participante + resumo. Exige que o número seja admin.

DELETEhttps://api.zapdev.com.br/v1/groups/:groupId/participants

O :groupId aceita o JID completo (...@g.us) ou só a parte numérica. Até 50 participantes por chamada.

Campo Tipo Descrição
participants (obrig.) string[] 1–50 números em E.164 (só dígitos)

Cada item traz number, status e code. Uma remoção bem-sucedida vem com code 200.

Requisição

cURL
curl -X DELETE "https://api.zapdev.com.br/v1/groups/1203...@g.us/participants" \
-H "Authorization: Bearer zd_live_..." \
-H "Content-Type: application/json" \
-d '{ "participants": ["5511999999999"] }'
200 OK
{
"data": {
"groupId": "1203...@g.us",
"results": [
{ "number": "5511999999999", "status": "added", "code": "200" }
],
"summary": { "added": 1, "inviteRequired": 0, "failed": 0 }
}
}
HTTP error.code Quando
422 instance_not_connected instância sem WhatsApp conectado
404 group_not_found grupo inexistente ou o número não é admin