Entrega confirmada

​

Visão geral

Fluxo de entregas confirmadas

• iOS & Safari: Apple Push Notification Service (APNs)
• Android & Chrome: Google Firebase Cloud Messaging (FCM)
• Dispositivos Huawei: Huawei Messaging Service (HMS)
• Dispositivos Amazon: Amazon Device Messaging (ADM)
• Dispositivos Windows: Microsoft Push Notification Service (MPNS)

• O ID da notificação
• O ID de assinatura do dispositivo

​

Requisitos

• Disponível apenas em planos pagos. Compare planos.
• Complete a Configuração do SDK móvel, incluindo:
  • iOS Notification Service Extension
  • Configuração de App Group
• A Entrega Confirmada só funciona se o dispositivo tiver o SDK do OneSignal instalado.
  • Não suportado para assinaturas criadas apenas via API.

​

Limitações específicas de plataforma

​

iOS

• Requer tanto a Notification Service Extension quanto a configuração de App Group.
• O APNs mantém apenas uma mensagem por aplicativo quando offline. Se múltiplos pushes forem enviados enquanto offline, apenas o mais recente é entregue.

​

Huawei

• Suportado apenas para o data tipo de mensagem Huawei.
• Para o tipo message, a Huawei fornece dados de recibo apenas em seu próprio painel.

​

Web

• O Safari não suporta Entrega Confirmada.

​

FAQ

​

Por que meus números de Entrega Confirmada estão baixos ou ausentes?

1. Muitos dispositivos inativos ou abandonados. Veja Lidando com dispositivos inativos.
2. Limitações de plataforma (Huawei, Safari).
3. Problemas de configuração — especialmente comum com iOS. Veja Solução de problemas de Entrega Confirmada.
4. Dispositivos Android podem forçar o fechamento do seu aplicativo, interrompendo eventos do SDK. Alguns fabricantes de dispositivos tratam deslizar o aplicativo para fora como um fechamento forçado. Veja Guia de push móvel não exibido.

​

Lidando com dispositivos inativos

• Use Audience Activity para reenviar para usuários que não confirmaram a entrega.
• Crie Segmentos baseados em Last Session (por exemplo, inativos por mais de 90 dias).
  • Combine com uma Jornada de reengajamento para reconquistá-los.
  • Periodicamente segmente usuários inativos para remover dispositivos inalcançáveis.

​

Por que mostra Confirmado mas não aparece no meu dispositivo?

• Você pode ter perdido. Tente enviar um push de teste para você mesmo para ver se aparece.
• Modo Foco no iOS: Pushes são atrasados ou agrupados de forma diferente quando “Não Perturbe”, “Sleep” ou outros modos Foco estão ativos. Descartar notificações agrupadas pode fazer você perdê-las.
• Código customizado do aplicativo suprimindo a exibição:
  • event.preventDefault() no listener do ciclo de vida em primeiro plano ou Notification Service Extension
  • APIs de notificação que removem mensagens:
    • removeDeliveredNotifications(withIdentifiers:)
    • removeAllDeliveredNotifications()
• Configurações de payload do push:
  • Certifique-se de que priority esteja definido como alto. Veja Prioridade de push.
  • Tenha cuidado com collapse_id — ele substitui pushes mais antigos por novos usando o mesmo ID.
• Dispositivo errado segmentado: Use Encontrar e definir assinaturas de teste para confirmar.

​

Solução de problemas de Entrega Confirmada

​

Geral

• Dispositivo offline: Pushes podem ser atrasados por até 3 dias (padrão). Ajuste com Time To Live.
• Rede instável: A notificação pode ser recebida mas a confirmação falha se o aplicativo travar ou não tiver rede. Isso é raro.

​

iOS

1. Adicione o target OneSignalNotificationServiceExtension no Xcode.
2. Verifique novamente as etapas 3–6 em Configuração do SDK iOS. Certifique-se de usar o mesmo nome de App Group para aplicativo e extensão:
   • ✅ group.your-main-app-target-bundle-id.onesignal
   • ❌ group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal
   • Se você usar seu próprio nome de App Group, você precisa atualizar seus arquivos Info.plist tanto para o aplicativo principal quanto para a Notification Service Extension para informar nosso SDK qual App Group usar.
3. Certifique-se de que mutable-content: 1 esteja presente no payload (definido automaticamente a menos que seja sobrescrito).

​

Android

• Se as notificações não estão sendo exibidas: veja Solução de problemas de push móvel.
• Se as notificações aparecem mas a Entrega Confirmada está faltando: uma Android Service Extension customizada pode estar bloqueando. Verifique nosso guia de Android Service Extension.

​

Web

• Safari não é suportado.
• Para outros navegadores, certifique-se de que a migração para SDK v16 esteja completa:
  • Inicialização correta do SDK:
    Copy

    Ask AI

    <script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
    

  • Referência correta do Service Worker:
    Copy

    Ask AI

    importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");