Referencia (endpoints)

Acciones de grupo

Crear un grupo, sumar y sacar participantes y administradores, cambiar su nombre, descripción, foto y ajustes, su link de invitación y las solicitudes para unirse, y ver cómo salió cada acción.

Crear un grupo, sumar y sacar participantes y administradores, cambiar su nombre, descripción, foto y ajustes, su link de invitación y las solicitudes para unirse, y ver cómo salió cada acción.

Crear un grupo

POST /api/v1/groups · Sirve para crear un grupo de WhatsApp desde uno de tus números, con su nombre, su descripción y hasta 20 participantes. Se hace después, al ritmo del número: con el action_id ves cómo salió y su link de invitación.

Sumar participantes a un grupo

POST /api/v1/groups/{group}/participants · Úsalo para sumar a un grupo hasta 20 personas por su teléfono. Con un número por QR entran directo; con uno oficial, cada una recibe una invitación. El resultado dice cómo salió cada una.

Sacar participantes de un grupo

POST /api/v1/groups/{group}/participants/remove · Sirve para sacar de un grupo hasta 20 personas por su teléfono, en una sola operación de WhatsApp. El resultado dice, persona por persona, si salió.

Hacer administradores

POST /api/v1/groups/{group}/admins · Úsalo para hacer administradores de un grupo a hasta 20 teléfonos; si alguno no estaba en el grupo, primero se suma. Solo con números conectados por QR.

Quitar administradores

POST /api/v1/groups/{group}/admins/remove · Sirve para quitarles el rol de administrador de un grupo a hasta 20 teléfonos. Solo con números conectados por QR.

Cambiar el nombre de un grupo

PUT /api/v1/groups/{group}/name · Úsalo para cambiarle el nombre a un grupo, de hasta 100 caracteres. Se manda a WhatsApp tal cual, sin la numeración de la campaña.

Cambiar la descripción de un grupo

PUT /api/v1/groups/{group}/description · Sirve para cambiar la descripción de un grupo, de hasta 2048 caracteres, o borrarla dejándola vacía (con un número oficial no se puede borrar).

Cambiar la foto de un grupo

PUT /api/v1/groups/{group}/photo · Úsalo para cambiar la foto de un grupo con la dirección https de una imagen jpg, jpeg o png. Solo con números conectados por QR.

Elegir quién escribe en un grupo

PUT /api/v1/groups/{group}/settings · Sirve para elegir si en un grupo escriben todos o solo los administradores; si escriben solo ellos, también son los únicos que editan los datos del grupo. Solo con números conectados por QR.

Ver el link de invitación de un grupo

GET /api/v1/groups/{group}/invite-link/live · Sirve para leer en el momento, desde WhatsApp, el link de invitación vigente de un grupo, por ejemplo para compartirlo o comprobar que no cambió.

Renovar el link de invitación de un grupo

POST /api/v1/groups/{group}/invite-link/renew · Úsalo para renovar el link de invitación de un grupo. Con un número oficial, el anterior deja de servir y WhatsApp genera uno nuevo; con uno por QR, vuelve a leer el vigente sin cambiarlo.

Ver las solicitudes para unirse

GET /api/v1/groups/{group}/join-requests · Úsalo para ver quién pidió unirse a un grupo de un número oficial que pide aprobación para entrar, antes de aprobar o rechazar. Trae hasta 100 solicitudes, leídas en el momento.

Aprobar solicitudes para unirse

POST /api/v1/groups/{group}/join-requests/approve · Sirve para aprobar, por el teléfono de cada persona, las solicitudes para unirse a un grupo de un número oficial, si caben en los lugares libres. El resultado dice cómo salió cada una.

Rechazar solicitudes para unirse

POST /api/v1/groups/{group}/join-requests/reject · Úsalo para rechazar, por el teléfono de cada persona, las solicitudes para unirse a un grupo de un número oficial. El resultado dice cómo salió cada una.

Ver cómo salió una acción de grupo

GET /api/v1/groups/actions/{action} · Sirve para saber cómo terminó lo que le pediste a un grupo, como mandarle un mensaje: si sigue en cola, se está haciendo, terminó o falló, y su resultado.

Ver las acciones sobre un grupo

GET /api/v1/groups/{group}/actions · Úsalo para ver el historial de acciones ejecutadas sobre un grupo puntual y su resultado, por ejemplo para entender por qué cambió su nombre o sus administradores.

Esto es lo que se copia para tu IA

Cargando…