Skip to content
GUIA OFICIAL PASSO A PASSO
ChatGPT, Claude e Gemini

Como criar passes do Apple e Google Wallet com IA

Saiba como usar o ChatGPT, Claude e Gemini para gerar designs prontos para produção, exportar pacotes .pkpass não assinados e importar no Passinstance para assinatura criptográfica e distribuição multicanal.

Pipeline de IA para Wallet em 5 etapas

Vá direto para qualquer etapa ou gere seu prompt no Studio.

01 → 05
Assinatura HSM Zero-Trust — Chaves Apple .p12 permanecem seguras no Passinstance
VISÃO GERAL DA ARQUITETURA

Por que combinar IA generativa com o Passinstance?

Modelos de IA generativa como ChatGPT, Claude e Gemini se destacam na estruturação de layouts visuais, no design de paletas de cores harmoniosas e na redação de textos. No entanto, o Apple Wallet e o Google Wallet exigem conformidade rigorosa com esquemas JSON, proporções de imagem precisas e assinaturas digitais verificadas criptograficamente com certificados da Apple Developer.

O Passinstance preenche essa lacuna: nosso gerador de prompts fornece à sua ferramenta de IA o esquema exato de campos do Apple Wallet. Basta exportar um pacote .pkpass não assinado e o Passinstance analisa automaticamente as variáveis dinâmicas, adapta o layout para o Google Wallet e cuida da assinatura criptográfica segura durante a emissão.

A fronteira Zero-Trust: nunca compartilhe chaves privadas com a IA

As ferramentas externas de chat de IA nunca devem receber seus certificados Apple Developer (.p12, .pem), Pass Type IDs ou chaves privadas de assinatura. Com o Passinstance, a IA externa gera apenas o pacote estrutural de design (.pkpass com pass.json e arquivos de imagem). O Passinstance assina seus passes em ambientes HSM seguros e isolados no momento da emissão ao vivo.

01

Passo 1: Selecione a categoria do passe e a identidade da marca

Abra o assistente 'Criar passe Wallet com IA' no painel do Passinstance. Escolha entre os 6 estilos oficiais do Apple Wallet:

Cartão de fidelidade e loja

Saldo de pontos, níveis de associação e check-in na loja.

Cartão de membro

Números de associado, datas de validade e status da associação.

Ingresso de evento e passe pôster

Níveis de acesso, filas de assentos, datas e códigos de barras do local.

Cupom de desconto e cartão de embarque

Ofertas especiais, voos, portões de embarque e números de assento.

Dica: Defina suas cores de fundo, texto (primeiro plano) e rótulo. O Passinstance converte automaticamente códigos hexadecimais em sequências rgb(r, g, b) padrão do Apple Wallet.

Foco ampliado da interface
Elementos-chave da interface

Assistente de IA — Categoria e Identidade da Marca

Selecione a categoria do cartão e cores da marca convertidas automaticamente para o formato Apple rgb(r, g, b).

02

Passo 2: Gere e execute o prompt no chat de IA

O Passinstance gera uma especificação otimizada para IA. Inicie sua ferramenta de IA preferida usando os atalhos diretamente no painel:

Escolher modelo:

Exemplo de prompt geradostoreCard
{firstName}{points}{tierName}{memberId}
You are an expert Apple Wallet pass architect.
Create an unsigned .pkpass design package (pass.json + PNG artwork placeholders) configured as a Passinstance "storeCard" Loyalty Pass:

- formatVersion: 1, passTypeIdentifier & teamIdentifier left as placeholders (signed server-side by Passinstance HSM)
- Colors (strict rgb format): backgroundColor "rgb(16, 26, 35)", foregroundColor "rgb(255, 255, 255)", labelColor "rgb(125, 180, 240)"
- headerFields: key "tier", label "STATUS", value "{tierName}", changeMessage "Your status is now %@"
- primaryFields: key "points", label "POINTS", value "{points}", changeMessage "Points updated to %@!"
- secondaryFields: key "member", label "MEMBER", value "{firstName}"
- auxiliaryFields: key "cardNo", label "CARD ID", value "{memberId}"
- barcode: PKBarcodeFormatQR with message "{memberId}" and iso-8859-1 encoding

Important: Use single curly braces ({variable}) for dynamic attributes so Passinstance auto-detects Custom Properties during .pkpass import. Do not include certificates or signatures.
rgb(16, 26, 35)rgb(255, 255, 255)rgb(125, 180, 240)

Elementos sintáticos principais:

{firstName} · {points}

Chaves simples

Variáveis dinâmicas como {firstName} ou {points} são descobertas automaticamente durante a importação.

changeMessage

Strings changeMessage

Os campos incluem modelos de notificação push como «Seus pontos foram atualizados para %@!» para avisos na tela de bloqueio.

