Boas-vindas da comunidade
As telas que a pessoa nova vê no primeiro acesso (texto, vídeo, regras para aceitar e campos do perfil), o modo obrigatório ou pulável, quem passa por elas, e os Primeiros passos, com até 6 missões, pontos, badges e parabéns no fim.
As boas-vindas são as telas que a pessoa nova vê no primeiro acesso, antes da comunidade: um texto de apresentação, o vídeo de boas-vindas, as regras para ler e aceitar, os campos do perfil que a comunidade quer conhecer. Depois delas vêm os Primeiros passos, um cartão com até 6 missões (completar o perfil, fazer a primeira publicação, ir ao primeiro evento) que se cumprem sozinhas pelo uso e podem dar pontos e badges.
Onde fica: em Configurações › Boas-vindas, para o proprietário e o administrador.
Para que serve
| Comunidade | Como usa |
|---|---|
| Comunidade com código de conduta | A primeira tela traz as regras com Li e aceito; ninguém entra sem aceitar, e o aceite fica registrado com a data e o texto |
| Escola online | Um vídeo de boas-vindas que precisa ser assistido até o fim, e uma missão "Conclua a aula inaugural" |
| Comunidade profissional | Uma tela pede cargo, empresa e interesses (campos customizados); as missões levam à primeira apresentação no Feed e ao primeiro evento |
| Comunidade aberta | Boas-vindas puláveis: quem tem pressa entra direto, e o cartão dos Primeiros passos fica no Feed |
Quem pode
| Papel | O que faz |
|---|---|
| Proprietário e administrador | Configuram as telas, o modo, os Primeiros passos e veem quantos concluíram, pularam ou estão pendentes |
| Moderador e financeiro | Filtram a lista de membros pelo estado das boas-vindas; não mudam a configuração |
| Membro | Passa pelas boas-vindas e vê o próprio cartão dos Primeiros passos |
A equipe (proprietário, administrador, moderador e financeiro) nunca passa pelas boas-vindas nem vê o cartão dos Primeiros passos.
Como funciona
As telas
De 1 a 5 telas, na ordem em que a pessoa vai vê-las. Cada tela tem:
- Título (até 120 caracteres) e texto, com formatação.
- Vídeo, opcional: Sem vídeo, Enviar vídeo (até 2 GB) ou Link do YouTube ou Vimeo. Só o vídeo enviado pode ter Continuar só depois de assistir até o fim; com link externo, não dá para exigir.
- Regras, opcional: em Pedir o aceite das regras, o texto das regras, uma por linha. A pessoa só continua marcando Li e aceito as regras. O aceite fica guardado com a data e o texto aceito naquele momento, mesmo que as regras mudem depois.
- Campos do perfil, opcional: até 20 campos customizados por tela, com as mesmas validações do perfil. Um campo obrigatório precisa ser preenchido para seguir.
A pessoa vê as telas na ordem (Passo 1 de 3), com Continuar e, na última, Entrar na comunidade; se sair no meio, volta de onde parou. Ver como membro mostra as telas como um membro novo vê, sem registrar nada.
O modo
| Modo | O que acontece |
|---|---|
| Obrigatória (o padrão) | A comunidade fica bloqueada até a pessoa concluir a última tela |
| Pode pular | A pessoa vê Pular boas-vindas; quem pula entra e não é chamado de novo |
As boas-vindas aparecem antes de Complete seu cadastro (ver Cadastro e entrada): se ainda faltar um campo obrigatório depois delas, a janela de cadastro vem em seguida.
Quem passa
Ao ligar as boas-vindas, você escolhe se elas valem também para quem já é membro:
- Desmarcado (o padrão): passam só os membros que entrarem a partir de agora.
- Aplicar também a quem já é membro: todo membro passa no próximo acesso.
Desligar libera na hora quem estava pendente. Religar não alcança quem entrou enquanto as boas-vindas estavam desligadas: a contagem recomeça no momento em que você religa, a menos que Aplicar também a quem já é membro esteja marcado. Quem já concluiu ou pulou nunca é chamado de novo.
Primeiros passos
Na mesma tela, abaixo das telas, os Primeiros passos: de 1 a 6 missões, cada uma com o texto que aparece no cartão (Como aparece no cartão, até 80 caracteres) e, em Quando a pessoa, uma ação que a plataforma já acompanha:
| Quando a pessoa | Cumpre quando ela… |
|---|---|
| Completa o perfil | tem foto e todos os campos obrigatórios preenchidos |
| Publica pela primeira vez num espaço | publica no espaço escolhido |
| Responde um formulário | responde o formulário escolhido |
| Se inscreve num evento | se inscreve num evento (Qualquer evento, ou o escolhido) |
| Conclui um curso | conclui o curso escolhido |
- Cada missão pode dar pontos (de 0 a 10.000, com a gamificação ligada) e um badge (ver Badges). Concluir todas pode dar um badge final (Badge ao concluir todas).
- A missão é marcada em até cerca de 1 minuto depois da ação, sem a pessoa fazer nada. A de perfil também é conferida quando o cartão abre.
- O que foi feito antes de a missão existir não conta. Trocar a ação ou o item de uma missão também recomeça a contagem dela; mudar só o título, os pontos ou o badge mantém quem já cumpriu.
- Valem para os membros que entrarem depois de ligar os Primeiros passos, ou para todos com Mostrar a quem já é membro.
O cartão. A pessoa vê o cartão Primeiros passos, com o progresso (2 de 4) e os pontos de cada missão, no topo da coluna do Feed (mesmo com os widgets desligados) e na própria página de membro, depois das boas-vindas. Ao concluir todas, vê os parabéns uma vez só, recebe o badge final e o cartão some. Dispensar esconde o cartão para sempre, e a partir daí nenhuma missão conta.
Acompanhar
A configuração mostra quantos membros concluíram, pularam e estão pendentes nas boas-vindas e, nos Primeiros passos, quantos começaram (cumpriram pelo menos uma missão), concluíram e dispensaram, com quantos cumpriram cada missão.
Na lista de membros, a equipe usa o filtro Boas-vindas (Pendente, Concluída ou Pulada). A página de cada membro mostra à equipe o bloco Boas-vindas e primeiros passos, com o estado das boas-vindas e o progresso nas missões.
Automatizar com workflows
Dois gatilhos de workflow no bloco Membros:
- Concluiu as boas-vindas: a pessoa concluiu a última tela. Pular não dispara.
- Concluiu os primeiros passos: a pessoa cumpriu todas as missões, uma vez por pessoa.
Os dois chegam também aos webhooks.
Passo a passo
Boas-vindas com regras e vídeo
Papel: proprietário ou administrador.
- Abra Configurações › Boas-vindas.
- Na Tela 1, dê o título Bem-vinda à comunidade, um texto curto e, em Vídeo, Enviar vídeo, com Continuar só depois de assistir até o fim.
- Adicionar tela: na Tela 2, marque Pedir o aceite das regras, escreva as regras e escolha os campos Cargo e Empresa em Campos do perfil.
- Em Para o membro, deixe Obrigatória. Ligue Boas-vindas ligadas e decida se marca Aplicar também a quem já é membro.
- Confira em Ver como membro e salve.
Primeiros passos com badge final
- Na mesma tela, ligue os Primeiros passos e use Adicionar missão: Complete seu perfil (Completa o perfil, 50 pontos), Apresente-se no Feed (Publica pela primeira vez num espaço, espaço Apresentações, 50 pontos) e Inscreva-se no próximo encontro (Se inscreve num evento, Qualquer evento).
- Em Badge ao concluir todas, escolha Pioneiro, decida sobre Mostrar a quem já é membro e salve.
Exemplo
A Maria entra na comunidade. Antes de ver qualquer espaço, assiste ao vídeo até o fim, aceita as regras e preenche Cargo. No Feed, encontra o cartão Primeiros passos · 0 de 3. Ela completa o perfil e publica a apresentação: em cerca de 1 minuto o cartão mostra 2 de 3 e ela tem 100 pontos. Na semana seguinte, inscreve-se num encontro, vê os parabéns, ganha o badge Pioneiro, e o workflow com Concluiu os primeiros passos a coloca no grupo Membros ativos.
Erros comuns e como resolver
| Situação | O que fazer |
|---|---|
| Liguei as boas-vindas e quem já era membro não passou por elas | É o padrão. Marque Aplicar também a quem já é membro |
| Não consigo exigir que o vídeo seja assistido até o fim | Só o vídeo enviado permite; com link do YouTube ou do Vimeo, não |
| Religuei e quem entrou com elas desligadas não passou | Religar só vale para quem entra a partir dali; marque Aplicar também a quem já é membro |
| A missão não marcou | Espere cerca de 1 minuto. Confira se a ação foi no espaço, formulário ou curso escolhido e se foi depois de a missão existir |
| A missão de perfil não marca | Falta a foto ou algum campo obrigatório do perfil |
| A missão não deu pontos | A gamificação precisa estar ligada |
| Não consigo ligar sem nenhuma tela (ou missão) | É preciso ao menos uma tela para ligar as boas-vindas, e uma missão para ligar os Primeiros passos |
Perguntas frequentes
A equipe passa pelas boas-vindas? Não. Proprietário, administrador, moderador e financeiro entram direto e não veem o cartão dos Primeiros passos.
A pessoa pode voltar a ver as boas-vindas? Não: depois de concluir ou pular, ela não é chamada de novo, mesmo que você mude as telas.
Preciso marcar as missões à mão? Não. Cada missão se cumpre pelo uso, em até cerca de 1 minuto.
O membro pode ignorar o cartão? Pode dispensá-lo. Ele some para sempre, e as missões deixam de contar para essa pessoa.
Na API
GET e PUT /api/welcome/settings (proprietário e administrador; os outros papéis recebem 403): as telas (screens, de 1 a 5, com title, body, video com mediaId e requireFinish ou url, rules.text e fieldIds), mode (REQUIRED, o padrão, ou SKIPPABLE), enabled e applyToExisting, com stats (completed, skipped, pending). Os Primeiros passos vão na mesma rota: missionsEnabled, missionsShowExisting, finalBadgeId e missions (de 1 a 6, com kind profile_completed, first_post com spaceId, form_submitted com formId, event_registered com eventId opcional ou course_completed com courseId, title, points de 0 a 10.000 e badgeId opcional), com missionStats. Erro de validação volta com 422 no campo (screens[0].title, missions[1].spaceId).
Para a própria pessoa (qualquer papel): GET /api/welcome (o estado, off, exempt, pending, completed ou skipped, a tela atual e as telas), POST /api/welcome/progress (conclui a tela atual: step, rulesAccepted, videoFinished e fields; tela fora de ordem volta 409) e POST /api/welcome/skip (só no modo pulável; senão 409). O cartão: GET /api/welcome/missions (status off, exempt, active, completed ou dismissed, visible, celebrate, done de total e as missões), POST /api/welcome/missions/dismiss e POST /api/welcome/missions/celebrated (os parabéns foram mostrados).
GET /auth/me traz welcomePending. GET /api/members filtra com welcome=pending|completed|skipped, e GET /api/members/{id} traz welcome, com missions. Os eventos member.welcome_completed (member, completedAt) e member.onboarding_completed (member, completedAt e missions, o número de missões) chegam aos workflows e aos webhooks. Ver a Referência da API.
Pelo assistente (MCP)
Peça para ver ou mudar as boas-vindas e as missões ("ligue as boas-vindas obrigatórias com uma tela de regras"): get_welcome_settings e update_welcome_settings, que sempre pede confirmação. Quem está pendente: list_members com welcome: pending; o progresso de alguém: get_member.