# 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](/pt/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

## Pré-requisitos

<Aside type="caution" icon="setting" title="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.
</Aside>

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](https://developer.apple.com/programs/)
* **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](/pt/developer/first-steps/connect-messaging-services/ios-configuration/)

## Comece a trabalhar com os passes da Apple Wallet

Depois que os [pré-requisitos](#prerequisites) estiverem em vigor, siga este fluxo:

<Steps>

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](/pt/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **Projete o passe**

   No [construtor de passes](/pt/product/messaging-channels/apple-wallet-passes/pass-builder/), 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](/pt/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass), 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](#share-the-pass-with-users-via-pushwoosh-channels). 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](/pt/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## 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](/pt/product/pushwoosh-knowledge-hub/users-userids/) 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.

<Aside type="note" title="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.
</Aside> 

* **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](#share-the-pass-with-users-via-pushwoosh-channels).
* **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](/pt/product/pushwoosh-knowledge-hub/users-userids/). Consulte [Mensagem para os portadores de passes da Apple Wallet](/pt/product/messaging-channels/apple-wallet-passes/message-pass-holders/) 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](/pt/product/content/email-content/drag-and-drop-email-editor/), por exemplo, uma chamada para ação "Adicionar à Apple Wallet".
* **Notificações Push:** defina o link como a [ação de abertura](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) da notificação para que um toque abra o passe.
* **SMS:** inclua o link no [conteúdo do SMS](/pt/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content).

<Aside type="note" title="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](/pt/developer/api-reference/apple-wallet-passkit-api/) 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.
</Aside>

## 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.

<LinkCard title="API PassKit da Apple Wallet" href="/developer/api-reference/apple-wallet-passkit-api/" />

## 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](/pt/product/audience-data-and-segmentation/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](/pt/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)