PKBarcodeFormatQR

Objeto de código de barras

Padronizado para PKBarcodeFormatQR com codificação de mensagem ISO-8859-1.

Foco ampliado da interface
Elementos-chave da interface

Assistente de IA — Mecânicas, Gatilhos e Variáveis

Escolha geolocalização, expiração, mecânica e marcadores dinâmicos {token} antes de gerar o prompt.

Foco ampliado da interface
Elementos-chave da interface

Assistente de IA — Execução e Proteção de Chaves

Abra o prompt no ChatGPT, Claude ou Gemini mantendo suas chaves privadas da Apple estritamente offline.

03

Passo 3: Exporte o pacote .pkpass não assinado

Instrua sua ferramenta de IA a fornecer os arquivos do pacote. Um arquivo Apple Wallet .pkpass padrão contém a seguinte estrutura:

Estrutura do pacote .pkpass

meu-passe-wallet.pkpass (arquivo ZIP)

ZIP / Unsigned
  • pass.jsonEsquema JSON
  • icon.png · icon@2x.pngAtivos PNG
  • logo.png · logo@2x.pngAtivos PNG
  • strip.png · strip@2x.pngAtivos PNG
  • (opcional) pt.lproj/pass.stringsIdiomas

Regra de empacotamento: Certifique-se de que o arquivo seja salvo como .pkpass. O Passinstance inspeciona o pacote, valida a sintaxe JSON e prepara os recursos visuais para renderização em várias plataformas.

Foco ampliado da interface
Elementos-chave da interface

Assistente de IA — Links de Arte ou Envio no Chat

Informe links HTTPS das imagens ou envie seus arquivos PNG diretamente no chat da IA para empacotar no .pkpass.

04

Passo 4: Importe no Passinstance & Detecção automática de atributos

No painel do Passinstance, clique em 'Fazer upload do pacote de design (.pkpass)'. O analisador inteligente realiza automaticamente:

Descoberta de tokens dinâmicos: Extrai cada {marcador} e o registra como um atributo personalizado de cliente.
Infere tipos de dados: Classifica os campos em valores de Texto, Número, Data, Moeda ou Código de barras.
Mapeamento Dual-Wallet: Adapta automaticamente o layout do Apple Wallet em uma classe e objeto nativos do Google Wallet.
Foco ampliado da interface
Elementos-chave da interface

Menu de Templates — Importar .pkpass / JSON

Abra New template → Import from file para enviar seu pacote .pkpass gerado por IA, ZIP ou JSON.

Foco ampliado da interface
Elementos-chave da interface

Editor Visual — Propriedades Detectadas Automaticamente

Revise cada variável extraída do pacote importado, ajuste validações ou vincule campos digitando '{'.

05

Passo 5: Publique, assine e distribua passes ao vivo

Depois de revisado, publique seu modelo. Agora você pode emitir passes assinados prontos para uso através do seu canal preferido:

API REST

Emissão via POST /api/v1/passes com carga JSON do cliente.

Importação em massa via CSV

Importe milhares de linhas de clientes com atributos já mapeados.

Web PassFlow

Páginas PassFlow de autoatendimento personalizadas para adição direta à carteira do smartphone.

Foco ampliado da interface
Elementos-chave da interface

Visão do Template — Checklist de Publicação (3 of 3 Ready)

Confirme que Signing certificate, Validation rules e Download page exibem Ready antes de distribuir.

Foco ampliado da interface
Elementos-chave da interface

Cabeçalho Publicado e Ações de Emissão

No status Ready, crie passes de teste, dispare campanhas em massa ou gerencie certificados Apple de produção.

PERGUNTAS FREQUENTES

Perguntas frequentes

Posso usar versões gratuitas do ChatGPT, Claude ou Gemini?

Sim. O prompt gerado utiliza JSON padrão e instruções claras. Versões gratuitas do ChatGPT (GPT-4o mini / GPT-4o), Claude 3.5 Sonnet e Gemini 1.5 Flash produzem especificações pass.json totalmente compatíveis.

Preciso de uma conta Apple Developer antes de testar com IA?

Não. Você pode criar, importar e testar passes imediatamente no ambiente de testes do Passinstance. Quando estiver pronto para produção, basta enviar seu certificado da Apple Developer nas configurações da área de trabalho.

Como o Passinstance converte designs do Apple Wallet em passes do Google Wallet?

O Passinstance mapeia automaticamente os campos do Apple Wallet (headerFields, primaryFields, secondaryFields) para as definições de classe e módulos de texto correspondentes do Google Wallet. O design aparece nativo no iOS e no Android.

Pronto para lançar passes com IA?

Gere seu primeiro passe para Apple e Google Wallet pronto para produção em minutos com ChatGPT, Claude ou Gemini.