Sign inGet started

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 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 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. 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 testeAçãoResultado esperado
A mesma resposta do cliente é observada novamenteResolva-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ócioRetorne 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 jornadaInspecione 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

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Obtenha um resumo de implementação