Inspecionar histórico e falhas do Apple Messages
Use Apple Messages > Messages quando precisar do resultado registrado de uma mensagem específica. Use Conversations quando precisar da troca com o cliente ao redor.
Encontrar e abrir uma mensagem
- Abra Messages no espaço de trabalho que possui o negócio.
- 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.
- Abra o registro correspondente. Em Details, verifique Business ID, Conversation ID, Content type e Source. Verifique o status e o timestamp no cabeçalho.
- 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.
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. 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, 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 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 em vez de enviar credenciais ou registros de clientes sem ocultar dados sensíveis.
Próximos passos
- Leia as métricas do canal para verificar se o problema afeta outras mensagens.
- Solucione problemas do canal para conversas ausentes ou conteúdo não suportado.