Recolocar mensagens de notificação por push com falha na fila

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 colocá-las na fila 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 mensagem por push. Para obter mais informações sobre como a Apple lida com notificações por push, consulte Guia de programação de notificação local e remota Para desenvolvedores da Apple.

    As mensagens também podem falhar ao enviar por vários motivos, como uma fila de mensagens grande ou outro problema com a instância. Você pode usar um 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 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. Se necessário, você pode mudar o filtro. 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 com falha na lista de seleção.
    3. Se algumas notificações por push continuarem a falhar, considere aumentar o valor em glide.push.notification.ttl_secondspropriedade.
      Para obter mais informações, consulte Propriedades de notificação por push.