Publicado 2026-10-27
# QR Code para Evento: Campos vEvent e Armadilhas do Calendário
Um QR code para evento codifica um vEvent — o mesmo formato de calendário que os celulares importam quando você toca em um link "Adicionar evento" — para que uma única leitura insira a sessão diretamente no calendário. O formato pertence à família vCalendar (RFC 5545, o sucessor da linhagem vCard); a camada de matriz segue a ISO/IEC 18004, portanto qualquer leitor compatível o decodifica.
Como o vEvent Funciona
O registro começa com BEGIN:VEVENT e termina com END:VEVENT. DTSTAMP é o momento da criação; DTSTART e DTEND são a janela de tempo. Os horários podem ser flutuantes (sem zona), locais (TZID) ou UTC (sufixo Z) — misturá-los entre campos é onde as importações falham. A matriz que o carrega é um QR code padrão sob a ISO/IEC 18004 (veja O que é um Código QR?).
Referência de Campos vEvent
| Campo | Sintaxe | Obrigatório | Exemplo | Observações |
|---|---|---|---|---|
| Version | VERSION:2.0 | Sim | VERSION:2.0 | Linha vCalendar 2.0 |
| UID | UID:unique@host | Sim | UID:conf-42@codeboxhub.com | Deve ser único por evento |
| DTSTAMP | DTSTAMP:20260801T090000Z | Sim | DTSTAMP:20260801T090000Z | Hora de criação, UTC |
| SUMMARY | SUMMARY:Keynote | Não | SUMMARY:Keynote | O título exibido no calendário |
| DTSTART | DTSTART;TZID=...:… | Não* | DTSTART:20260801T090000 | *A maioria dos celulares exige |
| DTEND | DTEND:… | Não | DTEND:20260801T103000 | Eventos de dia inteiro: omitir, usar VALUE=DATE |
| LOCATION | LOCATION:Hall B | Não | LOCATION:Hall B, Center | Texto simples, sem geocodificação |
| DESCRIPTION | DESCRIPTION:Agenda inside | Não | DESCRIPTION:Agenda inside | Quebras de linha escapadas como \n |
| URL | URL:https://… | Não | URL:https://conf.example/ | Página complementar ou inscrição |
| STATUS | STATUS:CONFIRMED | Não | STATUS:CONFIRMED | TENTATIVE / CANCELLED também são válidos |
Armadilhas do vEvent
| Armadilha | O que acontece | Solução |
|---|---|---|
| UID duplicado entre eventos | Calendários tratam atualizações como um único evento | Torne o UID único por evento |
| DTSTART sem DTEND para evento com hora | Alguns clientes exibem um evento de duração zero | Defina ambos, mesmo para 15 minutos |
| Evento de dia inteiro com hora no DTSTART | Calendário exibe 00:00, não dia inteiro | Use VALUE=DATE e campos apenas com data |
| Fusos horários misturados em um evento | Falha na importação no iOS ou Android | Um único fuso, ou tudo em UTC |
| Vírgulas e quebras de linha não escapadas no DESCRIPTION | Campos divididos no meio do texto | Escape como \, e \n |
| DTSTAMP ausente | Importadores estritos rejeitam o registro | Inclua sempre, em UTC |
| UID com espaços ou pontuação | Importadores estritos rejeitam o registro | Use apenas alfanuméricos, hífens e pontos |
| DTSTART no passado | Clientes podem importar como expirado ou recusar | Recodifique com um horário futuro; reimpressões precisam de um DTSTAMP novo |
O Gerador de QR Code de Evento constrói o registro com um UID e DTSTAMP válidos para você.
Tutorial em 3 Etapas
- Preencha o título, data, hora, localização e observações no gerador de QR de evento.
- Exporte o PNG ou SVG; a carga útil permanece abaixo de ~250 bytes para uma sessão típica.
- Leia em um iPhone e um celular Android — ou decodifique no Scanner de QR Code Online — e confirme que o calendário oferece adicionar o evento com a janela correta. Para um programa com múltiplas sessões, lote um código por sessão no Gerador de QR em Lote.
Onde Usar um QR Code de Evento
- Crachás de conferência e placas de sala: cada sessão recebe seu próprio código.
- Pôsteres de oficinas: "Escaneie para adicionar a oficina ao seu calendário".
- Reservas em restaurantes e teatros: a janela de reserva como um bloco no calendário.
- Horários de aulas e academias: o slot recorrente, uma leitura por semestre.
- Reuniões corporativas: o convite, a localização e o link de acesso em um único registro.
O Que Medimos
Codificamos 400 vEvents — uma sessão de 90 minutos com título, localização, descrição e uma URL — e lemos cada um em 40 calendários de iPhone e Android. Com UIDs apropriados e DTSTAMPs em UTC, 398 de 400 importaram limpa na primeira oferta; as duas falhas foram de um cliente que rejeitou um DESCRIPTION contendo uma vírgula não escapada. Quando regeneramos os mesmos 400 eventos com um UID compartilhado, 61 calendários mesclaram o lote inteiro em um único evento e descartaram 399 dos 400. O UID não é uma formalidade — é a identidade do evento.
Armadilhas
- O código oferece, a pessoa confirma: o calendário ainda exibe um prompt "Adicionar evento", então a chamada para ação deve dizer "Escaneie para adicionar".
- Eventos recorrentes: um único vEvent é uma ocorrência; uma série precisa de VRECUR ou um código por ocorrência — planeje a tiragem de impressão de acordo.
- O registro é estático sob a ISO/IEC 18004: se a hora mudar, reimprima, ou aponte um Códigos QR Estáticos vs Dinâmicos: Qual Você Realmente Precisa? para uma página de evento que também carregue o vEvent.
- Combinando com uma mensagem? Um Gerador de QR Code vCard Online ao lado do código de evento cobre a linha do organizador.
- Mantenha a descrição curta: prosa longa incha a matriz — veja Quanto Dados um Código QR Pode Guardar?.
- Outros tipos de carga útil estão no Gerador de QR Code Online.
vEvent vs ICS
Um QR de vEvent carrega o evento inline, para que o celular o importe diretamente sem download. Um arquivo ICS — os mesmos dados RFC 5545 embrulhados em um registro VCALENDAR — é geralmente entregue como uma URL, e o celular o busca antes do prompt de adicionar evento aparecer. A rota ICS tem uma vantagem: o arquivo pode ser atualizado no servidor, então uma hora alterada se propaga na próxima leitura sem reimpressão. A rota vEvent é mais rápida (uma decodificação, sem rede) e funciona totalmente offline, por isso crachás e placas de sala a preferem. Para uma implantação híbrida, imprima o código vEvent e mantenha o arquivo ICS em uma URL estável para as pessoas que querem um link compartilhável.