Começando com os passes da Carteira da Apple

Os passes da Carteira da Apple 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 que reinstalem 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 da Carteira da Apple

Com os passes da Carteira da Apple 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

Assistência de desenvolvedor necessária

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

Antes de projetar seu primeiro passe, confirme o seguinte:

• Programa de Desenvolvedor 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: Seu aplicativo 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 da Carteira da Apple

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

1. Configure os passes da Carteira no Pushwoosh

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

   Como configurar o certificado de assinatura

2. Projete o passe

   No construtor de passes, escolha um estilo de passe, defina campos e marca, 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 do 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.

Visualize e gerencie passes existentes

No Painel de Controle, vá para Campanhas → Passes da Carteira e abra a aba Carteira da Apple. A tabela Todos os passes lista todos os passes para o aplicativo, incluindo seu nome, estilo, o ID do Usuário ao qual está associado, e a data e hora em que foi atualizado pela última vez.

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 ficam 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 param 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 do 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 à Carteira da Apple. Você pode usar este link nos mesmos canais do 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 à Carteira da Apple”.
• 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 comum ou ingresso de evento. 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 da Carteira são instalados apenas em dispositivos Apple — iPhone e Apple Watch.

Gerencie 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 da Carteira da Apple