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.

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 esteja ativado.
4. Clique em Salvar alterações.

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.

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 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 regular: Enviar para usuários específicos, Enviar para segmento ou Enviar para todos os assinantes.

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

Nota

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.

Automatizar mensagens de uma Customer Journey

Envie mensagens automaticamente com base em eventos ou segmentos.

Jornada com entrada baseada em gatilho

Assistência de desenvolvedor necessária

O envio de eventos personalizados requer que sua equipe de desenvolvedores integre a chamada da API postEvent em seu backend ou CRM. Compartilhe esta seção com eles.

1. Crie uma Customer Journey e adicione uma Entrada baseada em gatilho.
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 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.

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, ou através da API Apple PassKit.
• Google Wallet: via Editar em Todos os passes, ou através da API Google Wallet.

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

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

{
  "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 diferente:

• Entrada baseada em público: 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: 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:
  Atualizar um passe
• Google Wallet:
  Atualizar um passe