Wazend

Grupos

Gestiona grupos de WhatsApp con Wazend: crear, listar, unirse, añadir o quitar participantes, administradores, seguridad, foto y más.

Gestiona los grupos de WhatsApp con la API.

  • {session} — nombre de la sesión que creaste con POST /api/session.
  • {groupId} — ID del grupo en formato 123123123123@g.us.

Información

Si ves @lid en la lista de participantes, consulta la página de Contactos.

Crear un nuevo grupo

POST /api/{session}/groups
Cuerpo
{
  "name": "Mi grupo",
  "participants": [
    { "id": "5215551234567@c.us" },
    { "id": "5219999999999@c.us" }
  ]
}

Obtener todos los grupos

GET /api/{session}/groups

La respuesta depende del motor (engine) que uses.

Parámetros de consulta:

GET /api/{session}/groups?limit=20&offset=0&sortBy=subject&sortOrder=desc
  • limit=10 — limita el número de grupos a devolver.

  • offset=0 — omite N grupos desde el inicio.

  • sortBy — ordena por campo:

    • sortBy=id — por ID del grupo.
    • sortBy=subject — por asunto del grupo.
  • sortOrder=desc|asc — orden:

    • desc — descendente (nuevos primero, A–Z).
    • asc — ascendente (antiguos primero, Z–A).
  • exclude=participants — excluye los datos de participantes de la respuesta.

Consejo

Si ves timeout o la petición tarda demasiado, usa limit para obtener los objetos en partes más pequeñas.

Advertencia

Si ves el error rate-overlimit con el motor NOWEB, intenta habilitar el NOWEB Store.

Obtener el número de grupos

GET /api/{session}/groups/count
Respuesta
{ "count": 10 }

Unirse a un grupo

Si tienes el enlace de invitación, únete mediante el código o la URL completa:

POST /api/{session}/groups/join
Cuerpo
{
  "code": "https://chat.whatsapp.com/INVITECODE"
}
Respuesta
{ "id": "5215551234567@g.us" }

Obtener info de invitación del grupo

GET /api/{session}/groups/join-info?code=invitecode

O usando el enlace completo (recuerda codificar la URL):

GET /api/{session}/groups/join-info?code=https%3A%2F%2Fchat.whatsapp.com%2Finvitecode

Refrescar grupos

POST /api/{session}/groups/refresh

Advertencia

No lo llames con frecuencia, puede provocar un error rate-overlimit. Normalmente la API de grupos ya tiene la información actualizada.

Obtener el grupo

GET /api/{session}/groups/{groupId}

Eliminar el grupo

DELETE /api/{session}/groups/{groupId}

Salir del grupo

POST /api/{session}/groups/{groupId}/leave

Foto del grupo

Recuerda codificar el símbolo @ del ID como %40 (ej. 5215551234567%40g.us).

Obtener foto

GET /api/{session}/groups/{ID}/picture?refresh=false
Respuesta
{ "url": "https://ejemplo.com/foto.jpg" }

url puede ser null si el grupo no tiene foto. Usa refresh=true para forzar el refresco (por defecto se cachea 24 horas; no refresques con frecuencia para evitar rate-overlimit).

Cambiar foto

PUT /api/{session}/groups/{ID}/picture
Cuerpo
{
  "file": {
    "url": "https://ejemplo.com/foto.jpg"
  }
}

O con datos en base64:

Cuerpo
{
  "file": {
    "data": "BASE64_DE_LA_IMAGEN"
  }
}

Eliminar foto

DELETE /api/{session}/groups/{ID}/picture

Cambiar el asunto del grupo

PUT /api/{session}/groups/{groupId}/subject
Cuerpo
{ "subject": "Nuevo asunto" }

Devuelve true si se actualizó correctamente. Puede devolver false si no tienes los permisos necesarios.

Cambiar la descripción del grupo

PUT /api/{session}/groups/{groupId}/description
Cuerpo
{ "description": "Nueva descripción" }

Devuelve true si se actualizó correctamente. Puede devolver false si no tienes los permisos necesarios.

Seguridad · editar info solo administradores

Permite que solo los administradores editen la información del grupo (título, descripción, foto).

GET /api/{session}/groups/{groupId}/settings/security/info-admin-only
PUT /api/{session}/groups/{groupId}/settings/security/info-admin-only
Cuerpo
{ "adminsOnly": true }

Devuelve true si se actualizó correctamente. Puede devolver false si no tienes los permisos necesarios.

Seguridad · mensajes solo administradores

Permite que solo los administradores envíen mensajes.

GET /api/{session}/groups/{groupId}/settings/security/messages-admin-only
PUT /api/{session}/groups/{groupId}/settings/security/messages-admin-only
Cuerpo
{ "adminsOnly": true }

Devuelve true si se actualizó correctamente. Puede devolver false si no tienes los permisos necesarios.

Seguridad · quién puede añadir miembros

Controla si todos los miembros o solo los administradores pueden añadir nuevos miembros.

GET /api/{session}/groups/{groupId}/settings/security/member-add-mode
PUT /api/{session}/groups/{groupId}/settings/security/member-add-mode
Cuerpo
{
  "membersCanAddNewMember": true
}

Devuelve true si se actualizó correctamente. Puede devolver false si no tienes los permisos necesarios.

Participantes

Obtener participantes

GET /api/{session}/groups/{groupId}/participants
Respuesta
[
  { "id": "5215551234567@c.us", "role": "participant" },
  { "id": "5219999999999@c.us", "role": "admin" }
]

También disponible con una respuesta casi idéntica entre motores:

GET /api/{session}/groups/{groupId}/participants/v2

Roles posibles: left, participant, admin, superadmin.

Añadir participantes

POST /api/{session}/groups/{groupId}/participants/add
Cuerpo
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Quitar participantes

POST /api/{session}/groups/{groupId}/participants/remove
Cuerpo
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Administradores

Promover a administrador

POST /api/{session}/groups/{groupId}/admin/promote
Cuerpo
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Degradar a usuario regular

POST /api/{session}/groups/{groupId}/admin/demote
Cuerpo
{
  "participants": [
    { "id": "5215551234567@c.us" }
  ]
}

Código de invitación

Obtener código

Con el código puedes formar el enlace https://chat.whatsapp.com/{inviteCode} para compartirlo con tus contactos.

GET /api/{session}/groups/{groupId}/invite-code

Revocar código

Invalida el código de invitación actual y genera uno nuevo.

POST /api/{session}/groups/{groupId}/invite-code/revoke

Eventos

Recibe eventos de grupos mediante Eventos: group.v2.join, group.v2.leave, group.v2.participants y group.v2.update. Consulta el detalle del payload en la página de Eventos.

En esta página