Bienvenida de la comunidad
Las pantallas que la persona nueva ve en su primer acceso (texto, vídeo, normas para aceptar y campos del perfil), el modo obligatorio u omitible, quién pasa por ellas, y los Primeros pasos, con hasta 6 misiones, puntos, insignias y felicitación al final.
La bienvenida son las pantallas que la persona nueva ve en su primer acceso, antes de la comunidad: un texto de presentación, el vídeo de bienvenida, las normas para leer y aceptar, los campos del perfil que la comunidad quiere conocer. Después vienen los Primeros pasos, una tarjeta con hasta 6 misiones (completar el perfil, hacer la primera publicación, ir al primer evento) que se cumplen solas con el uso y pueden dar puntos e insignias.
Dónde está: en Configuración › Bienvenida, para el propietario y el administrador.
Para qué sirve
| Comunidad | Cómo la usa |
|---|---|
| Comunidad con código de conducta | La primera pantalla muestra las normas con He leído y acepto; nadie entra sin aceptar, y la aceptación queda registrada con la fecha y el texto |
| Escuela online | Un vídeo de bienvenida que hay que ver hasta el final, y una misión "Completa la clase inaugural" |
| Comunidad profesional | Una pantalla pide cargo, empresa e intereses (campos personalizados); las misiones llevan a la primera presentación en el Feed y al primer evento |
| Comunidad abierta | Bienvenida omitible: quien tiene prisa entra directamente, y la tarjeta de los Primeros pasos queda en el Feed |
Quién puede
| Rol | Qué hace |
|---|---|
| Propietario y administrador | Configuran las pantallas, el modo y los Primeros pasos, y ven cuántos completaron, omitieron o están pendientes |
| Moderador y finanzas | Filtran la lista de miembros por el estado de la bienvenida; no cambian la configuración |
| Miembro | Pasa por la bienvenida y ve su propia tarjeta de los Primeros pasos |
El equipo (propietario, administrador, moderador y finanzas) nunca pasa por la bienvenida ni ve la tarjeta de los Primeros pasos.
Cómo funciona
Las pantallas
De 1 a 5 pantallas, en el orden en que la persona las verá. Cada pantalla tiene:
- Título (hasta 120 caracteres) y texto, con formato.
- Vídeo, opcional: Sin video, Subir video (hasta 2 GB) o Enlace de YouTube o Vimeo. Solo el vídeo subido puede tener Continuar solo después de verlo hasta el final; con un enlace externo, no se puede exigir.
- Normas, opcional: en Pedir la aceptación de las reglas, el texto de las normas, una por línea. La persona solo continúa marcando He leído y acepto las reglas. La aceptación se guarda con la fecha y el texto aceptado en ese momento, aunque las normas cambien después.
- Campos del perfil, opcional: hasta 20 campos personalizados por pantalla, con las mismas validaciones del perfil. Un campo obligatorio debe rellenarse para seguir.
La persona ve las pantallas en orden (Paso 1 de 3), con Continuar y, en la última, Entrar en la comunidad; si sale a mitad, vuelve donde lo dejó. Ver como miembro muestra las pantallas como las ve un miembro nuevo, sin registrar nada.
El modo
| Modo | Qué pasa |
|---|---|
| Obligatoria (el predeterminado) | La comunidad queda bloqueada hasta que la persona complete la última pantalla |
| Se puede saltar | La persona ve Saltar la bienvenida; quien la salta entra y no se le vuelve a pedir |
La bienvenida aparece antes de Completa tu registro (ver Registro y acceso): si después sigue faltando un campo obligatorio, la ventana de registro viene a continuación.
Quién pasa
Al activar la bienvenida, eliges si vale también para quien ya es miembro:
- Desmarcado (el predeterminado): pasan solo los miembros que entren a partir de ahora.
- Aplicar también a quien ya es miembro: todos los miembros pasan en su próximo acceso.
Desactivarla deja entrar al momento a quien estaba pendiente. Reactivarla no alcanza a quien entró mientras estaba desactivada: la cuenta empieza de nuevo cuando la reactivas, salvo que Aplicar también a quien ya es miembro esté marcado. A quien ya completó u omitió nunca se le vuelve a pedir.
Primeros pasos
En la misma pantalla, debajo de las pantallas, los Primeros pasos: de 1 a 6 misiones, cada una con el texto que aparece en la tarjeta (Cómo aparece en la tarjeta, hasta 80 caracteres) y, en Cuando la persona, una acción que la plataforma ya sigue:
| Cuando la persona | Se cumple cuando… |
|---|---|
| Completa el perfil | tiene foto y todos los campos obligatorios rellenados |
| Publica por primera vez en un espacio | publica en el espacio elegido |
| Responde un formulario | responde el formulario elegido |
| Se inscribe en un evento | se inscribe en un evento (Cualquier evento, o el elegido) |
| Completa un curso | completa el curso elegido |
- Cada misión puede dar puntos (de 0 a 10.000, con la gamificación activada) y una insignia (ver Insignias). Completarlas todas puede dar una insignia final (Insignia al completar todas).
- La misión se marca en aproximadamente 1 minuto como máximo después de la acción, sin que la persona haga nada. La del perfil también se comprueba al abrir la tarjeta.
- Lo que se hizo antes de que existiera la misión no cuenta. Cambiar la acción o el elemento de una misión también reinicia su cuenta; cambiar solo el título, los puntos o la insignia mantiene a quien ya la cumplió.
- Valen para los miembros que entren después de activar los Primeros pasos, o para todos con Mostrar a quien ya es miembro.
La tarjeta. La persona ve la tarjeta Primeros pasos, con el progreso (2 de 4) y los puntos de cada misión, arriba en la columna del Feed (aunque los widgets estén desactivados) y en su propia página de miembro, después de la bienvenida. Al completarlas todas, ve la felicitación una sola vez, recibe la insignia final y la tarjeta desaparece. Descartar oculta la tarjeta para siempre, y desde entonces ninguna misión cuenta.
Seguimiento
La configuración muestra cuántos miembros completaron, omitieron o están pendientes en la bienvenida y, en los Primeros pasos, cuántos empezaron (cumplieron al menos una misión), completaron y descartaron, con cuántos cumplieron cada misión.
En la lista de miembros, el equipo usa el filtro Bienvenida (Pendiente, Completada o Saltada). La página de cada miembro muestra al equipo el bloque Bienvenida y primeros pasos, con el estado de la bienvenida y el progreso en las misiones.
Automatizar con workflows
Dos disparadores de workflow en el bloque Miembros:
- Completó la bienvenida: la persona completó la última pantalla. Omitirla no lo dispara.
- Completó los primeros pasos: la persona cumplió todas las misiones, una vez por persona.
Los dos llegan también a los webhooks.
Paso a paso
Bienvenida con normas y vídeo
Rol: propietario o administrador.
- Abre Configuración › Bienvenida.
- En la Pantalla 1, pon el título Bienvenida a la comunidad, un texto corto y, en Video, Subir video, con Continuar solo después de verlo hasta el final.
- Agregar pantalla: en la Pantalla 2, marca Pedir la aceptación de las reglas, escribe las normas y elige los campos Cargo y Empresa en Campos del perfil.
- En Para el miembro, deja Obligatoria. Activa Bienvenida activada y decide si marcas Aplicar también a quien ya es miembro.
- Compruébalo en Ver como miembro y guarda.
Primeros pasos con insignia final
- En la misma pantalla, activa los Primeros pasos y usa Agregar misión: Completa tu perfil (Completa el perfil, 50 puntos), Preséntate en el Feed (Publica por primera vez en un espacio, espacio Presentaciones, 50 puntos) e Inscríbete en el próximo encuentro (Se inscribe en un evento, Cualquier evento).
- En Insignia al completar todas, elige Pionera, decide sobre Mostrar a quien ya es miembro y guarda.
Ejemplo
María entra en la comunidad. Antes de ver ningún espacio, ve el vídeo hasta el final, acepta las normas y rellena Cargo. En el Feed encuentra la tarjeta Primeros pasos · 0 de 3. Completa el perfil y publica su presentación: en aproximadamente 1 minuto la tarjeta muestra 2 de 3 y tiene 100 puntos. La semana siguiente se inscribe en un encuentro, ve la felicitación, gana la insignia Pionera, y el workflow con Completó los primeros pasos la añade al grupo Miembros activos.
Errores frecuentes y cómo resolverlos
| Situación | Qué hacer |
|---|---|
| Activé la bienvenida y quien ya era miembro no pasó por ella | Es lo predeterminado. Marca Aplicar también a quien ya es miembro |
| No puedo exigir que el vídeo se vea hasta el final | Solo el vídeo subido lo permite; con un enlace de YouTube o de Vimeo, no |
| La reactivé y quien entró con ella desactivada no pasó | Reactivar solo vale para quien entra desde entonces; marca Aplicar también a quien ya es miembro |
| La misión no se marcó | Espera aproximadamente 1 minuto. Comprueba que la acción fue en el espacio, formulario o curso elegido y después de que existiera la misión |
| La misión del perfil no se marca | Falta la foto o algún campo obligatorio del perfil |
| La misión no dio puntos | La gamificación tiene que estar activada |
| No puedo activarla sin ninguna pantalla (o misión) | Hace falta al menos una pantalla para activar la bienvenida, y una misión para activar los Primeros pasos |
Preguntas frecuentes
¿El equipo pasa por la bienvenida? No. Propietario, administrador, moderador y finanzas entran directamente y no ven la tarjeta de los Primeros pasos.
¿La persona puede volver a ver la bienvenida? No: después de completarla u omitirla, no se le vuelve a pedir, aunque cambies las pantallas.
¿Tengo que marcar las misiones a mano? No. Cada misión se cumple con el uso, en aproximadamente 1 minuto.
¿El miembro puede ignorar la tarjeta? Puede descartarla. Desaparece para siempre, y las misiones dejan de contar para esa persona.
En la API
GET y PUT /api/welcome/settings (propietario y administrador; los demás roles reciben 403): las pantallas (screens, de 1 a 5, con title, body, video con mediaId y requireFinish o url, rules.text y fieldIds), mode (REQUIRED, el predeterminado, o SKIPPABLE), enabled y applyToExisting, con stats (completed, skipped, pending). Los Primeros pasos van en la misma ruta: missionsEnabled, missionsShowExisting, finalBadgeId y missions (de 1 a 6, con kind profile_completed, first_post con spaceId, form_submitted con formId, event_registered con eventId opcional o course_completed con courseId, title, points de 0 a 10.000 y badgeId opcional), con missionStats. Un error de validación vuelve con 422 en el campo (screens[0].title, missions[1].spaceId).
Para la propia persona (cualquier rol): GET /api/welcome (el estado, off, exempt, pending, completed o skipped, la pantalla actual y las pantallas), POST /api/welcome/progress (completa la pantalla actual: step, rulesAccepted, videoFinished y fields; una pantalla fuera de orden devuelve 409) y POST /api/welcome/skip (solo en el modo omitible; si no, 409). La tarjeta: GET /api/welcome/missions (status off, exempt, active, completed o dismissed, visible, celebrate, done de total y las misiones), POST /api/welcome/missions/dismiss y POST /api/welcome/missions/celebrated (la felicitación se mostró).
GET /auth/me trae welcomePending. GET /api/members filtra con welcome=pending|completed|skipped, y GET /api/members/{id} trae welcome, con missions. Los eventos member.welcome_completed (member, completedAt) y member.onboarding_completed (member, completedAt y missions, el número de misiones) llegan a los workflows y a los webhooks. Ver la Referencia de la API.
Por el asistente (MCP)
Pide ver o cambiar la bienvenida y las misiones ("activa la bienvenida obligatoria con una pantalla de reglas"): get_welcome_settings y update_welcome_settings, que siempre pide confirmación. Quién está pendiente: list_members con welcome: pending; el progreso de alguien: get_member.