Organização, QR e ciclo de vida

Organização e ciclo de vida estão disponíveis em produção e homologação. A integração por API e o painel próprio /platform usam o mesmo contrato. O painel principal continua no ambiente atual; a área nova tem sessão própria por ambiente. Acesse produção ou homologação.

Organização

Cada app pode ter até 100 tags, 100 pastas e 100 campanhas. Nomes são únicos por tipo/app, ignorando caixa e espaços externos. Uma pasta é uma coleção sem subpastas. Um link tem uma pasta, uma campanha e até 20 tags; todas precisam pertencer ao mesmo app. Arquivar uma coleção não altera a disponibilidade nem remove suas associações. Para excluir, desvincule todos os links. Esses conceitos são independentes de group=main|operational.

No painel, selecione o app e crie os itens na seção Tags, pastas e campanhas. Em Links → Gerenciar, selecione pasta/campanha e salve o link. Marque as tags e use Salvar tags. Cada botão salva sua própria alteração; revisão desatualizada exige consultar o item novamente.

Disponibilidade

archived organiza o catálogo e mantém o link funcionando. paused interrompe o acesso. startsAt permite o acesso a partir daquele instante, inclusive; expiresAt interrompe no instante informado, exclusivo. Sem início/fim, não há restrição temporal. O início precisa preceder o fim. Datas incluem fuso; o instante é armazenado em UTC. A prioridade é pausa → expiração → agendamento → ativo. Retomar significa salvar paused:false; as outras datas continuam valendo. Para retirar o agendamento/expiração, salve o respectivo valor como null.

No acesso web, um link indisponível retorna 302 para fallbackUrl, quando configurado; sem fallback, retorna 404 antes do início e 410 quando pausado/expirado. Não gera clique. Na resolução nativa v1, indisponibilidade retorna 404, sem entregar o caminho nativo. Um app que já possui conteúdo local continua responsável por autorizar seu próprio conteúdo.

O slug continua reservado até a exclusão do link. Nenhuma pausa, regra, arquivo ou QR altera a identidade pública. QR salvo impede excluir o link até remover as configurações de QR. Remover um QR salvo não inutiliza cópias da imagem já distribuídas; elas continuam apontando para o link.

Regras e UTMs

Até dez regras ordenadas por link. A primeira compatível com plataforma, país e janela temporal determina um destino HTTPS web, independentemente do comportamento nativo original. Sem correspondência, o comportamento original permanece. País ausente não corresponde a regra de país. Plataforma vem do user-agent; país do metadado Cloudflare observado no Worker. São sinais de direcionamento, sem valor de autenticação. Na resolução nativa, sem país confiável ele permanece ausente; agentes sem user-agent reconhecível só correspondem a regras de todas as plataformas. Não há sorteio/A-B, porcentagem, redirecionamento por identidade ou busca em URL externa.

As cinco UTMs padrão são utm_source, utm_medium, utm_campaign, utm_term, utm_content. No painel, Copiar UTMs da campanha preenche o formulário; Salvar link publica uma cópia explícita. Alterar a campanha posteriormente não reescreve URLs. UTMs da regra prevalecem sobre as do link; UTMs explícitas prevalecem sobre valores homônimos dos destinos/parâmetros personalizados. Outros parâmetros são preservados. Regras retornam destino web; as UTMs padrão do link também são incluídas nos parâmetros entregues pela resolução nativa.

Simular configuração salva permite plataforma, país e data com fuso. Usa o mesmo avaliador do Worker e mostra estado, regra e destino, sem clique nem redirect. Simula o banco atual: a publicação pode ainda estar pendente no serviço público.

QR e métricas

Um QR contém exclusivamente o URL HTTPS do link Agilink; acompanha os destinos, a pausa e a expiração do link. Salve-o em Gerenciar → Salvar novo QR; em QR Codes, edite nome/tamanho/margem/correção/cor e baixe PNG ou SVG. Tamanhos entre 256 e 1024 pixels, margem mínima de quatro módulos, cores escuras sobre branco e correção M/Q/H. A densidade mínima é quatro pixels por módulo. URLs excessivas ou estilos que não comportam a densidade são recusados. Não há logo cobrindo módulos nem upload arbitrário de SVG neste pacote.

Os testes decodificam o PNG gerado; a leitura física por câmera e a impressão não foram certificadas pelo ensaio automatizado. Teste o QR no aparelho e no tamanho de impressão antes de distribuir. Não há contagem garantida de scans: acesso direto e scan do mesmo endereço podem ser indistinguíveis. Crie um link dedicado com campanha/UTMs para atribuição explícita.

Filtros de tags, pasta e campanha e a consulta de campanha usam associação atual do link. Reclassificar muda como eventos anteriores aparecem nessas consultas; não é histórico de atribuição da campanha no instante do clique. Contadores não estimam instalações. O histórico administrativo registra nomes de campos alterados e revisão, sem valores antigos de URLs/parâmetros. Ele começa na instalação deste marco.

Publicação

API, painel e simulador leem o banco atual. O Worker lê a projeção pública na fila/KV. Atualizações dependem da fila e da consistência eventual do KV; synced confirma a gravação verificada pelo publicador, sem garantir que todos os pontos de presença já leram a nova versão. Depois de propagadas, início/expiração são avaliados por request, sem job por link. Não trate pausa como revogação instantânea ou controle de acesso de conteúdo. Veja como KV funciona.