# Inviare un'esperienza app di Apple Messages

Usa **App experience** quando la tua organizzazione possiede già un'app iMessage pubblicata o un App Clip che il cliente può aprire. Bird invia l'interazione; lo sviluppo dell'app, la pubblicazione e il comportamento sui dispositivi compatibili restano responsabilità del tuo team di sviluppo app.

Chiedi al team di sviluppo app di fornire l'identità pubblicata, il formato del payload e una procedura di test prima di creare il messaggio. Un URL che punta a un normale sito web non lo trasforma in un'app iMessage.

## Configurare un'app iMessage pubblicata

1. Apri [**Templates**](https://bird.com/dashboard/w/apple-messages/templates) e seleziona **New template > App experience**.
2. Inserisci il nome della bozza, il **Title** e il **Message** in **Content**.
3. In **Apple delivery**, imposta **App experience** su **Published iMessage app**.
4. Compila i campi forniti dal tuo team di sviluppo app:

| Campo                    | Cosa identifica                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Published app ID**     | L'identificatore dell'app pubblicata.                                                                                       |
| **App name**             | Il nome mostrato per l'interazione.                                                                                         |
| **PNG app icon URL**     | L'URL pubblico dell'icona; segui i [vincoli per i media](/docs/guides/apple-messages/attachments#prepare-a-fetchable-file). |
| **Extension identifier** | L'identità dell'estensione in formato `com.apple.messages.MSMessageExtensionBalloonPlugin:team-id:extension-id`.            |
| **App payload URL**      | Contenuto interpretato dalla tua app, come i parametri concordati per la visualizzazione dell'ordine.                       |
| **Session identifier**   | Il valore di sessione dell'interazione con l'app.                                                                           |
| **App bubble layout**    | **Static layout** o **Live layout**, in base all'implementazione dell'app.                                                  |

Personalizza le bolle di ricezione e risposta se necessario. Seleziona il business, salva la bozza e [prepara il messaggio](/docs/guides/apple-messages/templates#send-the-reviewed-template).

## Configurare un'anteprima App Clip

Nello stesso tipo di messaggio, scegli **App Clip preview** in **App experience** e inserisci l'**App Clip URL**. La preparazione ottiene l'anteprima generata da Apple per l'URL supportato. La pubblicazione e l'invocazione dell'App Clip devono essere già configurate dal team dell'app.

## Verificare l'app su un dispositivo

Invia a una conversazione di test autorizzata su un dispositivo compatibile con l'app. Apri il messaggio e verifica che l'app o l'App Clip corretto gestisca il payload. Segui l'azione prevista fino al risultato finale, inclusa la cancellazione e un record business mancante o scaduto.

L'anteprima nel browser di Bird non installa né esegue l'app. I controlli di compatibilità integrati noti non confermano che un'app personalizzata sia installata o funzionante. Offri un'alternativa web o testuale per i clienti che non possono completare l'interazione.

Se la preparazione o l'elaborazione non riesce, controlla l'errore, l'identità pubblicata, l'URL dell'icona e il formato del payload. Usa la [cronologia messaggi](/docs/guides/apple-messages/messages) per distinguere un invio non riuscito da un'app che si è aperta ma non ha completato la propria azione di business.