```meta
title: @event — um momento para pôr na agenda
description: A data, a hora, quanto dura e onde, impressos, com um link para o Google Agenda e um arquivo .ics para Apple e Outlook.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @event

Um momento para pôr na agenda: a data e a hora, quanto dura, onde — impressos, com um link para o Google Agenda e um arquivo .ics para Apple e Outlook.

## Ao vivo

```@event to:2027-03-15T19:00-03:00 duration:120 title:"Abertura da loja do Ateliê Exemplo" where:"Rua das Acácias, 120 — Porto Azul" details:"Traga um amigo; tem café." zone:America/Sao_Paulo
```

~~~text
```@event to:2027-03-15T19:00-03:00 duration:120 title:"Abertura da loja do Ateliê Exemplo" where:"Rua das Acácias, 120 — Porto Azul" details:"Traga um amigo; tem café." zone:America/Sao_Paulo
```
~~~

## Uma chamada

Quando o lugar é um endereço `https://`, ele vira o link da chamada.

```@event to:2027-03-22T10:00-03:00 duration:30 title:"Conversa de boas-vindas" where:https://meet.example.com/boas-vindas zone:America/Sao_Paulo
```

~~~text
```@event to:2027-03-22T10:00-03:00 duration:30 title:"Conversa de boas-vindas" where:https://meet.example.com/boas-vindas zone:America/Sao_Paulo
```
~~~

## Argumentos

- `to` e `title` — quando começa e como se chama. São obrigatórios.
- `duration` — em minutos, de 5 a 1440 (60 se não disser).
- `where` — um lugar, ou o endereço da chamada.
- `details` — uma linha para as notas do evento na agenda.
- `zone` — o fuso em que a hora é impressa (`America/Sao_Paulo`). Sem ele, UTC.

Com `members_of:"um grupo"`, o evento só aparece — na página e no calendário de cada um — para os membros do grupo.