> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Grupos

> Notifique a clases y equipos en WhatsApp a través de la conexión no oficial: enumere, envíe, invite y administre participantes.

<Tip>
  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).
</Tip>

## 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`).

<Warning>
  **Línea oficial:** grupos, participantes e invitaciones **no están disponibles**. Utilice una [conexión no oficial](/es/whatsapp-api/como-funciona/modos-de-conexao) o 1 a 1 en la línea oficial.
</Warning>

***

## Cuándo usar

| Situación                                                    | ¿Usar grupos vía API?                                                  |
| ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| Alertas a **varias clases/equipos** (no oficial)             | **Sí**                                                                 |
| Automatizar **invitaciones** y **participantes** vía ERP/CRM | **Sí**                                                                 |
| Instancia **oficial** (Meta)                                 | **No**, use 1 a 1 o cambie a no oficial                                |
| Solo soporte **1 a 1**                                       | No. Use [WhatsApp estándar](/es/whatsapp-api/como-funciona/introducao) |

Comparativa completa: [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao).

***

## Qué puedes hacer

<CardGroup cols={2}>
  <Card title="Enviar a un grupo" icon="paper-plane">
    `POST /v1/whatsapp/messages` con JID del grupo en `to` (`120363...@g.us`).
  </Card>

  <Card title="Listar grupos" icon="list">
    `GET /v1/whatsapp/instances/{id}/groups` con paginación.
  </Card>

  <Card title="Participantes" icon="users">
    Listar, agregar y quitar personas en grupos permitidos.
  </Card>

  <Card title="Invitaciones" icon="link">
    Enviar enlace de invitación en DM, revocar u obtener código de invitación.
  </Card>
</CardGroup>

Rutas y campos: **Referencia API** de WhatsApp (sección Grupos).

***

## Antes de empezar

| Ítem                                          | Requerido   |
| --------------------------------------------- | ----------- |
| Instancia **no oficial** **ACTIVE**           | Sí          |
| Ámbito **`whatsapp:groups`** en la clave      | Sí          |
| El número es **admin** en los grupos objetivo | Recomendado |

¿Aún no está emparejado? [Inicio rápido de WhatsApp](/es/whatsapp-api/como-funciona/quick-start) (pestaña **no oficial**). Ámbitos: [Ámbitos de clave API](/es/whatsapp-api/como-funciona/escopos-api-key).

Reemplace `sk_live_xxxxx` con su clave y `{instanceId}` con el ID de la instancia. URL base: `https://api.notifique.dev`.

<Info>
  La Clave API pertenece a **un** espacio de trabajo. En v1 **no envíe** `x-workspace-id`.
</Info>

***

## 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**

<Note>
  Su número debe ser **administrador del grupo** en WhatsApp. De lo contrario, la operación falla.
</Note>

***

## 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

| `code`                            | Qué hacer                                |
| --------------------------------- | ---------------------------------------- |
| `SCOPE_GROUPS_REQUIRED`           | Agregue **`whatsapp:groups`** a la clave |
| `WHATSAPP_GROUPS_UNOFFICIAL_ONLY` | Use una instancia **no oficial**         |
| `loading: true` en la lista       | Espere y llame de nuevo                  |

Catálogo completo: [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

<AccordionGroup>
  <Accordion title="403: función desactivada o ámbito faltante">
    Verifique que la instancia sea **no oficial** y que la clave tenga **`whatsapp:groups`**.
  </Accordion>

  <Accordion title="Fallo al agregar/quitar participante">
    Verifique que el número de la instancia sea **admin** del grupo en la app WhatsApp.
  </Accordion>
</AccordionGroup>

***

## Próximos pasos

* [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao): oficial × no oficial
* [WhatsApp, Introducción](/es/whatsapp-api/como-funciona/introducao): instancia, mensajes, webhooks
* [Ámbitos de clave API](/es/whatsapp-api/como-funciona/escopos-api-key)