# Inspecionar histórico e falhas do Apple Messages

Use [**Apple Messages > Messages**](https://bird.com/dashboard/w/apple-messages/messages) quando precisar do resultado registrado de uma mensagem específica. Use [Conversations](/docs/guides/apple-messages/conversations) quando precisar da troca com o cliente ao redor.

## Encontrar e abrir uma mensagem

1. Abra **Messages** no espaço de trabalho que possui o negócio.
2. Escolha **All**, **Received** ou **Sent** para filtrar por direção. Use **Business** quando disponível e a linha do tempo para restringir o período da troca.
3. Abra o registro correspondente. Em **Details**, verifique **Business ID**, **Conversation ID**, **Content type** e **Source**. Verifique o status e o timestamp no cabeçalho.
4. Em **Events**, inspecione o conteúdo da mensagem, o histórico de eventos e quaisquer detalhes de erro. Guarde o ID da mensagem ao reportar o problema.

![Detalhes da mensagem mostrando o status Sent, os identificadores de negócio e conversa, tipo de conteúdo e origem do operador.](/images/docs/dashboard-apple-messages.png)

[Veja a captura de tela em tamanho completo](/images/docs/dashboard-apple-messages.png).

Após um envio de template, **View message and events** abre o registro enviado diretamente.

## Entender o status

| Status          | Significado                                                       | Sua próxima ação                                                                             |
| --------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Accepted**    | Bird enfileirou a solicitação de saída para processamento.        | Aguarde o processamento e inspecione os eventos subsequentes.                                |
| **Sent**        | O gateway da Apple aceitou a mensagem.                            | Verifique a interação com o cliente separadamente.                                           |
| **Send failed** | O processamento ou o envio pelo provedor falhou após a aceitação. | Inspecione o erro e a possível aceitação anterior antes de decidir se deve tentar novamente. |
| **Rejected**    | Bird recusou a mensagem antes de qualquer tentativa de envio.     | Leia o motivo registrado, incluindo qualquer problema de cobrança.                           |
| **Received**    | Bird registrou uma mensagem recebida do cliente.                  | Abra a conversa e trate a solicitação.                                                       |

Bird não fornece confirmações de entrega no dispositivo Apple nem de leitura. A ação **Mark as read** de um operador altera o estado da caixa de entrada, não este status. Um envio bem-sucedido também não comprova que uma reserva, pagamento ou ação de conta foi concluída.

Um resultado **Send failed** também pode ocorrer após a perda de uma confirmação do provedor depois que a Apple aceitou a mensagem. Isso não prova que o cliente não recebeu nada. Verifique o erro e o histórico de tentativas antes de tentar novamente; uma nova mensagem pode duplicar a original.

## Investigue um envio com falha ou incerto

Comece pelo erro no registro em vez de enviar outra mensagem imediatamente.

- **Erro de mídia:** verifique se a URL de origem é pública HTTPS, se entrega o arquivo e o tipo de mídia esperados e se atende aos [requisitos de mídia](/docs/guides/apple-messages/attachments). Um navegador conectado ao host do arquivo pode ocultar um problema de autorização.
- **Erro de negócio ou conversa:** inspecione a aprovação do negócio e o status da conversa. O cliente precisa reabrir uma conversa encerrada.
- **Destino suprimido:** revise as [Supressões](/docs/guides/apple-messages/suppressions), incluindo entradas específicas do negócio e do espaço de trabalho.
- **Rejeição de cobrança:** peça ao administrador da organização para resolver o problema de cobrança registrado antes de enviar novamente.
- **Sem resultado final ainda:** atualize o detalhe e guarde o ID da mensagem. A aceitação é assíncrona; um segundo envio pode criar uma duplicata se o primeiro foi bem-sucedido.

Para chamadas API, mantenha a [chave de idempotência](/docs/guides/idempotency) original ao tentar novamente a mesma solicitação. No diálogo de revisão do template, **Retry this send** mantém a tentativa enquanto o destinatário e o conteúdo permanecem inalterados.

## Inspecionar uma resposta estruturada do cliente

Abra a conversa relacionada para ver a resposta nativa com o rótulo exibido ao cliente. Compare-a com as opções, horários ou páginas de formulário que você enviou. Sua integração deve usar identificadores estáveis ao executar uma ação de negócio; rótulos traduzidos e posições de linha podem mudar.

Se a resposta registrada não estiver clara, colete os IDs das mensagens enviadas e recebidas e uma captura de tela do dispositivo com dados sensíveis removidos. Use o [checklist de suporte](/docs/guides/apple-messages/troubleshooting#contact-support) em vez de enviar credenciais ou registros de clientes sem ocultar dados sensíveis.

## Próximos passos

- [Leia as métricas do canal](/docs/guides/apple-messages/analytics) para verificar se o problema afeta outras mensagens.
- [Solucione problemas do canal](/docs/guides/apple-messages/troubleshooting) para conversas ausentes ou conteúdo não suportado.