¿Cómo funciona un grupo creado con la API de WhatsApp?
Un grupo de la Groups API es un chat grupal de WhatsApp que tu empresa crea y administra por API, igual que hoy envías mensajes 1:1 desde la WhatsApp Business API. La diferencia clave es que los grupos son solo por invitación: cada persona decide si entra, a partir de un enlace que muestra el nombre y el contexto del grupo.
El circuito completo, según la documentación de Meta, es este:
- Creas el grupo con el endpoint de creación, indicando un asunto y, si quieres, una descripción.
- Recibes el enlace de invitación en el webhook
group_lifecycle_update, que confirma que el grupo se creó. - Agregas la plantilla de invitación desde la Template Library (opción "Group invite link") y esperas su aprobación.
- Envías la invitación a cada persona con esa plantilla y el enlace del paso 2.
- Recibes un aviso cuando alguien se une (webhook
group_participants_update): desde ese momento puedes escribirle al grupo. - Envías y recibes mensajes con el mismo endpoint de mensajes, usando
recipient_type: "group"y el ID del grupo ento. Las respuestas de los participantes llegan por webhook con un campogroup_id.
También puedes activar solicitudes de ingreso, restablecer el enlace de invitación, quitar participantes, cambiar la configuración del grupo y fijar hasta 3 mensajes (de 1 a 30 días cada uno). Para arrancar necesitas un número que use la Cloud API, un webhook configurado, la suscripción a los campos group_lifecycle_update, group_participants_update, group_settings_update y group_status_update, y el permiso whatsapp_business_messaging.
¿Qué requisitos necesitas para usar la Groups API?
El requisito principal es que el número sea una Official Business Account (OBA): un número de empresa verificado como auténtico, que muestra una insignia azul junto al nombre. Es una verificación de la API y no hay que confundirla con la suscripción Meta Verified. Para pedir la OBA, Meta exige:
- Cumplir la WhatsApp Business Messaging Policy.
- Llevar al menos 30 días registrado en la WhatsApp Business Platform.
- Tener el business portfolio dueño del número verificado con Business Verification.
- Tener la verificación en dos pasos activada en el número, según la documentación de OBA vigente.
- Tener el nombre visible del número aprobado.
La solicitud se hace desde WhatsApp Manager (Números de teléfono → Perfil → Official business account) o por API. Si Meta la rechaza, puedes volver a pedirla a los 30 días. Meta no otorga la OBA a números de empleados, cuentas de prueba ni números de la WhatsApp Business App.
¿Cuántas personas entran en un grupo y qué se puede enviar?
Los grupos de la API son chicos a propósito: están pensados para conversaciones de pocas personas que una empresa gestiona con su sistema, no para audiencias grandes. Estos son los límites publicados por Meta:
| Elemento | Límite o regla |
|---|---|
| Participantes por grupo | Hasta 8 |
| Grupos por número de empresa | Hasta 10.000 |
| Empresas de Cloud API por grupo | 1 |
| Mensajes que sí se pueden enviar | Texto, multimedia, plantillas de texto y plantillas con multimedia |
| Mensajes que no se pueden enviar | Mensajes interactivos (botones, listas), Authentication, mensajes de comercio, llamadas, mensajes temporales y de visualización única |
| Acciones no disponibles | Editar o borrar mensajes y ocultar la lista de participantes |
| Mensajes fijados | Hasta 3 a la vez, solo el administrador, de 1 a 30 días |
| Métricas de plantillas | No están disponibles para plantillas usadas en grupos |
Como las métricas de rendimiento no se calculan para plantillas usadas en grupos, Meta recomienda crear plantillas específicas para grupos en lugar de reutilizar las de tus mensajes 1:1. Otro detalle operativo: cada mensaje de un grupo se marca como leído por separado; marcar uno no marca los anteriores. Y la Calling API no funciona dentro de los grupos.
¿Cómo se cobra un mensaje enviado a un grupo?
La Groups API usa el mismo modelo de cobro por mensaje de la Cloud API para decidir si un mensaje es facturable, pero cobra una vez por cada participante al que se le entrega, a la tarifa del código de país de cada destinatario. Si envías una plantilla de marketing a un grupo de 5 personas y llega a las 5, pagas 5 mensajes de marketing; si llega a 4, pagas 4.
La ventana de atención también funciona distinto: cuando cualquier participante te escribe, se abre (o se renueva) una ventana de atención entre tu empresa y todo el grupo. Lo que cambió el 1 de octubre de 2026 es qué se cobra dentro de esa ventana:
| Mensaje al grupo | Hasta el 30/9/2026 | Desde el 1/10/2026 |
|---|---|---|
| Plantilla de marketing | Se cobra por destinatario | Se cobra por destinatario |
| Plantilla Utility dentro de la ventana del grupo | Gratis | Se cobra por destinatario |
| Plantilla Utility fuera de la ventana | Se cobra por destinatario | Se cobra por destinatario |
| Texto libre (sin plantilla) dentro de la ventana | Gratis | Gratis solo mientras el número tenga cupo de servicio; después se cobra |
El cupo es el mismo de los 1.000 mensajes de servicio gratis por mes de cada número de la empresa, compartido con tus chats 1:1, y cada envío al grupo consume una unidad por destinatario que lo recibe. Ejemplo: un mensaje de texto libre entregado a 7 participantes consume 7 de esos 1.000. Las tarifas son las mismas que en la mensajería 1:1 y puedes verlas en precios de WhatsApp Business API. Una diferencia: las plantillas Utility enviadas a grupos no acceden a los volume tiers.
group_marketing, group_utility y group_service. Un mensaje cobrado trae pricing.type: "regular"; uno gratis dentro del cupo trae free_group_customer_service.¿En qué se diferencia la Groups API de los grupos y Comunidades de la App?
Son productos distintos. Los grupos y las Comunidades de WhatsApp se administran a mano desde el teléfono y sirven para reunir audiencias grandes. La Groups API sirve para que un sistema (tu CRM, tu bandeja compartida o tu Agente IA) cree y atienda grupos chicos de forma automática.
| Aspecto | Groups API (Cloud API) | Grupos y Comunidades de la App |
|---|---|---|
| Quién lo gestiona | Tu integración, por API y webhooks | Una persona desde la App |
| Tamaño | Hasta 8 participantes | Pensado para grupos grandes (ver límites en la guía de Comunidades) |
| Cómo se entra | Solo con enlace de invitación que la persona acepta | Enlace de invitación o alta desde la App |
| Requisito | Official Business Account en la Cloud API | Cualquier cuenta de WhatsApp o de la App Business |
| Costo de Meta | Cada mensaje facturable se cobra por destinatario | No aplica el cobro por mensaje de la API |
| Automatización | Webhooks de mensajes, participantes y estado | Manual |
Si lo que buscas es llegar a mucha gente con anuncios en una sola dirección, lo que corresponde es un canal de WhatsApp o una campaña con plantillas, no un grupo de la API. Y si usas Coexistence, recuerda que los grupos de la App no se sincronizan con la API.
¿Para qué le sirven los grupos de la API a una empresa?
Los grupos de la API tienen sentido cuando una misma conversación involucra a varias personas del lado del cliente o de tu equipo, y quieres que todo quede registrado en tu sistema. Algunos casos donde el tope de 8 participantes alcanza:
- Cuentas B2B: el comprador, su jefe de compras y tu ejecutivo de cuenta en un solo chat para cotizaciones y seguimiento de pedidos.
- Inmobiliarias: la pareja compradora, el asesor y el gestor del crédito coordinando visitas y documentos.
- Salud y cuidado: el paciente, un familiar a cargo y la recepción del consultorio para turnos e indicaciones.
- Logística y servicios técnicos: el cliente, el transportista o técnico y el despacho para coordinar una entrega o una visita.
- Educación y viajes: grupos chicos de tutoría, de una familia o de pasajeros de una misma reserva.
Y conviene descartarla cuando:
- Necesitas más de 8 personas o difusión masiva.
- Tu número opera en Coexistence o todavía no tiene OBA.
- El flujo depende de botones, listas o Flows: los mensajes interactivos no se admiten en grupos.
- Debes enviar códigos de verificación: Authentication no está disponible en grupos.
Antes de lanzar, define quién de tu equipo responde en cada grupo y qué mensajes van con plantilla. Con el cobro por destinatario, un grupo de 8 multiplica por 8 el costo de cada plantilla: calcula el impacto con la calculadora de precios de WhatsApp 2026.
Preguntas Frecuentes
Fuentes oficiales
Equipo de Cliengo
Cliengo es Meta Business Partner oficial. Ayudamos a empresas de LATAM a vender más con WhatsApp Business, Agentes IA y CRM conversacional.
Cómo verificamos la informaciónConocer más sobre Cliengo →Páginas relacionadas
Comunidades de WhatsApp
Grupos grandes administrados desde la App.
Ver detalles de Comunidades de WhatsApp →💬Mensajes de servicio
Cómo funciona el cupo de 1.000 mensajes gratis por número.
Ver detalles de Mensajes de servicio →💲Precios de la API
Tarifas vigentes por país y categoría.
Ver detalles de Precios de la API →⏱️Ventana de 24 horas
Qué puedes enviar sin plantilla y cuándo.
Ver detalles de Ventana de 24 horas →🔁Coexistence
App y API en el mismo número, con sus límites.
Ver detalles de Coexistence →⚡WhatsApp Business API
La plataforma sobre la que funcionan los grupos.
Ver detalles de WhatsApp Business API →

