# 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](/membros/campos-customizados) 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](/membros/cadastro-e-entrada#el-registro)): 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](/espacos/formularios) 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](/membros/gamificacao) activada) y una **insignia** (ver [Insignias](/membros/engajamento#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](/membros/gerenciar-membros), 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](/notificacoes/workflows) 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](/api/eventos-de-webhook).

## Paso a paso

### Bienvenida con normas y vídeo

*Rol: propietario o administrador.*

1. Abre **Configuración › Bienvenida**.
2. 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**.
3. **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**.
4. En **Para el miembro**, deja **Obligatoria**. Activa **Bienvenida activada** y decide si marcas **Aplicar también a quien ya es miembro**.
5. Compruébalo en **Ver como miembro** y guarda.

### Primeros pasos con insignia final

1. 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**).
2. 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](/membros/gamificacao) 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](/api/referencia).

## 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`](/mcp/ferramentas-membros#get-welcome-settings) y [`update_welcome_settings`](/mcp/ferramentas-membros#update-welcome-settings), que siempre pide confirmación. Quién está pendiente: [`list_members`](/mcp/ferramentas-membros#list-members) con `welcome: pending`; el progreso de alguien: [`get_member`](/mcp/ferramentas-membros#get-member).

## Relacionados

- [Registro y acceso](/membros/cadastro-e-entrada)
- [Campos personalizados](/membros/campos-customizados)
- [Gamificación](/membros/gamificacao)
- [Participación e insignias](/membros/engajamento#insignias)
- [Workflows](/notificacoes/workflows)