# Envie mensagens para portadores de passes da Wallet

Assim que um usuário adiciona seu passe, o Pushwoosh o registra como uma assinatura de plataforma (Apple Wallet ou Google Wallet) vinculada a esse [User ID](/pt/product/pushwoosh-knowledge-hub/users-userids/).

Você pode alcançar os portadores de várias maneiras: enviar uma atualização de passe, enviar um push único, automatizar mensagens de uma Customer Journey ou notificar os portadores de um passe específico via API.

## Enviar uma atualização de passe

Editar um passe e salvá-lo envia a nova versão para todos os dispositivos que o adicionaram, sem uma mensagem separada. A forma como você alerta os portadores sobre a alteração difere por plataforma.

### Apple Wallet

Defina uma **Mensagem de alteração** em qualquer campo sobre o qual você queira que os portadores sejam alertados; o iOS a exibe como uma mensagem na tela de bloqueio. Campos sem uma mensagem de alteração são atualizados silenciosamente.

1. Em **Campaigns → Wallet Passes → Apple Wallet**, encontre o passe e clique em **Editar** no menu de ações.
2. Altere os campos que precisar e adicione uma mensagem de alteração a qualquer campo sobre o qual você queira que os portadores sejam alertados.
3. Clique em **Salvar**.

### Google Wallet

Para passes de fidelidade, ingressos de eventos e passes de voo, ative **Notificar sobre campos alterados** para que o Google envie uma notificação do Android junto com a sincronização. Outros tipos de passe são sincronizados silenciosamente.

1. Em **Campaigns → Wallet Passes → Google Wallet**, encontre o passe e clique em **Editar** no menu de ações.
2. Altere os campos que precisar.
3. Certifique-se de que [**Notificar sobre campos alterados**](/pt/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes) esteja ativado.
4. Clique em **Salvar alterações**.

<Aside type="note" title="Passes de eventos e voos">
- O Google gera o texto da notificação; você não pode personalizá-lo como uma mensagem de alteração da Apple Wallet.
- Para passes de eventos e voos, a notificação só é disparada se restarem menos de 3 horas para o horário de início.
- O Google permite no máximo 3 notificações por passe a cada 24 horas. Se o limite for atingido, o passe é atualizado silenciosamente.
</Aside>

## Enviar um push único para portadores de passes

Envie um push autônomo para um portador de passe ou para um público mais amplo. Ele aparece como uma mensagem na tela de bloqueio em um passe da Apple Wallet ou como uma notificação em um passe do Google Wallet.

