# Envie uma experiência de app no Apple Messages

Use **App experience** quando sua organização já possui um app iMessage publicado ou um App Clip que o cliente pode abrir. Bird envia a interação; o desenvolvimento, a publicação e o comportamento em dispositivos compatíveis continuam sendo responsabilidade da sua equipe de app.

Peça à equipe de app a identidade publicada, o formato do payload e um procedimento de teste antes de criar a mensagem. Uma URL que aponta para um site comum não o transforma em um app iMessage.

## Configure um app iMessage publicado

1. Abra [**Templates**](https://bird.com/dashboard/w/apple-messages/templates) e selecione **New template > App experience**.
2. Insira o nome do rascunho, o **Title** e a **Message** em **Content**.
3. Em **Apple delivery**, defina **App experience** como **Published iMessage app**.
4. Preencha os campos fornecidos pela sua equipe de app:

| Campo                    | O que identifica                                                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| **Published app ID**     | O identificador do app publicado.                                                                                        |
| **App name**             | O nome exibido para a interação.                                                                                         |
| **PNG app icon URL**     | A URL pública do ícone; siga as [restrições de mídia](/docs/guides/apple-messages/attachments#prepare-a-fetchable-file). |
| **Extension identifier** | A identidade da extensão no formato `com.apple.messages.MSMessageExtensionBalloonPlugin:team-id:extension-id`.           |
| **App payload URL**      | Conteúdo interpretado pelo seu app, como os parâmetros de visualização de pedido acordados.                              |
| **Session identifier**   | O valor de sessão da interação do app.                                                                                   |
| **App bubble layout**    | **Static layout** ou **Live layout**, conforme a implementação do app.                                                   |

Personalize os balões de recebimento e resposta se necessário. Selecione o negócio, salve o rascunho e [prepare a mensagem](/docs/guides/apple-messages/templates#send-the-reviewed-template).

## Configure uma prévia de App Clip

No mesmo tipo de mensagem, escolha **App Clip preview** em **App experience** e informe a **App Clip URL**. A preparação obtém a prévia gerada pela Apple para a URL compatível. A publicação e a invocação do App Clip já devem estar configuradas pela equipe do app.

## Verifique o app em um dispositivo

Envie para uma conversa de teste autorizada em um dispositivo compatível com o app. Abra a mensagem e confirme que o app ou App Clip correto processa o payload. Siga a ação pretendida até o resultado final, incluindo cancelamento e um registro de negócio ausente ou expirado.

A prévia no navegador do Bird não instala nem executa o app. Verificações de capacidade integradas conhecidas não confirmam que um app personalizado está instalado ou funciona. Ofereça uma alternativa web ou por texto para clientes que não conseguem concluir a interação.

Se a preparação ou o processamento falhar, inspecione o erro, a identidade publicada, a URL do ícone e o formato do payload. Use o [histórico de mensagens](/docs/guides/apple-messages/messages) para separar um envio com falha de um app que abriu mas não conseguiu concluir sua ação de negócio.