URLs para criação de eventos
O WhenToMeet permite preencher formulários de criação de eventos usando parâmetros na URL. Esse recurso é útil para criar links rápidos com configurações pré-definidas.
Uso básico
Você pode criar URLs que preenchem automaticamente o formulário de criação de evento com valores específicos. É especialmente útil para:
- Criar links rápidos para eventos recorrentes
- Compartilhar modelos de evento com sua equipe
- Integrar com aplicativos de calendário
- Criar convites com horários pré-definidos
Parâmetros de URL
Detalhes básicos do evento
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
title | string | Título do evento | title=Reuni%C3%A3o%20do%20Time |
description | string | Descrição do evento | description=Sync%20semanal |
Faixas de horário (slots)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
slots | string[] | Intervalos em formato ISO 8601 | slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z |
slotLength | number | Duração padrão do slot em minutos (15 a 1440) | slotLength=60 |
Exemplos
Evento simples
/events/new?title=Reuni%C3%A3o%20do%20Time&description=Sync%20semanal
Evento com horários
/events/new?title=Reuni%C3%A3o%20do%20Time&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slotLength=60
Modelo completo
/events/new?title=Kickoff%20do%20Projeto&description=Reuni%C3%A3o%20inicial&slots=2024-01-15T09:00:00Z,2024-01-15T10:30:00Z&slots=2024-01-15T14:00:00Z,2024-01-15T15:30:00Z&slotLength=90
Formato dos slots
Os horários devem estar em ISO 8601 e seguir os requisitos:
- Formato:
YYYY-MM-DDTHH:mm:ssZ - Duração: mínimo de 30 minutos
- Futuro: todos os slots devem estar no futuro
- Sem sobreposição: os slots não podem se sobrepor
Exemplos válidos
2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
2024-01-16T14:30:00Z,2024-01-16T16:00:00Z
Exemplos inválidos
2024-01-15T09:00:00Z,2024-01-15T09:15:00Z # Muito curto (15 min)
2024-01-15T10:00:00Z,2024-01-15T09:00:00Z # Fim antes do início
2023-01-15T09:00:00Z,2023-01-15T10:00:00Z # Data passada
Múltiplos slots
Para especificar vários horários, repita o parâmetro slots:
/events/new?title=Reuni%C3%A3o&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slots=2024-01-17T16:00:00Z,2024-01-17T17:00:00Z
Codificação de URL
Ao criar URLs manualmente, lembre-se de codificar caracteres especiais:
| Caractere | Codificação |
|---|---|
| Espaço | %20 |
| Vírgula | %2C |
| Dois-pontos | %3A |
| Barra | %2F |
Exemplo
Original: Reunião do Time, Sync semanal
Codificado: Reuni%C3%A3o%20do%20Time%2C%20Sync%20semanal
Exemplos de integração
Aplicativos de calendário
Diversos aplicativos aceitam parâmetros por URL. Você pode usar URLs do WhenToMeet como URL do evento:
URL do evento: https://whentomeet.io/events/new?title=Reuni%C3%A3o%20do%20Time&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
Modelos de e-mail
Inclua URLs do WhenToMeet em templates de e-mail para criar eventos rapidamente:
<a
href="https://whentomeet.io/events/new?title=Reuni%C3%A3o%20do%20Time&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z"
>
Criar reunião de time
</a>
Integração com Slack/Teams
Use URLs do WhenToMeet nas ferramentas de comunicação da sua equipe:
https://whentomeet.io/events/new?title=Daily%20Standup&slots=2024-01-15T09:00:00Z,2024-01-15T09:15:00Z&slotLength=15
Boas práticas
- Mantenha as URLs curtas: inclua apenas o necessário
- Títulos claros: deixe evidente o propósito do evento
- Ofereça opções: forneça múltiplos horários quando possível
- Duração adequada: considere o tipo de reunião
- Teste suas URLs: garanta que funcionam como esperado
Limitações
- Duração máxima do slot: 24 horas
- Duração mínima do slot: 30 minutos
- Máximo de slots: sem limite (considere a usabilidade)
- Todos os slots devem estar no futuro
- Slots não podem se sobrepor
Solução de problemas
Problemas comuns
- Formato inválido: certifique-se de usar ISO 8601
- Datas passadas: os slots devem ser futuros
- Sobreposição: ajuste horários para não sobrepor
- Duração curta: mínimo de 30 minutos
- Codificação de URL: codifique caracteres especiais corretamente
Mensagens de erro
- "Invalid slot format": verifique o formato
- "Slot duration must be at least 30 minutes": aumente a duração
- "Time slots cannot overlap": ajuste os horários
- "All time slots must be in the future": use datas futuras