Skip to main content
Los grupos de WhatsApp son lugares donde clases, equipos y comunidades conversan juntos. Con Notifique, envía alertas a todo el grupo, administra participantes y comparte enlaces de invitación, solo conexión no oficial (número emparejado mediante QR o enlace para compartir).

​
En breve

  • Solo conexión no oficial: las instancias oficiales (Meta) no pueden enviar ni administrar grupos vía API.
  • Utilice la misma instancia que ya vinculó para envíos 1 a 1.
  • Clave API con ámbito whatsapp:groups en integraciones que lo requieran.
  • Envío grupal = misma ruta de mensaje; solo cambia to (...@g.us).
Línea oficial: grupos, participantes e invitaciones no están disponibles. Utilice una conexión no oficial o 1 a 1 en la línea oficial.

​
Cuándo usar

Comparativa completa: Modos de conexión.

​
Qué puedes hacer

Enviar a un grupo

POST /v1/whatsapp/messages con JID del grupo en to (120363...@g.us).

Listar grupos

GET /v1/whatsapp/instances/{id}/groups con paginación.

Participantes

Listar, agregar y quitar personas en grupos permitidos.

Invitaciones

Enviar enlace de invitación en DM, revocar u obtener código de invitación.
Rutas y campos: Referencia API de WhatsApp (sección Grupos).

​
Antes de empezar

¿Aún no está emparejado? Inicio rápido de WhatsApp (pestaña no oficial). Ámbitos: Ámbitos de clave API. Reemplace sk_live_xxxxx con su clave y {instanceId} con el ID de la instancia. URL base: https://api.notifique.dev.
La Clave API pertenece a un espacio de trabajo. En v1 no envíe x-workspace-id.

​
1. Listar grupos

Devuelve una lista paginada de grupos para la instancia. Parámetros opcionales: page (predeterminado 1), limit (predeterminado 20, máx. 100). Con grupos cargados Aún sincronizando Guarde el id (ej. 120363295648424210@g.us) para los siguientes pasos.

​
Participantes del grupo

En la URL, codifique @ como %40 si su cliente lo requiere.

​
2. Enviar un mensaje a un grupo

Misma ruta que envíos individuales de WhatsApp. Ponga el JID del grupo en to. Respuesta (202) Varios grupos a la vez

​
3. Agregar o quitar participantes

Agregar Quitar Respuesta (200), ejemplo
Su número debe ser administrador del grupo en WhatsApp. De lo contrario, la operación falla.

​
4. Enviar invitación en DM

Envía el enlace de invitación a uno o más números individuales.

​
5. Revocar o recuperar el enlace de invitación

Revocar enlace actual Obtener enlace o código actual

​
Límites importantes

  • Solo no oficial: las instancias oficiales devuelven WHATSAPP_GROUPS_UNOFFICIAL_ONLY.
  • No crea un grupo nuevo vía API (use un grupo existente o créelo primero por teléfono).
  • Agregar personas requiere permiso de admin en WhatsApp.
  • La lista puede devolver loading: true en la primera búsqueda; vuelva a intentarlo después de unos segundos.
  • Las reglas propias de WhatsApp aún se aplican; la API no reemplaza los permisos de la aplicación.

​
Errores comunes

Catálogo completo: Respuestas de error.
Verifique que la instancia sea no oficial y que la clave tenga whatsapp:groups.
Verifique que el número de la instancia sea admin del grupo en la app WhatsApp.

​
Próximos pasos