# Primeiros passos com os passes da Carteira do Google

Os passes da Carteira do Google são cartões digitais, como cartões de fidelidade, ofertas, vales-presente, ingressos para eventos, cartões de embarque e bilhetes de transporte público, que os usuários guardam no aplicativo Carteira do Google.

Com o Pushwoosh, você cria um passe no Painel de Controle, envia-o aos usuários e atualiza o passe a qualquer momento. As alterações são sincronizadas automaticamente em todos os dispositivos salvos.

## O que você pode fazer com os passes da Carteira do Google

* Crie passes no [construtor de passes](/pt/product/messaging-channels/google-wallet-passes/pass-builder/)
* Compartilhe o link para salvar ou o código QR com os usuários
* Atualize os passes a qualquer momento. O Google sincroniza as alterações em todos os dispositivos salvos
* [Envie mensagens aos portadores de passes](/pt/product/messaging-channels/google-wallet-passes/message-pass-holders/) com um push único, uma notificação de atualização de passe ou uma Customer Journey

## Pré-requisitos

* Uma conta de emissor do [Google Pay & Wallet Console](https://pay.google.com/business/console)
* Um projeto do Google Cloud com uma chave de conta de serviço

## Comece a trabalhar com os passes da Carteira do Google

Após os [pré-requisitos](#prerequisites) estarem em vigor, siga este fluxo:

<Steps>

1. **Configure a Carteira do Google no Pushwoosh**

   Peça à sua equipe de desenvolvimento para conectar a Carteira do Google ao seu aplicativo no Pushwoosh.

   [Como configurar a Carteira do Google](/pt/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2. **Crie o passe**

   Abra o construtor de passes em **Campaigns → Wallet Passes**, escolha um tipo de passe, adicione sua marca e campos, e verifique a pré-visualização ao vivo.

   [Criar passes da Carteira do Google no construtor de passes](/pt/product/messaging-channels/google-wallet-passes/pass-builder/)

3. **Crie o passe**

   Quando o passe estiver com a aparência correta, clique em **Generate** no [construtor de passes](/pt/product/messaging-channels/google-wallet-passes/pass-builder/#generate-the-pass).

4. **Envie o passe para os usuários**

   Compartilhe o link para salvar ou um código QR de **All passes**. Veja [Compartilhar o passe com os usuários através dos canais do Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). Para enviar um passe para cada usuário em escala, sua equipe de desenvolvimento pode usar a [API da Carteira do Google](/pt/developer/api-reference/google-wallet-api/).

5. **Atualize o passe**

   Em [**All passes**](#view-and-manage-existing-passes), clique em **Edit** no passe, ou atualize-o através da [API da Carteira do Google](/pt/developer/api-reference/google-wallet-api/). Quando você salva, o Google entrega a atualização para cada dispositivo que salvou o passe. Os usuários não precisam salvá-lo novamente.

6. **Envie mensagens aos portadores de passes**

   Assim que os usuários salvam o passe, você pode alcançá-los com um push único ou uma Customer Journey automatizada.

   [Enviar mensagens aos portadores de passes da Carteira do Google](/pt/product/messaging-channels/google-wallet-passes/message-pass-holders/)

</Steps>

## Ver e gerenciar passes existentes

No Painel de Controle, vá para **Campaigns → Wallet Passes** e abra a aba **Google Wallet**. A tabela **All passes** lista todos os passes para o aplicativo, incluindo o nome do passe, estilo, o [ID do Usuário](/pt/product/pushwoosh-knowledge-hub/users-userids/) ao qual está vinculado, seu estado e quando foi atualizado pela última vez.

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

* **Edit:** alterar valores e rótulos de campos, cores, URLs de logotipo e imagem principal, código de barras, links, locais e expiração. O tipo de passe permanece bloqueado após a criação. Quando você salva, cada dispositivo que salvou o passe recebe a atualização.

<Aside type="note" title="Atualizações e notificações de passes">
Quando você salva as alterações, o passe é atualizado em todos os dispositivos que o salvaram. Se a opção **Notify about changed fields** estiver ativada (por padrão), o Google também envia uma notificação do Android para os portadores.

As notificações são suportadas para passes de **fidelidade**, **ingresso para evento** e **voo**. O Google gera o texto da notificação automaticamente com base nos campos alterados. Para passes de evento e voo, as notificações só são disparadas se faltarem menos de 3 horas para o horário de início, e o Google as limita a 3 por passe a cada 24 horas.

Para enviar sua própria mensagem aos portadores de passes, veja [Enviar mensagens aos portadores de passes da Carteira do Google](/pt/product/messaging-channels/google-wallet-passes/message-pass-holders/).
</Aside>

* **Send message:** abrir o compositor de Push Único para enviar mensagens aos portadores de passes. Veja [Enviar mensagens aos portadores de passes da Carteira do Google](/pt/product/messaging-channels/google-wallet-passes/message-pass-holders/) para todas as formas de alcançá-los.
* **QR code:** mostrar um código QR que codifica o link para salvar o passe. Os usuários o escaneiam para salvar o passe na Carteira do Google e registrar seu dispositivo para atualizações.
* **Copy install link:** copiar o link para salvar o passe para compartilhar em seus canais de mensagens. [Saiba mais](#share-the-pass-with-users-via-pushwoosh-channels).
* **Invalidate:** definir um passe ativo como inativo. O passe é movido para a seção **Passes expirados** do usuário na Carteira do Google. O registro permanece no Pushwoosh.
* **Activate:** definir um passe inativo de volta para ativo. Esta opção aparece no menu de ações apenas quando o passe está inativo. Restaura o passe na Carteira do Google.
* **Delete:** invalidar o passe no Google e remover seu registro no Pushwoosh. O Google não permite a remoção forçada de um passe já salvo em um dispositivo. Ele se torna inválido e é movido para **Passes expirados**.


## Compartilhar o passe com os usuários através dos canais do Pushwoosh

O link **Adicionar à Carteira do Google** é uma URL regular (`https://pay.google.com/gp/v/save/...`). Abri-lo em um dispositivo solicita que o usuário salve o passe na Carteira do Google. 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 à Carteira do Google".
* **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).

## Gerenciar passes via API

Tudo o que o construtor de passes faz também está disponível programaticamente através da API da Carteira do Google: criar, atualizar, listar, obter um link para salvar, definir o estado e excluir passes.

<LinkCard title="API da Carteira do Google" href="/developer/api-reference/google-wallet-api/" />

## Ver portadores de passes no User Explorer

Quando um usuário salva seu passe, o Pushwoosh o lista na aba **Devices and platforms** no [User Explorer](/pt/product/audience-data-and-segmentation/user-explorer/).

1. Vá para **Audience → User Explorer** e abra o perfil do usuário.
2. Abra a aba **Devices and platforms**.
3. Selecione **Google Wallet** na barra lateral.

No perfil da plataforma, você pode revisar:

* **Subscription status:** por exemplo, **SUBSCRIBED**
* **Platform identifier:** o identificador do passe mostrado sob o nome da plataforma
* **Metadata:** **First subscription**, **Timezone** 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)