# Integre uma jornada do cliente no Apple Messages

Conecte identidade comercial, conteúdo nativo, respostas do cliente e resultados de negócio por meio do contrato Bird atual.

## Pré-requisitos

Prepare um espaço de trabalho Bird, uma empresa aprovada pela Apple, credenciais com escopo definido e uma conversa de teste autorizada. [Entre em contato com um especialista em Apple Messages](/demo?product=apple-messages) para confirmar o acesso ao espaço de trabalho e obter o contrato de operação suportado para sua integração. Conecte seu agente de código ao servidor MCP de Bird ou use o cliente API da sua aplicação, com o mesmo espaço de trabalho e as mesmas permissões de negócio.

## 1. Mapeie os dois caminhos de endereçamento

Respostas comuns usam a identidade Apple da conversa aberta. Convites usam uma operação aprovada separada, endereçada por telefone, com opt-in explícito. Leia os campos reais e o público da operação antes de implementar qualquer um dos caminhos.

## 2. Prepare a troca nativa

Escolha um tipo de conteúdo suportado e uma resposta esperada específica. Preserve as referências de negócio, conversa, solicitação e mensagem na sua aplicação. Mantenha credenciais e conteúdo privado de mensagens fora de exemplos públicos.

## 3. Verifique o dispositivo e a resposta

Envie pelo caminho de teste aprovado, inspecione a renderização nativa e retorne uma resposta. Correlacione essa entrada com a solicitação original e valide-a antes de executar uma ação de negócio.

## 4. Trate resultados assíncronos

Um envio aceito pelo gateway da Apple é registrado como enviado; não é uma confirmação de entrega no dispositivo nem de leitura. Mantenha o processamento de mensagens separado do resultado de pedido, reserva ou identidade. Considere observações repetidas ou fora de ordem sem presumir ordem universal de entrega ou deduplicação pelo provedor. Siga a [explicação de status](/explained/apple-messages/does-sent-mean-delivered-or-read) ao decidir qual evento pode avançar a tarefa do cliente.

## 5. Construa e revise com um agente de código

Conecte o agente por meio do [servidor Bird MCP](/docs/ai/mcp-server). Peça a ele que inspecione o espaço de trabalho, o negócio e o conteúdo existente antes de propor alterações. Forneça o contrato de operação do Apple Messages, este guia e um modelo de aplicação com dados sensíveis removidos.

Peça ao agente que prepare mensagens nativas e ramificações de jornada e, em seguida, teste uma troca bem-sucedida e um caso materialmente diferente de recusa ou resposta incerta. Revise o conteúdo exato, as ações conectadas e as permissões antes de publicar. Exija confirmação para contato com o cliente e ações de negócio com consequências. Inspecione a operação original antes de tentar novamente.

## Verifique a integração nos seus limites

Use uma escolha nativa de agendamento como troca de teste. Rastreie a empresa aprovada e a conversa, a solicitação de saída, a resposta selecionada pelo cliente e a reserva confirmada. Esses são registros conceituais para correlacionar na sua aplicação; use os nomes de campo reais e os formatos de operação do contrato disponível no seu espaço de trabalho.

| Caso de teste                                     | Ação                                                                                   | Resultado esperado                                                    |
| ------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| A mesma resposta do cliente é observada novamente | Resolva-a com base na solicitação já registrada e na operação da aplicação.            | Uma observação repetida não cria outra reserva.                       |
| A aplicação nega a ação de negócio                | Retorne uma recusa útil ou alternativa sem alterar o resultado da ação.                | O cliente não é informado de que a reserva ou compra foi concluída.   |
| Um agente prepara uma revisão de jornada          | Inspecione o conteúdo, as ações conectadas e as permissões efetivas antes de publicar. | A experiência publicada corresponde à revisão que sua equipe revisou. |

## Solução de problemas

Se uma operação for recusada, verifique o espaço de trabalho, a aprovação do negócio e as permissões da conta. Se uma mensagem for aceita mas a tarefa do cliente falhar, inspecione a renderização no dispositivo e o sistema de negócio conectado separadamente. Use operações API publicadas exatas em vez de adaptar o nome de método de outro fornecedor por suposição.

## Próximos passos

- [Explore a capacidade relacionada do Apple Messages](/products/apple-messages/api).
- [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)

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