Adicionar participantes

Adiciona números a um grupo. A resposta traz o resultado por participante. Nem todo mundo entra direto: quem tem privacidade restrita só entra pelo link de convite.

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

Parâmetros

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

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

Cada item da resposta tem number, status e code:

`status`	Significado
`added`	Entrou no grupo (`code` 200; ou 409 = já era membro)
`invite_required`	Privacidade restrita (`code` 403) → envie o `inviteUrl` via mensagem
`failed`	Número sem WhatsApp ou outro erro

Requisição

curl -X POST "https://api.zapdev.com.br/v1/groups/1203...@g.us/participants" \
  -H "Authorization: Bearer zd_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5511999999999", "5511888888888"] }'

{
  "data": {
    "groupId": "1203...@g.us",
    "results": [
      { "number": "5511999999999", "status": "added", "code": "200" },
      { "number": "5511888888888", "status": "invite_required", "code": "403" }
    ],
    "summary": { "added": 1, "inviteRequired": 1, "failed": 0 }
  }
}

Erros

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