# Use Apple Invitation Messages corretamente

Prepare um convite Apple aprovado, mantenha o consentimento explícito do cliente e diferencie o status de envio da aceitação pelo cliente e da atividade da conversa.

## Pré-requisitos

Conecte seu negócio Apple Messages no Bird e obtenha a aprovação separada da Apple para convites, abrangendo a empresa e o template. Prepare uma jornada de serviço que capture opt-in explícito para a finalidade definida. A Apple também exige versões compatíveis em cada dispositivo vinculado à Apple Account do destinatário; verifique os [requisitos atuais de Invitation Messages](https://register.apple.com/resources/messages/msp-rest-api/business-updates) antes de testar.

## 1. Defina a finalidade permitida do convite

Escolha uma continuação suportada, como mover uma solicitação de suporte existente para o Messages. Invitation Messages não são um disparo de campanha em massa para listas de números de telefone.

## 2. Registre a escolha do cliente

Explique o negócio e a finalidade antes de coletar o opt-in explícito. Mantenha a evidência de consentimento exigida pelo seu fluxo de trabalho. Use o caminho de convite endereçado por telefone separadamente das respostas comuns de conversa.

## 3. Use o template aprovado

Prepare os campos de convite suportados e o template aprovado pela Apple. Valide a elegibilidade do negócio e do dispositivo relevante por meio do fluxo documentado. Um template de mensagem reutilizável comum não é uma aprovação de convite.

## 4. Trate a resposta e a conversa

Mantenha o envio separado da aceitação ou recusa. Conecte a resposta do cliente ao convite e à solicitação de serviço de origem. Quando o cliente aceitar, continue pela identidade Apple da conversa com o contexto do caso disponível para a equipe receptora. Uma recusa encerra aquele caminho de convite. Sair de uma conversa é uma decisão de opt-out separada e deve interromper novos convites até que um novo consentimento seja obtido.

## 5. Prepare uma alternativa permitida

Configure uma alternativa permitida para um cliente que não pode continuar no Apple Messages. Associe o canal à finalidade do serviço e à preferência registrada, e leve o contexto original do caso para esse caminho. Mantenha erros de aprovação separados da elegibilidade do dispositivo ao decidir o que deve acionar o fallback. Inspecione um envio incerto antes de repeti-lo ou iniciar outro canal.

## Verifique as ramificações de resposta do cliente

Use uma empresa de teste e um template de convite aprovados. Registre um opt-in explícito para o serviço definido e então teste aceitação e recusa como casos separados. Inspecione o registro do convite, a conversa aberta quando aplicável e a solicitação de serviço original. A continuação deve seguir a escolha registrada do cliente.

| Caso de teste                                                | Ação                                                                   | Resultado esperado                                                            |
| ------------------------------------------------------------ | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| O cliente aceita o convite                                   | Associe a conversa resultante ao contexto de serviço prometido.        | A equipe receptora pode continuar a solicitação original.                     |
| O cliente recusa o convite                                   | Registre a resposta e mantenha a rota alternativa de serviço acordada. | O cliente não é tratado como tendo aberto uma conversa no Messages.           |
| O cliente não pode receber ou não dá continuidade ao convite | Use o fallback permitido definido para a solicitação de serviço.       | A solicitação permanece acionável sem reenviar repetidamente o mesmo convite. |

## Solução de problemas

Se um convite falhar, inspecione a aprovação do negócio/template, o endereço e as condições de dispositivo suportado. Dados de resposta ausentes não estabelecem aceitação nem recusa. Inspecione a solicitação existente antes de repetir um convite cujo resultado de envio é incerto.

## Resultados de envio

Um convite enfileirado está aguardando processamento. Um convite enviado foi aceito pelo gateway da Apple; isso não comprova entrega no dispositivo, leitura ou aceitação. Uma rejeição de cobrança significa que o envio não prosseguiu, enquanto uma falha de envio pode exigir investigação antes de tentar novamente. Use a [explicação de status](/explained/apple-messages/does-sent-mean-delivered-or-read) ao definir relatórios.

## Próximos passos

- [Explore a funcionalidade relacionada do Apple Messages](/products/apple-messages/invitations).
- [Encontre guias e respostas sobre Apple Messages](/products/apple-messages/resources).
- [Prepare sua primeira conversa completa](/products/apple-messages/getting-started).

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