# Ispezionare la cronologia e gli errori di Apple Messages

Usa [**Apple Messages > Messages**](https://bird.com/dashboard/w/apple-messages/messages) quando ti serve il risultato registrato di un messaggio specifico. Usa [Conversations](/docs/guides/apple-messages/conversations) quando ti serve lo scambio circostante con il cliente.

## Trovare e aprire un messaggio

1. Apri **Messages** nello spazio di lavoro proprietario del business.
2. Scegli **All**, **Received** o **Sent** per filtrare per direzione. Usa **Business** quando disponibile e la timeline per restringere il periodo dello scambio.
3. Apri il record corrispondente. In **Details**, controlla **Business ID**, **Conversation ID**, **Content type** e **Source**. Controlla lo stato e il timestamp nell'intestazione.
4. In **Events**, ispeziona il contenuto del messaggio, la cronologia degli eventi e gli eventuali dettagli dell'errore. Conserva l'ID del messaggio quando segnali il problema.

![Dettagli del messaggio che mostrano lo stato Sent, gli identificativi del business e della conversazione, il tipo di contenuto e la sorgente operatore.](/images/docs/dashboard-apple-messages.png)

[Visualizza lo screenshot a grandezza originale](/images/docs/dashboard-apple-messages.png).

Dopo l'invio di un template, **View message and events** apre direttamente il record inviato.

## Comprendere lo stato

| Stato           | Significato                                                               | Azione successiva                                                                        |
| --------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Accepted**    | Bird ha accodato la richiesta in uscita per l'elaborazione.               | Attendi l'elaborazione e controlla gli eventi successivi.                                |
| **Sent**        | Il gateway di Apple ha accettato il messaggio.                            | Verifica separatamente l'interazione con il cliente.                                     |
| **Send failed** | L'elaborazione o l'invio dal provider non è riuscito dopo l'accettazione. | Controlla l'errore e l'eventuale accettazione precedente prima di decidere se riprovare. |
| **Rejected**    | Bird ha rifiutato il messaggio prima di qualsiasi tentativo di invio.     | Leggi il motivo registrato, incluso qualsiasi problema di fatturazione.                  |
| **Received**    | Bird ha registrato un messaggio in arrivo dal cliente.                    | Apri la conversazione e gestisci la richiesta.                                           |

Bird non fornisce conferme di consegna al dispositivo Apple né conferme di lettura. L'azione **Mark as read** di un operatore modifica lo stato della casella di posta, non questo stato. Un invio riuscito non dimostra nemmeno che una prenotazione, un pagamento o un'azione sull'account sia andata a buon fine.

Un risultato **Send failed** può anche derivare dalla perdita della conferma del provider dopo che Apple ha accettato il messaggio. Non è la prova che il cliente non abbia ricevuto nulla. Controlla l'errore e la cronologia dei tentativi prima di riprovare; un nuovo messaggio può duplicare l'originale.

## Indagare su un invio non riuscito o incerto

Parti dall'errore presente nel record anziché inviare subito un altro messaggio.

- **Errore media:** verifica che l'URL di origine sia pubblico HTTPS, che serva il file e il tipo di media previsti e che soddisfi i [requisiti media](/docs/guides/apple-messages/attachments). Un browser che ha effettuato l'accesso all'host del file può nascondere un problema di autorizzazione.
- **Errore business o conversazione:** controlla l'approvazione del business e lo stato della conversazione. Il cliente deve riaprire una conversazione chiusa.
- **Destinazione soppressa:** controlla le [Soppressioni](/docs/guides/apple-messages/suppressions), incluse le voci specifiche per il business e quelle a livello di spazio di lavoro.
- **Rifiuto per fatturazione:** chiedi all'amministratore della tua organizzazione di risolvere il problema di fatturazione registrato prima di un nuovo invio.
- **Nessun esito finale:** aggiorna il dettaglio e conserva l'ID del messaggio. L'accettazione è asincrona; un secondo invio può creare un duplicato se il primo è andato a buon fine.

Per le chiamate API, conserva la [chiave di idempotenza](/docs/guides/idempotency) originale per i tentativi della stessa richiesta. Nella finestra di revisione del template, **Retry this send** mantiene il tentativo finché destinatario e contenuto restano invariati.

## Ispezionare una risposta strutturata del cliente

Apri la conversazione correlata per visualizzare una risposta nativa con la relativa etichetta rivolta al cliente. Confrontala con le scelte, le fasce orarie o le pagine del modulo che hai inviato. La tua integrazione dovrebbe usare identificatori stabili per eseguire un'azione di business; le etichette tradotte e le posizioni delle righe possono cambiare.

Se la risposta registrata non è chiara, raccogli gli ID dei messaggi inviati e ricevuti e una cattura del dispositivo oscurata. Usa la [checklist di supporto](/docs/guides/apple-messages/troubleshooting#contact-support) invece di inviare credenziali o record del cliente non oscurati.

## Passaggi successivi

- [Consulta le metriche del canale](/docs/guides/apple-messages/analytics) per verificare se il problema riguarda anche altri messaggi.
- [Risolvi i problemi del canale](/docs/guides/apple-messages/troubleshooting) in caso di conversazioni mancanti o contenuti non supportati.