# Solução de problemas do Apple Messages for Business

Comece pelo sintoma abaixo. Verifique o negócio e o espaço de trabalho antes de alterar a configuração, e mantenha o ID da mensagem ou da conversa referente à troca que você está investigando.

## A conversa de teste não aparece

1. No Apple Business Register, confirme que a Apple Account do testador corresponde à conta usada no Messages no dispositivo e que as alterações do testador foram enviadas.
2. Compare a URL do ponto de entrada com o **Apple Business ID** no registro de negócio Bird.
3. Confirme que o testador enviou uma mensagem. Apenas abrir o link do negócio não gera uma mensagem de entrada.
4. Abra [**Conversas**](https://bird.com/dashboard/w/apple-messages/conversations) no espaço de trabalho vinculado, limpe os filtros e atualize.
5. Verifique a conexão do provedor no Apple Business Register. Se o dispositivo exibir um erro ou a vinculação falhar, colete esse erro e o horário para o suporte.

## O controle de resposta está desativado

Verifique o status da empresa em [**Businesses**](https://bird.com/dashboard/w/apple-messages/businesses), o status da conversa e sua permissão de escrita no canal. Uma resposta exige uma conversa aberta. Para uma empresa com status **Draft**, use uma conversa de teste autorizada; o lançamento público exige aprovação.

Para **Fechada pelo cliente**, o cliente precisa iniciar uma nova conversa. Alterar a atribuição, remover um rótulo ou encerrar uma supressão não reabre a conversa.

Se uma ação de gerenciamento ou atribuição estiver ausente, peça ao administrador que verifique suas permissões no mesmo espaço de trabalho.

## Não é possível preparar uma mensagem nativa

1. Leia o erro de validação e volte à aba **Apple delivery** do template.
2. Verifique os campos nativos obrigatórios, identificadores únicos, rotas de formulário e horários com data. Rótulos simples de pré-visualização não fornecem disponibilidade real de agendamento.
3. Forneça valores reais para cada variável. Os valores de exemplo de **Personalization** servem apenas para a pré-visualização.
4. Verifique **Device capabilities** na conversa. Se uma capacidade conhecida estiver ausente, ofereça uma alternativa por texto ou web. Uma capacidade não anunciada significa que o suporte é desconhecido.
5. Confirme que a empresa do template corresponde à conversa selecionada. Para uma empresa com status **Draft**, use uma conversa de teste autorizada.

Use o [guia de mensagem nativa](/docs/guides/apple-messages/rich-messages) específico para ajuda campo a campo na criação.

## Uma mensagem foi aceita, mas não apareceu no dispositivo

Abra [**Messages**](https://bird.com/dashboard/w/apple-messages/messages), selecione o registro e inspecione o status e os eventos. Para **Send failed** ou **Rejected**, use o motivo registrado para corrigir a solicitação. Mídia pode falhar após a aceitação se a URL estiver inacessível ou o arquivo baixado for inválido.

Para **Sent**, Bird tem a confirmação do gateway da Apple. A entrega e a leitura no dispositivo não são observáveis no Bird. Verifique o dispositivo de teste autorizado, sua conectividade e a conversa visível para o cliente antes de decidir enviar novamente. Mantenha a tentativa original ao tentar novamente; um novo envio pode duplicar a mensagem.

## Um destino está suprimido

Inspecione [Suppressions](/docs/guides/apple-messages/suppressions) para o identificador exato e tanto o escopo específico do negócio quanto o do espaço de trabalho inteiro. Mantenha os opt-outs válidos. Se o bloqueio foi adicionado incorretamente, estabeleça o motivo antes de encerrá-lo e depois verifique novamente o status do negócio e da conversa.

## Um template salvo está ausente

Os rascunhos de template ficam armazenados no navegador onde foram criados, no espaço de trabalho selecionado. Verifique o espaço de trabalho, o perfil do navegador e o dispositivo. Limpar os dados do site ou usar outro navegador pode remover o acesso ao rascunho. Bird não oferece atualmente uma biblioteca de templates compartilhada e armazenada no servidor, nem um histórico de recuperação para esses rascunhos.

Se **Salvar template** reportar um erro de armazenamento, preserve o texto criado e as configurações nativas antes de fechar a aba. Verifique a disponibilidade de armazenamento do navegador. Se outra aba salvou uma revisão mais recente, recarregue o rascunho mais atual e reaplique suas alterações deliberadamente.

## As métricas não correspondem a uma lista de mensagens

Confira o espaço de trabalho, o filtro de negócio, o intervalo de datas e o fuso horário. Relatórios de saída agrupam mensagens pelo horário de aceitação; relatórios de entrada e de conversa usam o horário do evento. Resultados de processamento recentes podem atualizar um período de saída anterior.

Consulte as [definições de métricas](/docs/guides/apple-messages/analytics) antes de combinar relatórios. Medições de primeira resposta ausentes não significam que o tempo de resposta foi zero, e o encerramento de uma conversa pelo cliente não comprova que o problema dele foi resolvido.

## Entre em contato com o suporte

Use [**Ajuda**](https://bird.com/dashboard/w/support) no espaço de trabalho afetado. Inclua:

- Os IDs do espaço de trabalho e do registro de negócio, além do Apple Business ID para problemas de conexão.
- Os IDs da conversa relevante e das mensagens enviadas ou recebidas.
- O registro de data e hora com fuso horário, o status e o código ou descrição do erro.
- O posicionamento do ponto de entrada ou o tipo de mensagem nativa e os passos exatos que reproduzem o problema.
- Uma captura de tela com dados sensíveis ocultados ou uma gravação do dispositivo quando o problema é visual.

Remova chaves de acesso, tokens de autenticação, dados de pagamento e informações desnecessárias do cliente. Compartilhe identificadores pelo suporte em vez de em uma issue pública. Informe se o problema é visível no Bird, em um dispositivo Apple ou no seu sistema externo de agendamento, pedidos ou identidade.