Skip to main content
Los grupos de WhatsApp pueden reunir a varios participantes en una conversación compartida. La API de grupos actual de YCloud se enfoca en la configuración y gestión de grupos. Confirma que este alcance se adapte a tu caso de uso antes de crear una experiencia basada en grupos.
Actualmente, YCloud no admite el envío de mensajes a un grupo a través de la API de mensajes, y las conversaciones grupales no aparecen en Inbox. Enviar un mensaje con un enlace de invitación a una persona no es lo mismo que enviar un mensaje al grupo.

​
Verificar la elegibilidad del número

La actual guía de grupos de YCloud requiere una cuenta oficial de empresa (Official Business Account) y un número compatible con la Cloud API. Excluye los números de la aplicación WhatsApp Business y las conversaciones multi-solución. Tu cuenta de YCloud debe tener acceso al número. La disponibilidad de los grupos sigue sujeta a las verificaciones de elegibilidad de la plataforma y de YCloud; tener una clave de API por sí sola no hace que un número sea elegible. La guía documenta grupos pequeños de hasta ocho participantes. Consulta la guía actual antes de diseñar en función del recuento de grupos, los límites de participantes u otras estimaciones de capacidad.

​
Lo que admite YCloud

La API actual admite:
  • Crear, listar, consultar y eliminar grupos.
  • Obtener y restablecer enlaces de invitación.
  • Enviar una plantilla de enlace de invitación aprobada a un individuo.
  • Listar, aprobar y rechazar solicitudes de unión.
  • Eliminar participantes.
  • Actualizar el asunto y la descripción.
  • Recibir eventos del ciclo de vida del grupo, participantes, configuraciones y estados.
El contrato OpenAPI de YCloud define las operaciones exactas. Distingue explícitamente el envío de una invitación individual de la mensajería grupal.
Crea un grupo, recibe un enlace de invitación en el webhook e invita a usuarios de WhatsApp.

Meta's invitation model: create the group, receive the invite link through the lifecycle webhook, then invite WhatsApp users. This diagram does not imply YCloud outbound group-message support.

Fuente: ejemplo oficial de Meta.

​
La membresía es un proceso de invitación

El cliente elige si unirse a través de la invitación. Si se requiere aprobación, tu empresa revisa la solicitud de unión. No asumas que conocer el número de teléfono de una persona autoriza a agregarla a un grupo. Explica el propósito del grupo y quiénes participarán antes de compartir el enlace. Trata los enlaces de invitación como información sensible de acceso. Considera si un enlace sin restricciones puede reenviarse más allá de la audiencia prevista y define cuándo restablecerlo.

​
Esperar el resultado final

Algunas operaciones de gestión se completan de forma asíncrona. La respuesta inmediata confirma la recepción de la solicitud; los webhooks informan el resultado. Antes de enviar una invitación, confirma que la creación del grupo se haya realizado correctamente. Después de un cambio de membresía, confirma los participantes afectados en lugar de asumir que toda la solicitud se procesó con éxito. Una integración puede recibir un evento de mensaje grupal entrante aunque Inbox no muestre la conversación. Ese evento no otorga soporte para mensajes grupales salientes.

​
Un flujo de trabajo seguro para el primer grupo

  1. Confirma el estado OBA del número emisor y la elegibilidad para Grupos.
  2. Crea un grupo con un asunto claro y elige si la unión será automática o si requerirá aprobación.
  3. Guarda el ID de la solicitud de creación. Una respuesta con status: "pending" no es el grupo definitivo.
  4. Espera el evento de ciclo de vida de creación exitosa del grupo y guarda su ID de grupo y el enlace de invitación.
  5. Envía la plantilla aprobada del enlace de invitación a los destinatarios individuales elegibles.
  6. Si se requiere aprobación, revisa cada solicitud de unión y apruébala o recházala.
  7. Confirma la membresía a partir del resultado del participante antes de tratar a la persona como miembro.
Que una invitación haya sido entregada no significa que el destinatario haya abierto el enlace, solicitado acceso o ingresado al grupo. Si una operación de aprobación devuelve resultados mixtos, procesa cada resultado por separado.

​
Identificadores y límites documentados

Trata el ID de grupo como un identificador opaco y sensible a mayúsculas y minúsculas. No lo normalices ni lo decodifiques. El ID de solicitud de creación, el ID de grupo, el ID del mensaje de invitación y el ID de solicitud de unión son identificadores diferentes y no son intercambiables.

​
Proteger los cambios en la membresía

Restablecer un enlace de invitación invalida el enlace anterior. Actualiza cualquier invitación o punto de distribución controlado que aún lo utilice; es posible que los destinatarios con el enlace antiguo ya no puedan unirse. Configura un endpoint de webhook de YCloud para recibir actualizaciones de ciclo de vida del grupo, participantes, configuraciones y estados. YCloud gestiona la suscripción relevante de la plataforma; tu aplicación aún debe verificar las firmas de los webhooks y gestionar eventos duplicados de forma segura. Mantenga un registro de auditoría de quién solicitó una acción, el grupo afectado, el ID de solicitud y el resultado final. No registre enlaces de invitación privados en paneles públicos.

​
Decidir si continuar

Utilice la guía de integración de grupos si las operaciones de gestión admitidas satisfacen sus necesidades. Si su requisito principal es la mensajería grupal bidireccional en YCloud Inbox o a través de Messages API, confirme la disponibilidad con YCloud antes de la implementación. No adquiera un compromiso con los clientes en torno a una funcionalidad no admitida.

​
Preguntas frecuentes

Espere el resultado final de la creación. El ID de solicitud no es el ID de grupo ni un enlace de invitación. Guarde la información del grupo del evento de ciclo de vida exitoso y, a continuación, envíe la invitación aprobada a los destinatarios individuales aptos.
La entrega solo confirma que la invitación llegó al destinatario. El cliente aún necesita abrir el enlace y decidir unirse; los grupos que requieren aprobación también necesitan un resultado de aprobación favorable. Compruebe la solicitud de unión y el evento de participante en lugar de considerar el estado de entrega de la invitación como membresía.
Primero verifique si el enlace fue restablecido. Un restablecimiento invalida el enlace anterior, por lo que debe usar el enlace actual y actualizar los puntos de distribución controlados. Si el enlace es el actual, compruebe si el grupo está lleno o si el participante fue eliminado anteriormente. Confirme el resultado del grupo y del participante antes de crear un grupo duplicado. Consulte las Preguntas frecuentes sobre grupos de Meta.
No dentro del alcance actual documentado de YCloud. Las conversaciones grupales no aparecen en Inbox, y los mensajes grupales salientes no son compatibles con Messages API. Los endpoints de gestión de grupos y los eventos grupales entrantes no establecen un producto completo de chat grupal bidireccional.
Meta aún puede entregar mensajes o eventos de estado que recibió antes de la eliminación. Esos eventos retrasados no significan que el grupo haya sido recreado. Conserve el ID de grupo y el resultado de la eliminación, procese los eventos históricos de forma segura y no reinicie las invitaciones basándose únicamente en un Webhook tardío. Consulte las Preguntas frecuentes sobre grupos de Meta.