En breve
- Agrupa varios números activos y elige cuál envía cada mensaje.
- Opcional, sin piscina, sigue usando
instanceIdcomo 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.
Cuándo usar
Sin ningún grupo configurado, el flujo
instanceId actual permanece igual.Un tipo por grupo
Esta es la regla principal:
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ómo funciona en la práctica
- Cree el grupo en el panel y agregue números activos del mismo tipo
- Elija cómo distribuir (por turnos, peso o menos uso hoy)
- Enviar sin
instanceId, el grupo predeterminado osendingPoolIdelige el número por destinatario - Si un número falla con demasiada frecuencia, el disyuntor detiene solo ese número; los demás siguen adelante
instanceId explícito, el mensaje va desde ese número y el grupo no se aplica a ese envío.
Modos de distribución
Configuración principal
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)
No envíe
instanceId y sendingPoolId juntos, la API devuelve 400.Mejores prácticas
- 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
Próximos pasos
- Introducción: descripción general del canal
- Inicio rápido: conectar y enviar
- Modos de conexión: oficial × no oficial
- Política anti-banimento: ritmo y calentamiento

