> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/es/api-documentation/chats-grupales-en-waba-group-messaging-api-beta.md).

# Chats grupales en WABA — Group Messaging API (⚡️Beta)

La API de mensajería grupal se encuentra en prueba beta.

**Group Messaging API** es una función beta de WhatsApp Business API que permite crear chats grupales e intercambiar mensajes con varios participantes mediante la API.

La función amplía las conversaciones 1:1 estándar de WhatsApp y está pensada para escenarios limitados de interacción grupal.

{% hint style="warning" %}

### Requisitos de acceso <a href="#requisitos-de-acceso" id="requisitos-de-acceso"></a>

Para usar Group Messaging API deben cumplirse las siguientes condiciones:

* La cuenta de WhatsApp Business tiene el estado [**Official Business Account (OBA)**.](https://help.1msg.io/docs/es/whatsapp/obtaining-the-green-checkmark-badge)
* Límite de mensajes iniciados por el negocio: **al menos 100.000 mensajes cada 24 horas.** Puedes comprobar tu límite con el método [/status](https://docs.1msg.io/#tag/Channel/operation/getStatus).
  {% endhint %}

### Creación y unión a grupos <a href="#creaci-c3-b3n-y-uni-c3-b3n-a-grupos" id="creaci-c3-b3n-y-uni-c3-b3n-a-grupos"></a>

{% stepper %}
{% step %}

#### Crear un grupo <a href="#paso-1-crear-un-grupo" id="paso-1-crear-un-grupo"></a>

El grupo se crea mediante la API de 1MSG.\
Al crearlo, se genera un **enlace de invitación único**.
{% endstep %}

{% step %}

#### Unirse a un grupo <a href="#paso-2-unirse-a-un-grupo" id="paso-2-unirse-a-un-grupo"></a>

**Solo es posible unirse a un grupo mediante el enlace de invitación.**

Envías el enlace de invitación a los números de teléfono necesarios; el usuario decide si unirse al grupo.

Actualmente se aceptan hasta 8 participantes por grupo.
{% endstep %}

{% step %}

#### Intercambio de mensajes en el grupo <a href="#paso-3-intercambio-de-mensajes-en-el-grupo" id="paso-3-intercambio-de-mensajes-en-el-grupo"></a>

El envío de mensajes al grupo se realiza mediante el endpoint estándar, igual que en los chats 1:1. La única diferencia es que el chatID cambia de longitud y termina en `@g.us`.
{% endstep %}

{% step %}

#### Recepción de mensajes y estados <a href="#paso-4-recepci-c3-b3n-de-mensajes-y-estados" id="paso-4-recepci-c3-b3n-de-mensajes-y-estados"></a>

Los mensajes entrantes de los grupos se entregan al webhook estándar.
{% endstep %}
{% endstepper %}

### Limitaciones de la versión beta <a href="#limitaciones-de-la-versi-c3-b3n-beta" id="limitaciones-de-la-versi-c3-b3n-beta"></a>

#### Limitaciones de grupos <a href="#limitaciones-de-grupos" id="limitaciones-de-grupos"></a>

* Participantes máximos por grupo: **hasta 8**
* Grupos máximos por número de teléfono: **hasta 10.000**
* Tipos de mensaje admitidos:
  * Mensajes de texto
  * Mensajes multimedia
  * Mensajes de plantilla (plantillas de texto / multimedia)

### Soporte <a href="#soporte" id="soporte"></a>

Group Messaging API está en **beta**. **No se recomienda la función para procesos críticos del negocio.**

Si encuentras errores o comportamiento inestable con Group Messaging API — **contacta con soporte**.

### Métodos de la API Groups (1msg.io) <a href="#m-c3-a9todos-de-la-api-groups-1msgio" id="m-c3-a9todos-de-la-api-groups-1msgio"></a>

La sección **Groups** contiene métodos para gestionar chats grupales. Todos los métodos funcionan vía API y permiten crear, actualizar, ver y eliminar grupos, así como gestionar participantes y enlaces de invitación.

Documentación:

{% embed url="<https://docs.1msg.io/#tag/Groups>" %}

Resumen de métodos:

* **Create a Group:** Crea un nuevo grupo. Devuelve el ID del grupo creado y otros metadatos.
* **Get Groups List:** Devuelve la lista de todos los grupos creados en el canal actual.
* **Get Group Info:** Obtiene información detallada de un grupo concreto por su ID.
* **Update Group:** Actualiza los parámetros de un grupo existente (p. ej. nombre, descripción).
* **Delete Group:** Elimina un grupo.
* **Get Invite Link:** Devuelve el enlace de invitación actual del grupo (para invitar participantes).
* **Reset Invite Link:** Genera un nuevo enlace de invitación para el grupo, reemplazando el anterior. Útil para invalidar invitaciones previas.
* **Remove Participants:** Elimina uno o más participantes del grupo.