1. Abra o compositor de push único. Clique em **Enviar mensagem** em **Campaigns → Wallet Passes → Apple Wallet** ou **Google Wallet**, ou vá para **Campaigns → One-Time Messages** e clique em **Enviar mensagem → Push único**.
2. Na etapa **Conteúdo**, escreva a mensagem ou selecione uma predefinição.
3. Na etapa **Público**, defina quem recebe a mensagem. O padrão depende de onde você abriu o compositor:

   * **A partir de Enviar mensagem em um passe:** **Enviar para usuários específicos** está selecionado, e **Destinatários (User IDs)** já lista o [User ID](/pt/product/pushwoosh-knowledge-hub/users-userids/) daquele portador de passe. Envie como está para alcançar aquele portador, ou altere o público:
     * Adicione mais User IDs em **Destinatários (User IDs)**
     * Mude para **Enviar para segmento**
     * Escolha **Enviar para todos os assinantes**
   * **A partir de Mensagens Únicas:** Defina o público como em um [push único](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#select-audience-for-push-notification) regular: **Enviar para usuários específicos**, **Enviar para segmento** ou **Enviar para todos os assinantes**.

<img src="/apple-wallet-passes-message-pass-holders-1.webp" alt="Etapa de público com Enviar para usuários específicos selecionado e o User ID do portador do passe pré-preenchido em Destinatários"/>

4. Em **Plataformas de destino**, selecione **Apple Wallet**, **Google Wallet** ou ambos.
5. Envie ou agende a mensagem.

<Aside type="note">
Quando você segmenta um público, a entrega é feita para os usuários nesse segmento que têm a plataforma correspondente registrada, não para todos que salvaram um passe específico.
</Aside>

## Automatizar mensagens de uma Customer Journey

Envie mensagens automaticamente com base em eventos ou segmentos.

### Jornada com entrada baseada em gatilho

<Aside type="caution" icon="setting" title="Assistência de desenvolvedor necessária">
O envio de eventos personalizados requer que sua equipe de desenvolvedores integre a chamada da API [`postEvent`](/pt/developer/api-reference/user-centric-api/#postevent) em seu backend ou CRM. Compartilhe esta seção com eles.
</Aside>

1. Crie uma [Customer Journey](/pt/product/customer-journey/pushwoosh-journey-overview/) e adicione uma [**Entrada baseada em gatilho**](/pt/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. Selecione o evento que deve iniciar a Jornada. Crie um evento personalizado no Painel de Controle primeiro, se ainda não o fez, por exemplo, `RewardAvailable`.
3. Adicione e configure um elemento de push. Ative [**Enviar por User ID**](/pt/product/customer-journey/journey-elements/channels/push/#send-by-user-id) para que o push alcance todos os dispositivos vinculados ao usuário, incluindo o passe salvo.
4. Conclua a configuração e ative a Jornada.

Quando o evento de entrada é disparado, o Pushwoosh envia o push para todos os dispositivos vinculados ao usuário. Os portadores de passes o recebem como uma mensagem na tela de bloqueio na Apple Wallet ou como uma notificação no Google Wallet. Usuários sem um passe da wallet o recebem em seus outros dispositivos.

<Aside type="tip" title="Conteúdo do passe">
O push não altera nenhum campo do passe. Para atualizar o conteúdo do passe junto com a mensagem, por exemplo, um saldo de pontos, atualize o passe separadamente:

* **Apple Wallet:** via **Editar** em [Todos os passes](/pt/product/messaging-channels/wallet-passes/apple-wallet/#view-and-manage-existing-passes), ou através da [API Apple PassKit](/pt/developer/api-reference/apple-wallet-passkit-api/).
* **Google Wallet:** via **Editar** em [Todos os passes](/pt/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes), ou através da [API Google Wallet](/pt/developer/api-reference/google-wallet-api/).
</Aside>

**Exemplo: Notificar um usuário que uma recompensa está disponível**

`POST https://api.pushwoosh.com/json/1.3/postEvent`

```json
{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}
```

O nome do `event` deve corresponder a um evento criado no seu Painel de Controle.

### Outras maneiras de construir a jornada

O fluxo baseado em gatilho acima é uma opção. Dependendo do que deve iniciar a jornada, escolha um [elemento de entrada](/pt/product/customer-journey/journey-elements/entry-elements/) diferente:

* **[Entrada baseada em público](/pt/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** inicie a jornada para um segmento inteiro em vez de um único evento. Execute-a uma vez, em um cronograma ou periodicamente (por exemplo, toda semana para todos que possuem um passe ativo), com novos usuários entrando à medida que se juntam ao segmento.
* **[Entrada baseada em API](/pt/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** inicie a jornada a partir de um evento de negócios que ocorre fora do aplicativo, como um atraso de voo ou mudança de portão. Seu sistema externo chama o modelo de solicitação do elemento de entrada e passa um filtro para segmentar os usuários corretos, por exemplo, todos que têm uma tag `flightNumber = SU1234` definida quando o passe foi emitido. Uma boa opção para cartões de embarque e ingressos de eventos.

## Notificar portadores de um passe específico via API

Para enviar uma mensagem para todos que salvaram um passe específico, chame **Atualizar um passe**. Isso atualiza o passe e notifica os dispositivos. No Google Wallet, defina `notifyMessage` para enviar uma notificação personalizada junto com a atualização; sem isso, o passe é sincronizado silenciosamente.

* **Apple Wallet:** <LinkCard title="Atualizar um passe" href="/developer/api-reference/apple-wallet-passkit-api/#update-a-pass" />
* **Google Wallet:** <LinkCard title="Atualizar um passe" href="/developer/api-reference/google-wallet-api/#update-a-pass" />