Falha ao enfileirar novamente mensagens de notificação por push

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A entrega de notificação por push pode falhar por vários motivos. Você pode exibir quais mensagens falharam e enfileirar novamente para serem enviadas, se necessário.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Não há como a instância garantir ou confirmar a entrega de mensagens por push. Para obter mais informações sobre como a Apple lida com notificações por push, consulte o Guia de programação de notificação local e remota para desenvolvedores da Apple.

    As mensagens também podem falhar no envio por vários motivos, como uma fila de mensagens grande ou outro problema com a instância. Você pode usar uma propriedade do sistema para controlar por quanto tempo a instância enfileira uma notificação por push depois que ela é acionada.

    O tamanho da carga da mensagem de notificação por push é limitado pelo provedor:
    • Apple iOS: 2.048 bytes
    • Google: 4.096 bytes
    Sua instância não envia mensagens por push que excedem essa limitação. Os logs do sistema salvam todas as mensagens com falha. Para obter detalhes sobre as limitações de carga da Apple, consulte o Guia de programação de notificação local e remota para desenvolvedores da Apple.

    Procedimento

    1. Navegar até Tudo > Logs do sistema > Notificações por push.
      Por padrão, as mensagens que foram criadas hoje são exibidas. Você pode mudar o filtro, se necessário. A coluna Tipo pode ter estes valores:
      • falha: a mensagem não pôde ser enviada.
      • pendente: a mensagem está na fila para processamento.
      • sucesso: a mensagem foi enviada com sucesso, embora não tenha necessariamente sido recebida pelo dispositivo móvel.
    2. Coloque todas as mensagens com falha de volta na fila para serem reenviadas marcando as caixas de seleção ao lado das mensagens com falha e selecionando Reenfileirar notificações por push de falha na lista de seleção.
    3. Se algumas notificações por push continuarem a falhar, considere aumentar o valor na propriedade glide.push.notification.ttl_seconds.
      Para obter mais informações, consulte Propriedades da notificação por push.