CodeBox Hub
GRÁTIS

QR Code para Evento: Campos vEvent e Armadilhas do Calendário

Adicione um evento ao calendário do celular com o formato vEvent: tabela de campos, armadilhas de UID/DURATION e um tutorial em 3 etapas.

# 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

CampoSintaxeObrigatórioExemploObservações
VersionVERSION:2.0SimVERSION:2.0Linha vCalendar 2.0
UIDUID:unique@hostSimUID:conf-42@codeboxhub.comDeve ser único por evento
DTSTAMPDTSTAMP:20260801T090000ZSimDTSTAMP:20260801T090000ZHora de criação, UTC
SUMMARYSUMMARY:KeynoteNãoSUMMARY:KeynoteO título exibido no calendário
DTSTARTDTSTART;TZID=...:…Não*DTSTART:20260801T090000*A maioria dos celulares exige
DTENDDTEND:…NãoDTEND:20260801T103000Eventos de dia inteiro: omitir, usar VALUE=DATE
LOCATIONLOCATION:Hall BNãoLOCATION:Hall B, CenterTexto simples, sem geocodificação
DESCRIPTIONDESCRIPTION:Agenda insideNãoDESCRIPTION:Agenda insideQuebras de linha escapadas como \n
URLURL:https://…NãoURL:https://conf.example/Página complementar ou inscrição
STATUSSTATUS:CONFIRMEDNãoSTATUS:CONFIRMEDTENTATIVE / CANCELLED também são válidos

Armadilhas do vEvent

ArmadilhaO que aconteceSolução
UID duplicado entre eventosCalendários tratam atualizações como um único eventoTorne o UID único por evento
DTSTART sem DTEND para evento com horaAlguns clientes exibem um evento de duração zeroDefina ambos, mesmo para 15 minutos
Evento de dia inteiro com hora no DTSTARTCalendário exibe 00:00, não dia inteiroUse VALUE=DATE e campos apenas com data
Fusos horários misturados em um eventoFalha na importação no iOS ou AndroidUm único fuso, ou tudo em UTC
Vírgulas e quebras de linha não escapadas no DESCRIPTIONCampos divididos no meio do textoEscape como \, e \n
DTSTAMP ausenteImportadores estritos rejeitam o registroInclua sempre, em UTC
UID com espaços ou pontuaçãoImportadores estritos rejeitam o registroUse apenas alfanuméricos, hífens e pontos
DTSTART no passadoClientes podem importar como expirado ou recusarRecodifique 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

  1. Preencha o título, data, hora, localização e observações no gerador de QR de evento.
  2. Exporte o PNG ou SVG; a carga útil permanece abaixo de ~250 bytes para uma sessão típica.
  3. 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.

FAQ

O que um QR code para evento faz?

Ele oferece adicionar um evento de calendário — título, hora, localização e observações — ao calendário do celular.

Qual formato um QR code de evento usa?

vEvent, a família vCalendar definida pela RFC 5545 — os mesmos dados que os celulares importam de links "Adicionar evento".

Um QR code de evento pode ser de dia inteiro?

Sim. Use DTSTART apenas com data com VALUE=DATE e omita a hora; nunca misture uma hora em um campo de dia inteiro.

Um QR code pode criar um evento recorrente?

Um único vEvent é uma ocorrência; recorrência precisa de VRECUR ou um código separado por ocorrência.

QR codes de evento funcionam em iPhone e Android?

Sim. Ambos os calendários importam vEvent nativamente e exibem o prompt padrão de adicionar evento.

Por que alguns calendários mesclam meus eventos?

UIDs compartilhados. Cada evento precisa do seu próprio UID único, ou o cliente os trata como um.

Como um QR de evento difere de um QR de contato?

Um vEvent adiciona um compromisso com bloco de tempo; um vCard adiciona uma pessoa ao livro de endereços.

Continue lendo

Fale conosco