# Eventos

> A agenda da comunidade, com eventos online, presenciais ou híbridos, endereço no mapa, inscrição, transmissão ao vivo por YouTube, Vimeo ou Mux, lembretes por e-mail e venda de ingresso.

O módulo **Eventos** organiza a agenda: lives, workshops, mentorias, encontros presenciais, conferências. Cada evento tem página própria com data, local, anfitriões, quem vai e, se for online, a transmissão.

## Para que serve

| Comunidade | Eventos |
|---|---|
| Escola online | A live semanal de dúvidas, transmitida pelo YouTube |
| Coworking | O happy hour mensal, presencial, com endereço no mapa |
| RH de empresa | O onboarding dos novos funcionários, híbrido |
| Associação | O congresso anual, com ingresso vendido |

## Como funciona

### O evento

| Campo | Para quê |
|---|---|
| **Título do Evento**, **Descrição** | O que é |
| **Tipo de Evento** | Livestream, Workshop, Webinar, Meetup, Mentoria, Conferência, Masterclass, Bootcamp, Networking, Painel, Mesa Redonda, Pitch, Demo Day, Ask Me Anything e outros |
| **Público-alvo** | Para quem é |
| **Formato do Evento** | **Online**, **Presencial** ou **Híbrido** |
| **Local do Evento** | Para presencial e híbrido: o endereço, buscado no mapa (*"Localização é obrigatória para eventos presenciais"*) |
| **Data e horário** de início e de término | Quando |
| **Imagem Principal (16:9)** e **Imagem Destacada (1:1)** | 2000×1125 px e 800×800 px recomendados |
| **Visibilidade** | **Público**, **Apenas Membros** ou **Privado** |
| **Organizadores** e **Anfitriões** | Quem organiza e quem apresenta |

### Inscrição

Na página do evento, cada membro confirma presença e fica como **Vai participar**, **Talvez vá** ou **Não vou participar**. A equipa vê a lista de participantes. Depois do evento, a página mostra *"Este evento já aconteceu"* e, para cada um, *"Você participou deste evento"*.

### Transmissão ao vivo

Para eventos online, quem organiza abre **Gerir Transmissão**:

1. Escolhe a **Plataforma de Streaming**: **YouTube**, **Vimeo** ou **Mux**.
2. Cola a **URL da Transmissão** (no YouTube, o link ou o ID do vídeo).
3. **Guardar URL**, para deixar pronto, ou **Guardar e Iniciar**, quando a live já está no ar.

Com a transmissão iniciada, a página mostra *"Transmissão acontecendo agora"* e **Ver em Direto**, e os membros assistem ali mesmo. **Parar Transmissão** encerra.

### E-mails

| Quando | E-mail |
|---|---|
| O membro se inscreve | Inscrição confirmada |
| **1 hora antes** do início | Lembrete |
| A transmissão começa | Aviso de que está ao vivo |
| O evento é cancelado | Cancelamento |

### Listas

O espaço separa **Próximos** e **Passados** e destaca o **Evento em Destaque**. Os eventos também aparecem no [Feed](/espacos/feed).

### Quem pode o quê

| Ação | Quem |
|---|---|
| Criar e editar evento | Moderador, administrador e proprietário (e o **Quem pode postar** do espaço) |
| Iniciar e parar a transmissão | Moderador, administrador e proprietário |
| Eliminar evento | Administrador e proprietário |
| Confirmar presença | Membro com acesso ao espaço |

## Passo a passo

### Criar um evento

*Papel: moderador, administrador ou proprietário.*

1. No espaço de Eventos, **Criar Evento**.
2. **Título do Evento**, **Descrição**, **Tipo de Evento** e **Público-alvo**.
3. **Formato do Evento**; para presencial ou híbrido, **Buscar endereço…** e escolha o local.
4. **Data de Início**, **Hora de Início**, **Data de Fim**, **Hora de Fim**.
5. As imagens.
6. **Visibilidade**, **Organizadores** e **Anfitriões**.
7. **Criar Evento**.

### Eliminar

*Papel: administrador ou proprietário.*

Menu do evento, **Eliminar Evento**, marque *"Confirmo que quero excluir este evento"*. Participantes e comentários vão junto.

## Vender ingresso

1. Crie um [produto](/monetizacao/produtos) avulso (o ingresso), com **Controlar Stock** para as vagas.
2. Ponha o espaço do evento como **Privada**, com o produto em **Quem tem acesso › Produtos**.
3. Quem compra entra no espaço e se inscreve no evento.

A inscrição continua a ser feita pela pessoa: comprar o ingresso libera o espaço, não inscreve automaticamente.

## Exemplos

**Live semanal.** Espaço **Lives** (Membros, **Equipa**). Toda terça, um evento Online, tipo Livestream, com a URL do YouTube salva antes e **Guardar e Iniciar** na hora.

**Happy hour do coworking.** Evento Presencial com o endereço da casa; os residentes se inscrevem e recebem o lembrete 1 hora antes.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| *Localização é obrigatória para eventos presenciais* | Busque e escolha o endereço |
| *Endereço não encontrado. Tente refinar sua busca.* | Escreva com número e cidade |
| O membro não vê **Criar Evento** | Criar evento é de moderador para cima |
| A transmissão não aparece | A live ainda não está ativa na plataforma, ou faltou **Guardar e Iniciar** |

## Perguntas frequentes

**Dá para repetir um evento toda semana?**
Não há recorrência: crie um evento para cada data.

**O chat ao vivo funciona?**
O chat da transmissão está a chegar (*"Chat em breve"*); por enquanto, a conversa vai nos comentários.

## Na API

`POST /api/events` (`spaceId`, `title`, `slug`, `type`, `startTime`, `endTime`, endereço, `streamingUrl`, `streamingService`), `PUT /api/events/{id}`, `POST /api/events/{id}/participate`, `GET /api/events/{id}/participants`, `POST /api/events/{id}/start-stream` e `stop-stream`. Ver [Events](/api/referencia/events).

## Relacionados

- [Feed](/espacos/feed)
- [Produtos](/monetizacao/produtos)
- [E-mails da plataforma](/notificacoes/emails-da-plataforma)