LinkedIn
Instagram
Telegrama
Gmail
Outlook
Calendario de Google
Únase a la comunidad Slack Índice
Límites y puntos finales
Construyendo con ello
API de Grupos de WhatsApp - 2026
WhatsApp API de grupos En 2026: Lo que Meta apoya y lo que no
La API de grupos de WhatsApp de Meta ya está disponible en la Cloud API, pero solo funciona para Cuentas comerciales oficiales, limita cada grupo a 8 participantes, y tiene no hay un endpoint para agregar a alguien directamente. Esto es lo que eso significa para un producto real, punto por punto, además del único camino que elimina los tres límites.
Configuración de grupo API en la nube Incorporación de Clientes de Acme Grupo
JD AS ML RK TN CW PB +1 8 / 8 participantes
Se requiere cuenta comercial oficial
Grupo lleno: no hay ningún endpoint para añadir a un 9º participante
API de grupos
¿La API de WhatsApp admite mensajería grupal?
Sí. La Plataforma de WhatsApp Business ahora expone una API de Grupos en la API de la nube, por lo que un número de empresa puede crear grupos, enviar mensajes en ellos y gestionar la membresía. Tres condiciones la limitan: la empresa debe ser una Cuenta de empresa oficial, cada grupo tiene un límite de 8 participantes, y hay no hay un endpoint para agregar un participante directamente.
API de grupos de WhatsApp: compatible vs no compatible Verificado con la documentación de la API de Cloud de Meta, agosto de 2026
Soporte
Crear, enumerar y actualizar grupos en un número de empresa de Cloud API
Enviar mensajes de texto, multimedia y plantillas a un grupo
Generar y restablecer el enlace de invitación del grupo
Aprobar o rechazar solicitudes de unión pendientes
Eliminar a un participante de un grupo
Suscríbete a 4 eventos de webhook específicos de grupos
No se admite
Añadir un participante directamente: solo enlace de invitación
Llamadas de voz o de vídeo dentro de un grupo
Mensajes temporales y contenido multimedia de visualización única
Editar o eliminar un mensaje ya enviado al grupo
Ocultar la lista de participantes como administrador
Análisis de rendimiento por plantilla para mensajes de grupo
Este desglose sigue la propia documentación de la API de Grupos de Meta. Fuente: developers.facebook.com, API de grupos de WhatsApp, comprobado en agosto de 2026. El resto de esta guía cubre cada punto de conexión (endpoint), qué activa el límite de 8 participantes y el único vacío que ninguna de las propias documentación de Meta menciona directamente: no hay forma de añadir un participante a un grupo.
Definición
¿Qué es la API de grupos de WhatsApp?
En API de grupos de WhatsApp es la capa de mensajería grupal que Meta añadió sobre la API en la nube de WhatsApp Business Platform. Permite que un número de teléfono comercial cree grupos, envíe mensajes a ellos y administre membresías a través de un conjunto dedicado de puntos de conexión, sin necesidad de cambiar a un producto diferente.
Permanece igual
Lo mismo
PHONE_NUMBER_ID utilizado para mensajería 1:1Misma configuración de token de acceso y permisos a nivel de aplicación
Lo mismo
/mensajes punto de acceso para enviar a un grupo ¿Qué hay de nuevo
Un dedicado
/grupos familia de endpoints: crear, listar, actualizar, eliminarEndpoints de enlace de invitación y solicitud de unión
4 nuevos campos de webhook para eventos del ciclo de vida del grupo
Un número que ya envía mensajes 1:1 a través del Guía de la API de WhatsApp no necesita una segunda integración para admitir grupos. Necesita el permiso adicional que se cubre a continuación y los puntos de conexión adicionales que se cubren más abajo en esta página.
Admisibilidad
¿Quién puede usar la API de Grupos de WhatsApp?
Solo un subconjunto de números de WhatsApp Business Platform califica para la API de grupos de WhatsApp. Una empresa debe ejecutar una Cuenta de empresa oficial en la propia Cloud API antes de que se pueda crear un solo grupo, y se excluyen explícitamente dos tipos de números comunes.
Cuenta Oficial de Empresa (OBA)
El número debe contar con el estado OBA de Meta, el nivel verificado de la Plataforma de WhatsApp Business.
API de Live en la Nube
El número tiene que estar en uso activo en la API de Cloud, no en la aplicación gratuita de WhatsApp Business.
En
mensajería_de_whatsapp_business permisoLa aplicación conectada debe tener este permiso aprobado antes de que cualquier endpoint de grupo responda.
Suscrito al WABA correcto
La aplicación debe estar suscrita a la cuenta de WhatsApp Business propietaria del número.
Números en la aplicación WhatsApp Business
Excluido. La API de Grupos es una función de la API de Cloud, no algo que la aplicación de Negocios orientada al consumidor exponga.
Números en conversaciones con múltiples soluciones
Excluido. Los números compartidos entre múltiples proveedores de soluciones empresariales no pueden ejecutar la API de Grupos.
Documentación de introducción a la API de Grupos de Meta, consultada en agosto de 2026.
Límites
¿Cuántos participantes puede tener un grupo de la API de WhatsApp?
Máximo 8 participantes por grupo. Un solo número de empresa puede tener hasta 10 000 grupos, y solo un negocio de API en la nube puede operar dentro de un grupo determinado a la vez.
En la API de grupos de WhatsApp, el número de empresa que crea el grupo ocupa uno de los ocho espacios como participante, lo que deja espacio para clientes reales o compañeros de equipo en lugar de los ocho completos. Para un producto que necesita un grupo de incorporación, un canal de proyecto o una célula de soporte con más de unas pocas personas, ese límite se alcanza rápidamente.
El límite de 8 participantes no es un error técnico. Refleja una decisión de diseño deliberada para la mensajería empresarial estructurada en lugar de un chat comunitario abierto, lo cual es un caso de uso materialmente diferente al de un grupo personal de WhatsApp. La pregunta práctica para un equipo de producto no es si 8 son suficientes en teoría, sino si el grupo puede crecer más allá de sus primeras 8 personas, que es lo que responden las dos secciones siguientes.
Referencia API
¿Qué endpoints expone la API de Grupos de WhatsApp?
La API de Grupos de WhatsApp añade 12 puntos de terminación además de la API estándar de Cloud: la creación de grupos, los metadatos, el enlace de invitación y las solicitudes de unión. Ninguna de ellas añade un participante directamente.
Método
Camino
Para qué sirve
POST
//groups
Crea un nuevo grupo y devuelve su primer enlace de invitación
GET
//groups
Enumera todos los grupos activos vinculados al número de la empresa
GET
/?campos=
Lee los metadatos de un solo grupo: asunto, descripción, recuento de participantes
POST
/
Actualiza el asunto, la descripción o la foto del grupo
BORRAR
/
Elimina el grupo y elimina a todos los participantes de una vez
GET
//invite_link
Devuelve el enlace de invitación actual del grupo
POST
//invite_link
Restablece el enlace de invitación, lo que invalida todos los enlaces compartidos anteriormente
GET
//join_requests
Lista las solicitudes de unión pendientes de aprobación
POST
//join_requests
Aprueba una o más solicitudes de unión pendientes
BORRAR
//join_requests
Rechaza una o más solicitudes de unión pendientes
BORRAR
//participants
Elimina a uno o más participantes del grupo
POST
//messages
Envía un mensaje de texto, multimedia o plantilla al grupo
Observa detenidamente lo que falta: hay un
ELIMINAR /participants punto final, y no POST /participants punto final. Puedes eliminar a alguien de un grupo de la API de WhatsApp. No puedes agregarlo de la misma manera. La siguiente sección explica exactamente qué significa eso y qué hacer al respecto. La brecha
¿Se puede añadir a alguien a un grupo de WhatsApp con la Cloud API?
No. La API de grupos de WhatsApp no tiene un punto de acceso para añadir participantes. Los participantes solo pueden unirse a través de un enlace de invitación compartido, y la empresa puede entonces aprobar o rechazar la solicitud de unión.
ELIMINAR //participants elimina personas, no añade ninguna.El único camino de entrada, de principio a fin
1
Crear el grupo
POST /groups devuelve un group_id y un primer enlace de invitación
2
Obtener el enlace de invitación
GET o POST /invite_link, restablecible en cualquier momento
3
Envía el enlace
POST /messages, una plantilla 1:1 enviada al prospecto
4
Solicitan unirse
Al tocar el enlace se crea una entrada join_requests
Tú apruebas
POST /join_requests los confirma como participantes
# Paso 2: obtener o restablecer el enlace de invitación del grupo
rizo -X POST \ "https://graph.facebook.com/v21.0//invite_link" \ -H "Authorization: Bearer "
// 200 OK
{
"enlace de invitación": "https://chat.whatsapp.com/"
}Esta es la única forma de entrar. No hay importación masiva, ni CSV de números de teléfono, ni un punto de conexión que añada una lista de personas a un grupo en una sola llamada. Cada persona tiene que tocar un enlace y esperar la aprobación, de uno en uno. Para un puñado de contactos VIP eso es un inconveniente menor. Para un flujo de productos recurrente, incorporar a cada nuevo cliente en un grupo dedicado, dotar de personal a un canal de proyecto, construir una célula de soporte por cuenta, es un paso manual que ocurre fuera de la API para cada persona, cada vez.
Compáralo con un API de enlaces de WhatsApp utilizado para la prospección 1:1, donde compartir un enlace es el punto de entrada por diseño. Dentro de un grupo, el mismo mecanismo de enlace de invitación se convierte en la única puerta disponible, se ajuste o no al flujo real de incorporación del producto.
Una cuenta de WhatsApp vinculada a través de Unipile no tiene esta restricción: el mismo tipo de acción que elimina a un participante tiene una contraparte que agrega uno directamente, en nombre del usuario autenticado. Todos los detalles, incluidos los puntos de conexión, más abajo en esta página en cómo acceder a los grupos de WhatsApp desde la propia cuenta de un usuario.
No se admite
¿Qué no es compatible con los grupos de la API de WhatsApp?
Seis tipos de mensajes, tres acciones de administración y una API no están disponibles dentro de un grupo creado a través de la API de grupos de WhatsApp, a pesar de que cada uno de ellos funciona bien en una conversación individual normal con el mismo número.
Categoría
No disponible
Tipos de mensajes
Llamadas, mensajes temporales, contenido multimedia de visualización única, plantillas de autenticación, mensajes comerciales y mensajes interactivos
Acciones de administración
Ocultar la lista de participantes, editar un mensaje ya enviado al grupo y eliminar un mensaje ya enviado al grupo
API
La API de llamadas no funciona dentro de una conversación grupal
Analítica
No hay métricas de rendimiento por plantilla para las plantillas utilizadas en un grupo. Meta recomienda mantener las plantillas de grupo separadas de las plantillas 1:1 por este motivo
Cómo se hace
¿Cómo se envía un mensaje a un grupo de WhatsApp?
Usa el mismo
POST //messages punto final como mensajería uno a uno, conjunto tipo de destinatario a grupo, y pon el ID del grupo en a. No hay un endpoint separado para los mensajes de grupo.Mensaje de texto, curl
rizo -X POST \ "https://graph.facebook.com/v21.0//messages" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{
"messaging_product": "whatsapp",
"recipient_type": "group",
"to": "",
"type": "text",
"Bienvenido al canal del proyecto.
}'Mensaje de plantilla, Node.js
const response = await fetch(
`https://graph.facebook.com/v21.0/${ID_DE_TELÉFONO_DE_EMPRESA}/messages`,
{
método: "PUBLICAR",
cabeceras: {
Authorization: `Portador ${TOKEN_DE_ACCESO}`,
"Tipo-Contenido": "application/json",
},
cuerpo: JSON.stringify({
producto_de_mensajería: "whatsapp",
tipo de destinatario: "grupo",
a: GROUP_ID,
tipo: "plantilla",
plantilla: {
nombre: "bienvenida_de_incorporación",
idioma: { código: "es_US" },
},
}),
}
);Los mensajes multimedia siguen el patrón idéntico: hacer referencia al contenido multimedia cargado y luego enviarlo con
recipient_type: "group" de la misma manera que el texto o una plantilla. La entrega, el formato, los reintentos y los códigos de error siguen las mismas reglas que cualquier otro mensaje de la API de Cloud, ya sea en grupo o no.Lo que no cambia en la API de grupos de WhatsApp: no hay ningún límite de tasa específico para grupos documentado por separado de los límites de mensajería estándar, ni ningún formato de mensaje específico para grupos. El único campo nuevo es
tipo de destinatario.Webhooks
¿Qué webhooks se activan en los eventos de grupos de WhatsApp?
La API de grupos de WhatsApp añade cuatro campos de webhook para cubrir la actividad de los grupos, y los cuatro requieren una suscripción separada antes de que cualquier evento de grupo llegue a tu punto de conexión. Ninguno de ellos está cubierto por el webhook de mensajes estándar que quizás ya uses para chats 1:1.
Campo de webhook
Se dispara cuando
actualización_del_ciclo_de_vida_del_grupo
Se crea o se elimina un grupo en el número comercial
actualización_de_participantes_del_grupo
Cambios de membresía: se aprueba una solicitud de unión o se elimina a un participante
actualización_de_configuración_de_grupo
Se cambia el asunto, la descripción o la foto del grupo
actualización_estado_grupo
El estado general del grupo cambia en la plataforma
Nombres de campos y requisito de suscripción según la documentación de introducción de la API de grupos de Meta, revisada en agosto de 2026. Véase el referencia completa de la carga útil del webhook para estructuras de campos exactas.
Precios
¿Cuánto cuestan los mensajes de grupo de WhatsApp?
Por mensaje, del mismo modo que cualquier otra conversación de la API de Cloud. No hay una lista de tarifas separada ni descuentos por grupo.
Meta trasladó toda la plataforma de WhatsApp Business a un sistema de precios por mensaje el 1 de julio de 2025, reemplazando el antiguo modelo por conversación. Los mensajes de grupo enviados a través de la API de grupos de WhatsApp se facturan de la misma manera: cada mensaje enviado a un grupo cuenta individualmente, a la misma tarifa por mensaje que un mensaje 1:1 en la misma categoría y en el mismo país.
No hay un descuento por volumen específico para grupos y, como se indicó anteriormente en esta página, no hay un panel de rendimiento separado para las plantillas utilizadas en un grupo. Presupuestar un caso de uso con un uso intensivo de grupos significa tratar cada mensaje de grupo exactamente como figura en la factura: un mensaje más según la tarifa estándar por mensaje.
Para conocer la tarifa completa en todas las categorías de conversación y países, consulte nuestro Precios de la API de WhatsApp Business desglose.
Cuentas vinculadas
¿Cómo se accede a los grupos de WhatsApp desde la propia cuenta de un usuario?
Una cuenta de WhatsApp se conecta a través de Unipile de la misma manera que una persona usaría WhatsApp Web: escaneando un código QR. Código QR o código de emparejamiento, en nombre del usuario autenticado, con sin verificación de Meta Business requerido. Una vez vinculado, sus grupos son chats estándar, accesibles a través de los mismos puntos de acceso de chat y mensajería que cualquier otra conversación.
Unipile actúa como un intermediario técnico independiente entre un producto y WhatsApp: cada llamada a continuación se ejecuta en nombre del usuario autenticado que vinculó la cuenta, no como una integración permanente con WhatsApp o Meta.
Nota sobre el tratamiento de datos
Limitado a la sesión autenticada
Los datos de grupo recuperados a través de una cuenta de WhatsApp vinculada no se almacenan en un sistema paralelo ni se conservan como un archivo independiente. El acceso se limita a la sesión del usuario autenticado quién vinculó la cuenta, y cada solicitud actúa en nombre de ese usuario.
Límites de la plataforma y uso responsable
Los propios límites de WhatsApp, transmitidos
Unipile transmite los propios límites de velocidad nativos de WhatsApp en la cuenta vinculada en lugar de imponer uno separado. Con qué frecuencia se envía un mensaje a un grupo y cuántos grupos administra una cuenta sigue siendo un decisión del lado del cliente, realizado dentro de los propios límites de WhatsApp para esa cuenta.
Una vez que se vincula una cuenta, sus grupos aparecen junto con cualquier otro chat. Filtrar por WhatsApp y paginar a través de ellos utiliza el mismo extremo de lista de chat que cualquier otra conversación:
Listar todos los grupos y chats de WhatsApp en una cuenta vinculada, curl
rizo -X GET \ ""https://.unipile.com:/api/v1/chats?account_type=WHATSAPP&account;_id=&limit;=50"" \ -H "X-API-KEY: " \ -H "aceptar: application/json"Iniciar un nuevo grupo funciona de la misma manera que iniciar cualquier chat con múltiples destinatarios: pasa más de una entrada en
attendees_ids, formateado de la misma manera que WhatsApp identifica a los contactos internamente.Iniciar un nuevo grupo de WhatsApp, curl
rizo -X POST \ "https://.unipile.com:/api/v1/chats"" \ -H "X-API-KEY: " \ -F "account_id=" \ -F "attendees_ids[]=33600000001@s.whatsapp.net" \ -F "attendees_ids[]=33600000002@s.whatsapp.net" \ -F "attendees_ids[]=33600000003@s.whatsapp.net" \ -F "asunto=Incorporación de Clientes de Acme" \ -F "Bienvenido al grupo"El SDK de Node expone la misma interfaz de chat para ver quién está ya en un grupo:
Listar los participantes de un grupo, SDK de Node.js
import { UnipileClient } from "unipile-node-sdk";
const client = new UnipileClient(URL_BASE, TOKEN_DE_ACCESO);
const asistentes = await cliente.mensajería.obtenerTodosLosAsistentesDelChat(chat_id);Aquí es donde una cuenta vinculada difiere de la API de grupos de WhatsApp:
PATCH /chats/{chat_id} admite un agregarParticipante acción, junto con eliminarParticipante y obtenerEnlaceDeInvitacion, en los chats de WhatsApp y Telegram. Añadir a alguien requiere que el propietario de la cuenta tenga el permiso de "Añadir a otros miembros" del grupo dentro de WhatsApp, el mismo permiso que se aplicaría si añadiera a esa persona manualmente desde su teléfono.Añadir, eliminar o invitar a un participante, SDK de Node.js
// Agregar un participante (Solo WhatsApp y Telegram)
await cliente.mensajería.ejecutarAcción({
chat_id,
acción: "añadirParticipante",
valor: "33600000009@s.whatsapp.net",
});
// Eliminar un participante
await cliente.mensajería.ejecutarAcción({
chat_id,
acción: "eliminarParticipante",
valor: "33600000009@s.whatsapp.net",
});
// Obtener el enlace de invitación del grupo
const { enlace de invitación } = await cliente.mensajería.ejecutarAcción({
chat_id,
acción: "obtenerEnlaceDeInvitación",
});No existe un límite publicado sobre cuántas personas puede albergar un grupo una vez que se gestiona a través de una cuenta vinculada: el grupo opera bajo la mecánica nativa de WhatsApp en la cuenta vinculada, no el límite de 8 participantes de la Cloud API. Unipile no documenta ni impone un límite de participantes propio además de este.
La referencia completa de parámetros para estas tres acciones, incluido el formato exacto del ID de proveedor por plataforma, está en Unipile punto de entrada de acción de chat documentación.
Decisión
API de grupos o cuenta vinculada: ¿cuál se adapta a tu producto?
Ambos caminos, la API de grupos de WhatsApp y una cuenta vinculada, crean y envían mensajes a grupos de WhatsApp. Se adaptan a diferentes productos, por lo que la elección correcta depende de si el caso de uso puede tolerar o no un límite de 8 participantes exclusivo por invitación.
Requisito
API de Grupos de Meta
Cuenta vinculada
Requisito de cuenta
Cuenta de empresa oficial, en la Cloud API
Cuenta de WhatsApp existente, vinculada por código QR o código de emparejamiento
Máximo de participantes
8 por grupo
Mecánicas de grupos nativas de WhatsApp, sin límite separado de Unipile
Añadir un participante directamente
No disponible: enlace de invitación y solo por aprobación
Disponible, mediante la acción addParticipant
Enlace de invitación
Generar y restablecer a través de la API
Generar mediante la acción getInviteLink
Leer el historial del grupo existente
No forma parte de la API: los mensajes llegan por webhook a medida que ocurren
Sincronización completa del historial más los puntos de acceso de la lista de mensajes
Lista de participantes
Solo recuento de participantes, a través de los metadatos del grupo
Lista completa de asistentes, una llamada
Tipos de mensajes
Texto, contenido multimedia, texto de plantilla, contenido multimedia de plantilla
Texto, contenido multimedia y tipos de mensajes nativos de WhatsApp
Webhooks
4 campos de grupo dedicados, cada uno con una suscripción independiente
Webhooks de chat y mensajes estándar
Modelo de facturación
Por mensaje, precios estándar de las conversaciones de la API de Cloud
Suscripción a Unipile, no se cobra por mensaje de WhatsApp
¿De quién es la conversación
La empresa, como titular de la Cuenta de Empresa Oficial
El usuario final, Unipile actúa en su nombre
API de Grupos de WhatsApp - Preguntas frecuentes
Respuestas a las preguntas que la documentación de la API de Grupos de WhatsApp de Meta no explica directamente.
No. La API de grupos de WhatsApp está activa en la API en la nube de la Plataforma de WhatsApp Business desde 2026. La confusión proviene del lado del ecosistema: varias plataformas de mensajería de terceros aún no han implementado la compatibilidad con grupos, y algunos centros de ayuda y solicitudes de funciones abiertas todavía describen los grupos de la API de WhatsApp como no compatibles, a pesar de que la propia documentación de Meta confirma lo contrario.
No, no para la API de Grupos de Meta: un Cuenta de empresa oficial en la Cloud API es obligatorio, y los números en la aplicación WhatsApp Business o en las conversaciones multisolución quedan excluidos. A Cuenta de WhatsApp vinculada a través de Unipile es un camino diferente: se vincula mediante código QR o código de emparejamiento, en nombre del usuario autenticado, sin ninguna verificación de Meta Business.
Máximo 8 participantes por grupo en la API de Grupos de la API de Cloud, y hasta 10,000 grupos por número de empresa. Una cuenta de WhatsApp vinculada a través de Unipile sigue la mecánica de grupos nativa de WhatsApp en la cuenta vinculada en lugar de ese límite.
Meta devuelve el ID del grupo cuando se crea, mediante
POST //groups. Los ID de grupo existentes se enumeran con GET //groups. En una cuenta vinculada, aparece el mismo ID como el chat_id devuelto al listar chats o al iniciar un grupo nuevo.Depende de la ruta. La API de Grupos de la Cloud API está basada en webhooks: los mensajes llegan a medida que ocurren y no hay ningún punto de conexión para extraer el historial pasado de un grupo. Una cuenta de WhatsApp vinculada a través de Unipile puede recuperar los mensajes existentes y resincronizar el historial completo de una conversación en nombre del usuario autenticado.
No. Unipile es un intermediario técnico independiente y es no está afiliado con, respaldado por, ni patrocinado por WhatsApp o Meta. Conecta la propia cuenta de WhatsApp de un usuario en su nombre y no opera como Proveedor de Soluciones de WhatsApp Business para la API en la nube descrita anteriormente en esta página.
¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
ES 
EN 
FR 
DE 
IT 
BR 
NL 
PL 
TR