# Conectar um passe do Wallet ao Apple Messages

Ofereça ao cliente um passe que ele possa salvar e consultar para um agendamento, evento ou serviço. Conecte o passe emitido ao registro que contém os detalhes e adicione um ponto de entrada do Messages para ajuda com essa tarefa.

## Pré-requisitos

Prepare o emissor de passes e a configuração de assinatura da empresa, o sistema de reservas ou serviços e uma empresa aprovada no Apple Messages. Defina um responsável pela emissão de passes, atualizações e suporte ao cliente. Use um ambiente de teste autorizado e um dispositivo de teste.

## 1. Escolha o registro de serviço

Comece com uma reserva ou serviço confirmado. Identifique os campos que pertencem ao passe: um nome de empresa reconhecível, data, horário, local e referência útil. Recupere os valores do registro que contém o serviço.

Mantenha uma reserva proposta distinta de uma confirmada. Um passe deve refletir o estado com o qual o cliente pode contar. Siga o [guia de agendamentos](/docs/guides/apple-messages/appointments) quando o passe representar uma reserva.

## 2. Prepare a emissão e as atualizações

Conecte o emissor de passes ao registro de serviço e mantenha a associação entre o passe original e esse registro. Configure a identidade visual e os detalhes que o cliente precisa no momento do uso. Siga os [requisitos de identificador e assinatura de passes](https://developer.apple.com/help/account/capabilities/create-wallet-identifiers-and-certificates) da Apple e o fluxo de distribuição do emissor. Configure o [serviço de atualização de passes](https://developer.apple.com/documentation/walletpasses/adding-a-web-service-to-update-passes) para que as alterações cheguem ao passe existente.

Teste o passe emitido no dispositivo pretendido. Confirme que os detalhes exibidos correspondem ao registro de serviço e permanecem legíveis no tamanho de texto normal.

## 3. Adicione o ponto de entrada da conversa

Conecte o passe à empresa aprovada no Apple Messages com a intenção de serviço e o grupo de atendimento relevantes. Use uma referência segura para a tarefa; mantenha credenciais de conta e detalhes protegidos fora de URLs públicas.

Abra o ponto de entrada do passe, envie uma primeira mensagem e confirme que a equipe pretendida recebe a conversa. Recupere informações protegidas de reserva ou conta por meio das verificações de identidade normais. Use o [guia de pontos de entrada](/docs/guides/apple-messages/entry-points) para contexto e roteamento.

## 4. Atualize após a ação do negócio ser bem-sucedida

Quando um cliente altera uma reserva, valide a disponibilidade e confirme a alteração no sistema de reservas. Atualize o passe existente com o horário e local registrados. O passe salvo e a conversa agora devem descrever o mesmo agendamento.

Se o resultado da reserva for incerto, inspecione a operação original antes de emitir outra atualização. Não substitua um horário confirmado por uma solicitação não confirmada.

## 5. Teste cancelamento e suporte

Cancele uma reserva de teste e confirme que o passe reflete o estado cancelado. Verifique expiração, local alterado, serviço de atualização indisponível e um cliente que continua por outro canal. Preserve uma forma útil de contatar a equipe de atendimento.

Salvar um passe não estabelece permissão para uma Mensagem de Convite. Mantenha o [caminho de consentimento e aprovação de convite](/docs/guides/apple-messages/invitations) separado da distribuição de passes.

## Verifique uma atualização de passe de ponta a ponta

Salve um passe de exemplo autorizado e altere o agendamento no seu sistema de reservas. Publique o novo conteúdo do passe por meio do seu serviço de passes usando a mesma identidade de passe e verifique os detalhes atualizados no dispositivo. Verifique também a confirmação voltada ao cliente no Messages; ela deve descrever a alteração que o sistema de reservas registrou.

| Caso de teste                              | Ação                                                                     | Resultado esperado                                                                           |
| ------------------------------------------ | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| O cliente não salvou o passe               | Mantenha os detalhes do agendamento confirmado disponíveis na conversa.  | O cliente pode usar o serviço sem adicionar um passe.                                        |
| O agendamento muda após a emissão          | Atualize o passe existente após a alteração da reserva ser bem-sucedida. | O passe mantém sua identidade e exibe os novos detalhes confirmados.                         |
| O cliente abre a rota de contato comercial | Leve o contexto de serviço apropriado para a conversa.                   | A equipe de atendimento pode identificar a visita sem expor dados de conta não relacionados. |

## Solução de problemas

Se o passe estiver desatualizado, compare o registro do negócio, o estado do emissor e o resultado da atualização antes de gerar um substituto. Se o link do Messages abrir a equipe errada, inspecione a identidade da empresa e o contexto do ponto de entrada. Se um cliente não conseguir adicionar o passe, forneça os detalhes do serviço confirmado por uma alternativa apropriada.

## Próximos passos

- [Explorar passes do Wallet e Messages](/products/apple-messages/wallet).
- [Conectar o agendamento de compromissos](/docs/guides/apple-messages/appointments).
- [Construir a jornada completa](/docs/guides/apple-messages/journeys).

## Related resources

- [What is Apple Messages for Business?](/explained/apple-messages/what-is-apple-messages-for-business) (answer)
- [Apple Messages for Business](/products/apple-messages) (product)
- [Integrate an Apple Messages customer journey](/docs/guides/apple-messages/api) (docs)

[Get an implementation brief](/learn/workspace?topic=apple-messages)