Começando com os passes da Apple Wallet

Os passes da 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 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 da Apple Wallet

Com os passes da 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.
• Alcançar os portadores de passes com um push único, uma atualização de passe ou uma Customer Journey. Consulte Mensagem para os portadores de passes da Apple Wallet.

Pré-requisitos

Assistência de desenvolvedor necessária

A emissão de passes da 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 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 Apple Wallet

Depois que os pré-requisitos estiverem em vigor, siga este fluxo:

1. Configure os passes da Wallet no Pushwoosh

   Antes de poder projetar passes, o Pushwoosh deve ter seu certificado de assinatura da Apple para o aplicativo. Sua equipe de desenvolvimento 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 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. Consulte Compartilhe o passe com os usuários através dos canais do Pushwoosh. Quando os usuários adicionam o passe à Wallet, seus dispositivos se registram 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.

6. Envie mensagens aos portadores de passes

   Depois que os usuários adicionam o passe à Wallet, você pode alcançá-los com um push único, uma atualização de passe ou uma Customer Journey automatizada.

   Mensagem para os portadores de passes da Apple Wallet

Visualizar e gerenciar passes existentes

No Painel de Controle, vá para Campanhas → Passes da Wallet e abra a aba Apple Wallet. A tabela Todos os passes lista todos os passes para o aplicativo, incluindo seu nome, estilo, o User ID 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, validade 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 assina novamente 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 à Wallet 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: copiar a URL de instalação para compartilhar o passe em seus canais de mensagens. Saiba mais.
• Enviar mensagem: abrir o compositor de push único para enviar mensagens aos portadores de passes. Quando você o abre da lista, ele visa o proprietário do passe por User ID. Consulte Mensagem para os portadores de passes da Apple Wallet para todas as maneiras de alcançá-los.
• 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 à Apple Wallet. 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 à 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 da 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 da Apple Wallet

Visualizar portadores de passes no User Explorer

Quando um usuário adiciona seu passe à Wallet, o Pushwoosh o lista na aba Dispositivos e plataformas no User Explorer.

1. Vá para Público → User Explorer e abra o perfil do usuário.
2. Abra a aba Dispositivos e plataformas.
3. Selecione Apple Wallet na barra lateral.

No perfil da plataforma, você pode revisar:

• Status da assinatura: por exemplo, INSCRITO
• Identificador da plataforma: o identificador do passe mostrado sob o nome da plataforma
• Metadados: Primeira assinatura, Fuso horário e outros campos quando disponíveis
• Tags: tags da plataforma, incluindo quaisquer que você tenha definido ao emitir o passe

Saiba mais