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 no iPhone e no Apple Watch. Com o Pushwoosh, você pode criar 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 Carteira da Apple

Com os passes da Carteira da Apple no Pushwoosh, você pode:

• Criar 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.
• Emitir um design de passe para muitos usuários e atualizar campos compartilhados em todos os passes emitidos de um só lugar. Consulte Criar campanhas de passes da Carteira.
• Alcançar os portadores de passes com um push único, uma atualização de passe ou uma Customer Journey. Consulte Enviar mensagens aos portadores de passes da Carteira da Apple.

Pré-requisitos

Assistência do desenvolvedor necessária

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

Antes de criar seu primeiro passe, confirme o seguinte:

• Programa de Desenvolvedor 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: 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

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

1. Configure os passes da Carteira no Pushwoosh

   Antes de poder criar 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. Crie 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 à 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.

6. Envie mensagens aos portadores de passes

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

   Enviar mensagens aos portadores de passes da Carteira da Apple

Visualizar e gerenciar passes existentes

No Painel de Controle, vá para Campanhas → Passes da Carteira e abra a guia 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, 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 à 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: 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. Ao abri-lo da lista, ele visa o proprietário do passe por ID do usuário. Consulte Enviar mensagens aos portadores de passes da Carteira da Apple para todas as maneiras de alcançá-los.
• 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 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 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 Carteira 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 Carteira da Apple

Visualizar portadores de passes no User Explorer

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

1. Vá para Público → User Explorer e abra o perfil do usuário.
2. Abra a guia Dispositivos e plataformas.
3. Selecione Carteira da Apple 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