Equipo Periskope
La API de grupos de WhatsApp (Groups API) permite a las empresas crear y gestionar grupos de WhatsApp de forma programática desde la WhatsApp Business Platform.
Para tener acceso necesitas una cuenta de empresa oficial (Official Business Account u OBA) y un número de Cloud API compatible. Además, la API tiene límites estrictos en el tamaño de los grupos, la creación de grupos, la gestión de participantes y el envío de mensajes.
En esta guía vemos quién puede usar la API de grupos, qué pide el estatus OBA, cuáles son los límites actuales, cuánto cuesta y qué hacer si la API no se ajusta a lo que necesitas.
En resumen: la API de grupos de WhatsApp de un vistazo
¿Quién puede usar la API de grupos de WhatsApp?
Para usar la API de grupos, tu empresa necesita una cuenta de empresa oficial (OBA).
Ojo: tener una cuenta de Meta Business verificada, un nombre visible aprobado en WhatsApp o acceso a la WhatsApp Business Platform no te convierte automáticamente en OBA.
1. ¿Qué significa OBA?
Meta otorga el estatus OBA a empresas establecidas y reconocidas en WhatsApp. En la revisión se toman en cuenta factores como:
La verificación del negocio
Un nombre visible aprobado
La verificación en dos pasos en el número de teléfono
Cuánto tiempo lleva la empresa activa en la WhatsApp Business Platform
Si la empresa tiene una presencia reconocida y auténtica
Calificar como OBA es distinto a solo completar la verificación del negocio (Business Verification).
2. La insignia OBA vs el estatus real en la API
Hay otro detalle que conviene revisar si validas la elegibilidad desde la API.
WhatsApp expone más de un campo relacionado con el estatus de la cuenta, entre ellos is_official_business_account y oba_status. Y no siempre dicen lo mismo.
Puede pasar que un campo marque la cuenta como oficial mientras que oba_status no muestra un estatus OBA activo.
Si estás programando una validación automática de elegibilidad, no te fíes de un solo campo booleano. Revisa el estatus OBA real que devuelve la API para la empresa y confirma que el número y la cuenta cumplen los requisitos de la API de grupos.
Esto importa porque, si no, un panel o una integración puede mostrar a una empresa como "oficial" aunque la cuenta todavía no pueda usar la API de grupos.
3. Necesitas un número de Cloud API
La API de grupos funciona con números de WhatsApp Cloud API.
Un número que funciona con la app WhatsApp Business no puede usar la API de grupos. Por ahora, Meta tampoco permite usar la API de grupos con Coexistence.
Así que si hoy tu empresa maneja su número desde la app WhatsApp Business, no puede conectar esa misma configuración a la API de grupos. El número necesita una configuración compatible de Cloud API.
Checklist rápido de elegibilidad Antes de construir algo sobre la API de grupos, confirma que:
|
|---|
Try Periskope
Gestiona grupos, chats y números de WhatsApp a escala
Límites y restricciones de la API de grupos de WhatsApp
Una vez que tu empresa califica, la siguiente pregunta es si la API encaja con tu forma real de trabajar.
1. Hasta 8 participantes por grupo
Un grupo de la API de grupos admite hasta 8 participantes, contando el número de la empresa. Eso deja lugar para un máximo de 7 personas más.
Por eso la API sirve más para conversaciones pequeñas y enfocadas que para comunidades grandes de clientes.
Por ejemplo:
Un cliente + el equipo de soporte
Un equipo de proyecto pequeño
Un distribuidor + sus ejecutivos de cuenta
Un grupo pequeño de clientes en pleno proceso de onboarding
Si necesitas un grupo de WhatsApp con 50 o 500 miembros, este límite descarta la API de grupos.
2. Hasta 10.000 grupos por número de empresa
Un solo número de empresa de la API de WhatsApp puede crear hasta 10.000 grupos con la API de grupos.
Otra regla que debes conocer: un grupo solo puede pertenecer a una empresa de Cloud API. Dos cuentas de empresa distintas no pueden compartir ni gestionar juntas el mismo grupo.
3. Los participantes entran por invitación
La API de grupos no deja que la empresa agregue participantes directamente.
Cuando creas un grupo, WhatsApp genera un enlace de invitación. Puedes mandarlo a quien quieras invitar y, si prefieres revisar quién entra, también puedes activar la aprobación de solicitudes para unirse.
Por ejemplo, una empresa podría crear un grupo para un cliente nuevo y mandarle el enlace de invitación con una plantilla de WhatsApp aprobada.
4. Solo se pueden fijar 3 mensajes
La API de grupos permite fijar mensajes, con un máximo de 3 mensajes fijados por grupo.
Si fijas un cuarto mensaje, WhatsApp desfija automáticamente el más antiguo. Cada mensaje puede quedarse fijado entre 1 y 30 días.
5. La API de grupos tiene sus propios límites de frecuencia
Las operaciones de la API de grupos tienen sus propios límites de frecuencia (rate limits). Si un número hace demasiadas operaciones de grupo en poco tiempo, la API puede devolver el error 131208, Group Rate Limit Hit.
Esto es independiente del throughput general de mensajes de tu Cloud API. Tener un throughput alto no elimina los límites de operaciones de la API de grupos.
6. Meta puede desactivar temporalmente la creación de grupos
Meta puede impedir por un tiempo que una empresa cree grupos nuevos si detecta que la WABA envió demasiados mensajes de marketing dentro de la ventana de atención al cliente en los 7 días anteriores.
Esto aparece como el error 131214.
Si tu operación depende mucho de crear grupos nuevos, tenlo en cuenta desde el principio.
¿Cómo se cobra la API de grupos de WhatsApp?
Con los precios normales de WhatsApp Cloud API pagas por cada mensaje entregado a la persona a la que le escribes (desde el 1 de julio de 2025, Meta cobra por mensaje, no por conversación de 24 horas).
Una persona, un mensaje cobrado.
En los grupos funciona distinto.
Cuando envías un mensaje a un grupo, WhatsApp lo cobra como una entrega separada a cada persona del grupo, no como un solo mensaje.
Entonces, enviar una actualización a un grupo lleno de 8 personas (tu empresa más otras 7) cuenta como 7 entregas cobradas, no como 1.
Ejemplo: una empresa que envía 100 actualizaciones al mes a un grupo lleno de 8 personas no paga 100 mensajes. Paga hasta 700 entregas, el mismo gasto total que si enviara 700 mensajes individuales.
El costo crece con el total de personas a las que llegas en todos tus grupos, no con las veces que le das a enviar. Desde el 1 de octubre de 2026, los mensajes de servicio (respuestas libres dentro de la ventana de 24 horas) también se cobran después de los primeros 1.000 gratis por número de empresa al mes, a la tarifa de utilidad de cada mercado. Mira qué cambió el 1 de octubre.
¿Qué hacer si no calificas o si los límites se te quedan cortos?
Si tu empresa todavía no tiene estatus OBA, usa la app WhatsApp Business o trabaja con Coexistence, por ahora no tienes acceso a la API de grupos, sin importar qué tan sólida sea el resto de tu configuración.
E incluso con OBA, el límite de 8 participantes deja fuera cualquier cosa más grande que un grupo pequeño y estructurado.
Un escalamiento de soporte con un puñado de personas, sí funciona. Una comunidad, una generación de alumnos o un grupo de clientes de tamaño real, no.
Si ya tienes grupos de WhatsApp activos, Periskope le da a tu equipo una forma de gestionarlos a escala.
Conecta números normales de WhatsApp y de WhatsApp Business con la función de dispositivos vinculados, así tu equipo gestiona los grupos y chats que esos números ya usan.
Puedes llevar esas conversaciones a un espacio de trabajo compartido, asignar tickets y tareas, repartir los mensajes entre tu equipo, automatizar flujos y gestionar miles de grupos de WhatsApp desde un solo lugar.
Por eso es útil para empresas que ya tienen grupos de WhatsApp activos y quieren gestionarlos en equipo, en lugar de crear grupos nuevos con la API de grupos.
Para una comparación detallada de los dos enfoques, lee grupos normales de WhatsApp vs API de grupos de WhatsApp.
Preguntas frecuentes
1. ¿Qué significa tener una cuenta de empresa oficial (OBA) en WhatsApp?
La OBA es un estatus que Meta otorga a empresas establecidas y reconocidas en la WhatsApp Business Platform.
Pide verificación del negocio, un nombre visible aprobado, verificación en dos pasos y cierto historial en la plataforma, pero cumplir todo eso no garantiza por sí solo el estatus OBA.
2. ¿Por qué mi empresa aparece como verificada pero no puede usar la API de grupos?
La verificación del negocio y el estatus OBA no son lo mismo. Revisa directamente el campo oba_status en lugar de fiarte de una insignia, que puede aparecer con Meta Verified sin una aprobación OBA completa.
3. ¿Puedo usar la API de grupos de WhatsApp con la app WhatsApp Business?
No. La API de grupos requiere un número estándar de Cloud API. No está disponible para números de la app Business ni para configuraciones con Coexistence.
4. ¿La API de grupos de WhatsApp exige enviar 100.000 mensajes al día?
No. La documentación actual de Meta sobre la API de grupos no menciona un umbral de 100.000 mensajes como requisito aparte. El estatus OBA es el requisito clave de la cuenta, junto con la configuración de Cloud API.
5. ¿Cuántos grupos puede crear un número de empresa de WhatsApp?
Hasta 10.000 grupos por número de empresa.
6. ¿Cómo se calcula el precio de la API de grupos de WhatsApp?
Por destinatario, no por mensaje enviado. Un mensaje a un grupo de 8 personas se cobra como hasta 7 entregas, no como una.
7. ¿Por qué no puedo agregar a un participante directamente a un grupo de la API de grupos?
No existe un endpoint para agregar participantes. La gente entra con un enlace de invitación que tiene que aceptar por su cuenta.
8. ¿Puedo pasar un grupo de WhatsApp que ya tengo a la API de grupos?
No. La API de grupos está pensada para crear grupos nuevos gestionados por API y no permite importar un grupo existente ni su lista de miembros. Si ya tienes grupos de WhatsApp activos, Periskope puede gestionarlos sin ninguna migración.
Prueba Periskope gratis y ve cómo funciona con tus propios grupos.
