Pular para o conteúdo principal
— Passo a passo de configuração

Gere chaves de licença automaticamente em vez de fazer upload de CSV

Escolha geração automática quando cada cliente precisa de um identificador único, mas a chave não precisa ser pré-compartilhada com outro sistema. O Alva Digital Downloads emite uma chave nova em todo pedido pago — sem CSV, sem pool para repor, sem risco de estoque baixo. Faça upload de um CSV quando as chaves precisam ser pré-emitidas por um fornecedor de software, lançador de jogo ou servidor de ativação.

Configure a geração automática

1. Abra a página Chaves de Licença

No admin do Alva, clique em Chaves de Licença na navegação lateral. Abra um grupo, ou clique em Adicionar Chaves de Licença para criar um e nomeie de acordo com o produto.

Captura de tela necessária

Painel de configurações de grupo de chave de licença do admin do Alva. Destaque o toggle "Gerar automaticamente" na posição ligada. Mostre o seletor de formato (alfanumérico / UUID / ULID) e o input opcional de prefixo logo abaixo. Sem dados reais de cliente visíveis.

O toggle Gerar automaticamente e as opções de formato dentro de um grupo de chaves de licença.

2. Ligue o toggle Gerar automaticamente

Abra as configurações do grupo e ligue Gerar automaticamente. Os controles de importação de CSV desaparecem — o grupo não mantém mais um pool de estoque porque o Alva emite cada chave sob demanda no momento do pedido.

3. Escolha um formato e um prefixo opcional

Escolha um formato de chave (veja a próxima seção). Opcionalmente insira um prefixo curto — o Alva o concatena com um hífen, por exemplo PROv3-X7K2-9PMN-4QRT-8WBC.

4. Salve e vincule a um produto

Clique em Salvar. Abra o produto Shopify correspondente no admin do Alva e vincule o grupo em Chaves de Licença. O Alva gera uma chave por pedido pago a partir daí.

Opções de formato

O Alva suporta três formatos — o tamanho é fixo por formato, sem ajuste de tamanho separado:

  • Alfanumérico — quatro grupos de quatro caracteres (X7K2-9PMN-4QRT-8WBC). O conjunto de caracteres exclui glifos confusos (I, O, 0, 1) para que os clientes possam redigitar as chaves sem erros.
  • UUID v4 — UUID padrão de 36 caracteres (550e8400-e29b-41d4-a716-446655440000).
  • ULID — identificador ordenável lexicograficamente de 26 caracteres (01ARZ3NDEKTSV4RRFFQ69G5FAV).

O prefixo opcional aceita até 50 caracteres e é adicionado com um hífen — útil para marcar uma versão ou linha de produto na própria chave.

O que os clientes veem

Após um pedido pago passar por qualquer checagem antifraude, o e-mail de entrega mostra a chave de licença gerada ao lado dos links de download. A chave também fica na página de downloads da conta do cliente para nova cópia. Para o cliente, uma chave gerada automaticamente parece idêntica a uma vinda de CSV.

Captura de tela necessária

Um e-mail de entrega ao cliente mostrando uma chave de licença alfanumérica gerada automaticamente (por exemplo PROv3-X7K2-9PMN-4QRT-8WBC) dentro da seção Chaves de Licença, com um botão "Copiar" ao lado. Use um código falso, mas com aparência realista. Mostre o cabeçalho com a marca do e-mail no topo para que a captura seja claramente um e-mail de entrega do Alva.

Uma chave gerada automaticamente dentro do e-mail de entrega ao cliente.

Limitações

Chaves geradas automaticamente existem apenas dentro do Alva — elas não estão registradas com nenhum sistema externo. Um servidor de licenciamento de fornecedor, lançador de jogo ou API de ativação self-hosted vai rejeitar chaves que ele nunca viu.

Dois jeitos de cobrir essa lacuna: encaminhe a chave ao seu servidor pelo Shopify Flow no trigger digital-purchase-delivered, ou pré-emita as chaves com o fornecedor e use o upload de CSV.

Perguntas frequentes

Meu servidor de ativação de software vai reconhecer chaves geradas automaticamente?

Apenas se você também enviar a chave gerada ao seu servidor antes do cliente resgatá-la. O Alva não faz POST para sistemas externos. Use o Shopify Flow no trigger digital-purchase-delivered para encaminhar a chave, ou faça upload de chaves pré-emitidas via CSV.

Posso trocar um grupo de CSV para gerar automaticamente depois?

Sim. Abra o grupo, ligue Gerar automaticamente e salve. As chaves enviadas existentes ficam no grupo e são atribuídas primeiro; quando acabarem, o Alva começa a emitir novas no formato escolhido.

Chaves geradas automaticamente são garantidamente únicas?

UUID v4 e ULID são estatisticamente únicos por design. O formato alfanumérico usa um conjunto de 32 caracteres em 16 posições, dando aproximadamente 10^24 combinações — colisões dentro de uma loja não são realistas. A mesma chave nunca é atribuída duas vezes.

Veja também

Foi útil?

Ainda travado? Escreva para nós.

Última atualização 2026-05-06