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
Parâmetros
Seção intitulada “Parâmetros”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 -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"] }'{ "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 |