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

# Envío de grupos (múltiples números)

> Difunde envíos a varios números de WhatsApp sin sobrecargar una sola línea.

<Tip>
  Un grupo de envío es como **varias líneas de pago**: en lugar de pasar todo a través de un número, el sistema **divide** los mensajes entre los números del grupo, automáticamente.
</Tip>

## En breve

* Agrupa varios números **activos** y elige cuál envía cada mensaje.
* **Opcional**, sin piscina, sigue usando `instanceId` como lo haces hoy.
* Cada grupo es **oficial** o **no oficial**; no puedes mezclar ambos.
* Útil para campañas grandes y cuando desea protección si falla un número.

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

***

## Cuándo usar

| Situation                                   | Use a pool?                     |
| ------------------------------------------- | ------------------------------- |
| **Large** campaigns (thousands of messages) | **Yes**                         |
| Want **protection** if a number fails       | **Yes**                         |
| **Low volume** on a single number           | Not needed                      |
| Need the **same sender** every time         | Use `instanceId` (pool ignored) |

<Info>
  Sin ningún grupo configurado, el flujo `instanceId` actual permanece igual.
</Info>

***

## Un tipo por grupo

Esta es la regla principal:

| Pool type      | Allowed instances              |
| -------------- | ------------------------------ |
| **Official**   | **Official** connection only   |
| **Unofficial** | **Unofficial** connection only |

El tipo de grupo lo establece el **primer número** que agrega (o al crearlo en el panel). Cada instancia nueva en ese grupo debe ser del **mismo tipo**.

* ¿Necesita ambos modos? Crea **dos grupos** (uno oficial y otro no oficial).
* Intenta mezclar al agregar → `SENDING_POOL_KIND_MISMATCH`
* Enviar a través de un grupo inconsistente → `SENDING_POOL_KIND_MIXED`

Códigos completos: [Respuestas de error](/es/guides/conceitos/resposta-de-erros#sending-pools-whatsapp).

<Warning>
  Las plantillas, las reglas de envío y el riesgo difieren entre oficiales y no oficiales. Es por eso que un grupo **nunca** cruza modos.
</Warning>

***

## Cómo funciona en la práctica

1. **Cree el grupo** en el panel y agregue números **activos** del mismo tipo
2. Elija **cómo distribuir** (por turnos, peso o menos uso hoy)
3. Enviar **sin** `instanceId`, el grupo predeterminado o `sendingPoolId` elige el número por destinatario
4. Si un número falla con demasiada frecuencia, el **disyuntor** detiene solo ese número; los demás siguen adelante

Con un **`instanceId`** explícito, el mensaje va desde ese número y el grupo **no** se aplica a ese envío.

***

## Modos de distribución

| Mode            | How it works                                        | Good for                              |
| --------------- | --------------------------------------------------- | ------------------------------------- |
| **Round robin** | Number 1 sends N messages, then number 2, and so on | Similar capacity across lines         |
| **Weighted**    | Weight 3 sends \~3× more than weight 1              | One stronger or more mature number    |
| **Least used**  | Always the line that **sent the least today**       | Numbers that start at different times |

***

## Configuración principal

| Setting                 | What it does                      | Default       |
| ----------------------- | --------------------------------- | ------------- |
| Switch every N messages | Batch per number before switching | 50            |
| Cooldown                | Pause between batches             | None          |
| Health monitoring       | Pause a number with many failures | On            |
| Failure threshold       | Error % to pause in the pool      | 30%           |
| Default pool            | Used when you omit `instanceId`   | Per dashboard |

**Por número:** peso, límite diario, tiempo de reutilización propio y pausa manual.

Si más del **30%** de los mensajes de un número fallan en **10 minutos**, se pausa **solo en ese grupo** (no desconecta WhatsApp). Cuando se estabiliza, se reanuda por sí solo.

***

## A través de API

### Grupo predeterminado (sin número elegido)

### Grupo específico

### Fixed number (ignores pool)

<Note>
  No envíe **`instanceId` y `sendingPoolId` juntos**, la API devuelve **400**.
</Note>

***

## Mejores prácticas

<Tip>
  **Preparar nuevas cifras** antes de campañas intensas: entre 200 y 500 mensajes al día por línea al principio. Límites diarios en la ayuda del panel.
</Tip>

* Habilite **enfriamiento** en envíos grandes (por ejemplo, 30 s cada 50 mensajes)
* Mire el tablero si el disyuntor detuvo un número
* Ver [Política anti-banimento](/es/whatsapp-api/como-funciona/politica-anti-banimento)

***

## Próximos pasos

* [Introducción](/es/whatsapp-api/como-funciona/introducao): descripción general del canal
* [Inicio rápido](/es/whatsapp-api/como-funciona/quick-start): conectar y enviar
* [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao): oficial × no oficial
* [Política anti-banimento](/es/whatsapp-api/como-funciona/politica-anti-banimento): ritmo y calentamiento