> ## Documentation Index > Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt > Use this file to discover all available pages before exploring further. # Cambiar Participante de Grupo de WhatsApp > La acción Cambiar Participante de Grupo de WhatsApp te permite agregar o eliminar un miembro de un grupo de WhatsApp automáticamente desde tus flujos de trabajo del CRM, sin gestión manual del grupo. > Por qué es importante: Mantener los grupos de WhatsApp actualizados a mano es lento y propenso a errores. Con esta acción puedes agregar automáticamente nuevos clientes a un grupo cuando convierten, o eliminarlos cuando cancelan o se dan de baja, todo activado por cualquier evento del CRM. *** ## Beneficios Clave[​](#beneficios-clave "Enlace directo al Beneficios Clave") **Membresía Automatizada** - Agrega o elimina miembros según eventos del CRM **Sin Gestión Manual del Grupo** - Deja de agregar y eliminar personas a mano **Integración con Flujos de Trabajo** - Combínalo con cualquier disparador del CRM para una automatización potente **Participantes Dinámicos** - Usa variables de contacto para apuntar a la persona correcta cada vez *** ## Quién Debería Usarlo[​](#quien-deberia-usarlo "Enlace directo al Quién Debería Usarlo") **Equipos de Ventas** - Agrega nuevos clientes a un grupo VIP en el momento en que convierten **Equipos de Soporte** - Elimina miembros de un grupo una vez que se cierra su caso **Agencias** - Mantén los grupos de comunidad de clientes sincronizados con tu CRM automáticamente **Creadores de Cursos** - Agrega estudiantes a un grupo de cohorte al inscribirse, elimínalos al finalizar *** ## Cómo Configurarlo[​](#como-configurarlo "Enlace directo al Cómo Configurarlo") ### Paso 1: Agregar la Acción[​](#paso-1-agregar-la-accion "Enlace directo al Paso 1: Agregar la Acción") Ve a **Automatización → Flujos de Trabajo** Crea un nuevo flujo de trabajo o edita uno existente Agrega el disparador que desees (Formulario Enviado, Etiqueta Agregada, Cita Reservada, etc.) Haz clic en **+** para agregar una nueva acción y selecciona **Cambiar Participante de Grupo de WhatsApp** ### Paso 2: Configurar la Acción[​](#paso-2-configurar-la-accion "Enlace directo al Paso 2: Configurar la Acción") | Campo | Requerido | Descripción | | ----------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre de la Acción** | No | Una etiqueta para este paso en tu flujo de trabajo | | **Acción** | Sí | Elige **Agregar** o **Eliminar** | | **Grupo** | Sí | Selecciona un grupo de WhatsApp o usa el Selector de Valores Personalizados. Puedes agregar nuevos grupos desde el panel de configuración de WhatsApp | | **Participante** | Sí | El número de teléfono del miembro a agregar o eliminar | Configuración de la acción Cambiar Participante de Grupo de WhatsApp **El número del participante debe incluir el código de país.** Ingresa siempre el número de teléfono en formato internacional completo con el código de país (por ejemplo, `+14155552671`), o inserta el valor personalizado `{{contact.raw_phone}}` usando el ícono de etiqueta. Un número sin código de país — o un campo con formato como `{{contact.phone}}` que pueda omitirlo — no coincidirá con un usuario de WhatsApp, y el participante no será agregado ni eliminado. ### Paso 3: Guardar y Publicar[​](#paso-3-guardar-y-publicar "Enlace directo al Paso 3: Guardar y Publicar") Haz clic en **Guardar acción** Revisa tu flujo de trabajo completo Cambia de **Borrador** a **Publicado** *** ## Explicación de los Campos de la Acción[​](#explicacion-de-los-campos-de-la-accion "Enlace directo al Explicación de los Campos de la Acción") ### Campo Acción[​](#campo-accion "Enlace directo al Campo Acción") Elige qué debe suceder con el participante: * **Agregar** - Agrega el participante al grupo seleccionado * **Eliminar** - Elimina el participante del grupo seleccionado ### Campo Grupo[​](#campo-grupo "Enlace directo al Campo Grupo") Selecciona el grupo de destino en el menú desplegable o usa el Selector de Valores Personalizados para definirlo dinámicamente. Si tu grupo no aparece en la lista, agrégalo primero desde el **panel de configuración de WhatsApp**. ### Campo Participante[​](#campo-participante "Enlace directo al Campo Participante") Ingresa el número de teléfono de la persona a agregar o eliminar. Debe ser un **número de WhatsApp válido en formato internacional completo**, incluyendo el código de país. **Valores recomendados:** * Un número completo con código de país, p. ej. `+14155552671` * El valor personalizado `{{contact.raw_phone}}` — almacena el número en formato internacional sin procesar, incluido el código de país No ingreses un número local sin el código de país. WhatsApp identifica a los usuarios por su número internacional completo, por lo que la falta del código de país significa que la acción no puede encontrar a la persona y no hace nada silenciosamente. *** ## Salida de la Acción y Filtros[​](#salida-de-la-accion-y-filtros "Enlace directo al Salida de la Acción y Filtros") Después de ejecutarse, la acción devuelve los siguientes valores. Puedes referenciarlos en pasos posteriores o ramificar en base a ellos con un paso **Si/Entonces** para crear automatizaciones confiables. | Filtro | Tipo | Descripción | | ---------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Código de Estado de la Acción** | Número | El código de resultado devuelto por WhatsApp (ver la tabla a continuación). Úsalo para ramificar tu flujo de trabajo — por ejemplo, enviar un enlace de invitación en `408` | | **¿Miembro Agregado?** | Booleano | `true` o `false` — si el miembro terminó agregado al grupo | | **Número de Teléfono del Miembro** | Texto | El número del participante sobre el que actuó la acción | | **Mensaje** | Texto | Una descripción legible del resultado | ### Códigos de Estado de la Acción[​](#codigos-de-estado-de-la-accion "Enlace directo al Códigos de Estado de la Acción") Usa el **Código de Estado de la Acción** en un filtro Si/Entonces para reaccionar a cada resultado. | Código de Estado | Significado | Mensaje (Agregar) | Mensaje (Eliminar) | Qué significa / qué hacer | | ---------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **200** | Éxito | Agregado correctamente | Eliminado correctamente | Listo. | | **403** | Prohibido | No permitido — el usuario puede haber bloqueado esta cuenta o no está disponible | No permitido — permisos insuficientes para eliminar a este participante | **Agregar:** el usuario objetivo bloqueó al remitente o tiene privacidad estricta — intenta con un enlace de invitación. **Eliminar:** normalmente significa que el objetivo es administrador/creador y no puede ser eliminado por alguien que no es creador. | | **404** | Número no está en WhatsApp | El número de teléfono no está en WhatsApp | El número de teléfono no está en WhatsApp | Verifica el número. Este es un fallo definitivo — ningún reintento ayudará. | | **408** | Restricciones de privacidad | No se puede agregar directamente debido a la configuración de privacidad — envía un enlace de invitación en su lugar | *(n/a — solo ocurre al agregar)* | El contacto no puede agregarse directamente. Envíale un **mensaje de WhatsApp con el enlace de invitación al grupo** para que pueda unirse por sí mismo. | | **409** | Ya está / no está en el grupo | Ya está en el grupo | No está en el grupo | Señal de idempotencia — es seguro tratarlo como éxito en la mayoría de los flujos de trabajo. | ### Manejo de altas restringidas por privacidad (enlaces de invitación)[​](#manejo-de-altas-restringidas-por-privacidad-enlaces-de-invitacion "Enlace directo al Manejo de altas restringidas por privacidad (enlaces de invitación)") Algunos contactos no pueden agregarse directamente a un grupo debido a su configuración de privacidad de WhatsApp. Cuando esto sucede, la acción devuelve **`408`** (o **`403`** al agregar). En lugar de tratarlo como un fallo, ramifica según el código de estado y envíales un mensaje de WhatsApp con el enlace de invitación al grupo para que puedan unirse por sí mismos: Agrega un paso **Si/Entonces** después de esta acción y verifica si el **Código de Estado de la Acción** es `408` (o `403`). En esa rama, agrega una acción **Enviar Mensaje de WhatsApp** y envía al contacto un mensaje que incluya el **enlace de invitación** de tu grupo, para que pueda tocarlo y unirse por su cuenta. Opcionalmente, etiqueta al contacto (p. ej. `invitacion-enviada`) para hacer seguimiento más tarde. *** ## Limitaciones[​](#limitaciones "Enlace directo al Limitaciones") Ten en cuenta las siguientes restricciones al usar esta acción: * **Solo agregar y eliminar.** Esta acción no puede promover ni degradar a un participante a administrador — solo maneja agregar y eliminar miembros. Si necesitas cambios de rol, [avísanos](#soporte) para que se agregue promover/degradar. * **Los contenedores de comunidad son rechazados.** Las comunidades son metacontenedores. Agregar/eliminar opera sobre los subgrupos vinculados (el grupo de anuncios o de discusión), no sobre la comunidad en sí. * **Los grupos de solo anuncios son compatibles.** Los administradores aún pueden agregar y eliminar participantes normalmente. La marca de solo anuncios solo restringe *quién puede enviar mensajes* — no restringe la gestión de la membresía. * **Límites de frecuencia.** WhatsApp puede limitar operaciones repetidas de participantes en el mismo grupo. Espacia los cambios masivos. *** ## Casos de Uso de Ejemplo[​](#casos-de-uso-de-ejemplo "Enlace directo al Casos de Uso de Ejemplo") ### Caso de Uso 1: Agregar Nuevos Clientes a un Grupo VIP[​](#caso-de-uso-1 "Enlace directo al Caso de Uso 1: Agregar Nuevos Clientes a un Grupo VIP") **Disparador:** Etiqueta Agregada — `cliente` **Acción:** Cambiar Participante de Grupo de WhatsApp * **Acción:** Agregar * **Grupo:** Clientes VIP * **Participante:** `{{contact.raw_phone}}` ### Caso de Uso 2: Eliminar Miembros Cuando Cancelan[​](#caso-de-uso-2 "Enlace directo al Caso de Uso 2: Eliminar Miembros Cuando Cancelan") **Disparador:** Etiqueta Agregada — `cancelado` **Acción:** Cambiar Participante de Grupo de WhatsApp * **Acción:** Eliminar * **Grupo:** Clientes VIP * **Participante:** `{{contact.raw_phone}}` *** ## Preguntas Frecuentes[​](#preguntas-frecuentes "Enlace directo al Preguntas Frecuentes") Usa siempre el formato internacional completo con el código de país — por ejemplo, `+14155552671`. La opción más fácil y confiable es insertar el valor personalizado **`{{contact.raw_phone}}`**, que ya almacena el número con su código de país. Un número ingresado sin código de país no coincidirá con un usuario de WhatsApp y la acción fallará. Recomendamos **`{{contact.raw_phone}}`**. Dependiendo de cómo se creó un contacto, `{{contact.phone}}` puede estar formateado o almacenado sin el código de país, lo que hace que la coincidencia del participante falle. `{{contact.raw_phone}}` mantiene el número en formato internacional completo. La causa más común es un número de teléfono sin código de país. Asegúrate de que el campo Participante use un número internacional completo (p. ej. `+14155552671`) o `{{contact.raw_phone}}`. Confirma también que tu número de WhatsApp esté conectado y que el grupo esté disponible en tu configuración de WhatsApp. Los grupos deben estar agregados y disponibles primero en tu panel de configuración de WhatsApp. Agrega el grupo allí, luego vuelve al flujo de trabajo y actualiza. La acción fallará al ejecutarse. Recomendamos configurar el disparador **WhatsApp Desconectado** para recibir alertas cuando tu número quede fuera de línea. *** ## Soporte[​](#soporte "Enlace directo al Soporte") Si necesitas ayuda con la configuración o la incorporación: * Correo: [**support@messagesync.ai**](mailto:support@messagesync.ai)