Começando com os passes do Apple Wallet

Os passes do Apple Wallet são cartões digitais, como cartões de fidelidade, cupons, ingressos para eventos, cartões de embarque e cartões de loja, que seus usuários mantêm no aplicativo Carteira (Wallet) no iPhone e Apple Watch. Com o Pushwoosh, você pode projetar um passe visualmente no Painel de Controle, compartilhá-lo e, em seguida, enviar atualizações a qualquer momento, sem pedir aos usuários para reinstalar nada.

Quando você altera um passe, o Pushwoosh notifica todos os dispositivos que o adicionaram, e o iOS busca silenciosamente a nova versão. O código de barras, saldo, número do portão ou data de validade no telefone do usuário é atualizado por conta própria.

O que você pode fazer com os passes do Apple Wallet

Com os passes do Apple Wallet no Pushwoosh, você pode:

• Projetar passes visualmente com cores, campos, logotipo, imagem de faixa e código de barras, sem escrever pass.json manualmente.
• Criar cartões de fidelidade, cupons, ingressos para eventos, cartões de embarque e cartões de loja genéricos.
• Distribuir passes para os usuários como um arquivo .pkpass, link de instalação ou código QR.
• Atualizar o conteúdo do passe e entregar as alterações aos dispositivos que adicionaram o passe.

Pré-requisitos

É necessária a ajuda de um desenvolvedor

A emissão de passes do Apple Wallet requer uma conta de Desenvolvedor Apple e certificados de assinatura. Compartilhe esta seção com sua equipe de desenvolvimento para concluir a configuração única.

Antes de projetar seu primeiro passe, confirme o seguinte:

• Programa de Desenvolvedores da Apple: Você precisa de uma assinatura ativa para registrar IDs de Tipo de Passe e criar certificados de assinatura. Inscreva-se ou gerencie sua conta
• Plataforma iOS: Sua aplicação deve ter o iOS conectado no Pushwoosh antes que você possa adicionar um certificado de assinatura de passe. Configurar o iOS

Comece a trabalhar com os passes do Apple Wallet

Após os pré-requisitos estarem em vigor, siga este fluxo:

1. Configure os passes do Wallet no Pushwoosh

   Antes de poder projetar passes, o Pushwoosh deve ter seu certificado de assinatura da Apple para a aplicação. Sua equipe de desenvolvimento o cria no Apple Developer e o carrega no Pushwoosh. Esta é uma configuração única por aplicação.

   Como configurar o certificado de assinatura

2. Projete o passe

   No construtor de passes, escolha um estilo de passe, defina campos e identidade visual e verifique a pré-visualização ao vivo.

3. Gere um .pkpass assinado

   Depois de criar e validar o passe, no construtor de passes, selecione Gerar. O Pushwoosh prepara as imagens nas resoluções necessárias e assina o arquivo com seu certificado.

4. Distribua o passe

   Envie aos usuários o arquivo .pkpass, o link de instalação ou o código QR. Veja Compartilhe o passe com os usuários através dos canais Pushwoosh. Quando os usuários adicionam o passe à Carteira, o dispositivo deles se registra para futuras atualizações.

5. Atualize o conteúdo do passe

   Edite o passe no construtor de passes ou através da API e salve. O Pushwoosh notifica os dispositivos registrados, e o iOS baixa a nova versão em segundo plano. Os usuários não precisam reinstalar o passe.

Visualizar e gerenciar passes existentes

No Painel de Controle, vá para Campanhas → Apple Wallet para abrir a lista de passes. A página lista todos os passes para a aplicação, incluindo seu nome, estilo, o ID do Usuário ao qual está associado, e a data e hora da última atualização.

Na lista de passes, abra o menu de ações (⋮) para:

• Editar: alterar o nome e a descrição do passe, valores e rótulos dos campos, alterar mensagens, cores, mensagem do código de barras, expiração e status, e locais. O estilo e as imagens do passe permanecem bloqueados após a criação. Ao salvar, todos os dispositivos que adicionaram o passe recebem a atualização.

As atualizações são entregues como pushes silenciosos

Quando você salva uma alteração, o Pushwoosh reassina o passe e notifica todos os dispositivos registrados com um push sem conteúdo. O iOS busca a nova versão por conta própria — não é necessário reinstalar.

• Baixar: baixar o arquivo .pkpass assinado.
• Código QR: mostrar um código QR de instalação que os usuários podem escanear para adicionar o passe à Carteira e registrar seu dispositivo para atualizações. Nesta janela, você também pode usar Copiar link de instalação abaixo do QR.
• Copiar link de instalação: copie a URL de instalação para compartilhar o passe em seus canais de mensagens. Saiba mais.
• Excluir: remover o passe. As cópias já instaladas nos dispositivos deixam de receber atualizações e se tornam inválidas na próxima atualização.

Compartilhe o passe com os usuários através dos canais Pushwoosh

O link de instalação que você copia no construtor (Copiar link de instalação) é uma URL regular. Abri-lo em um iPhone adiciona o passe ao Apple Wallet. Você pode usar este link nos mesmos canais Pushwoosh que já usa para alcançar seu público:

• E-mail: adicione o link a um botão ou link de texto no editor de e-mail, por exemplo, uma chamada para ação “Adicionar ao Apple Wallet”.
• Notificações push: defina o link como a ação de abertura da notificação para que um toque abra o passe.
• SMS: inclua o link no conteúdo do SMS.

Um link por passe

Cada link de instalação está vinculado a um único passe (ele carrega o número de série e o token desse passe), então um link funciona para um passe compartilhado, o que é útil para um cupom ou ingresso de evento comum. Para dar a cada destinatário seu próprio passe, gere um passe por usuário com a API PassKit e envie a cada usuário seu próprio link. Os passes do Wallet são instalados apenas em dispositivos Apple — iPhone e Apple Watch.

Gerenciar passes via API

Tudo o que o construtor de passes faz também está disponível programaticamente através da API PassKit Designer: criar, atualizar, listar, baixar e excluir passes.

API PassKit do Apple Wallet