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.
Vaciar la cola de mensajes DELETE
Sirve para vaciar toda la cola de un número cuando hay que frenar envíos acumulados. Descarta los mensajes sin dejar registro. No se puede deshacer. Requiere Números de WhatsApp → Crear, conectar y borrar.
Crear un grupo POST
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.