Configurações

Tudo que afeta o envio mora aqui — nada está fixo no código.

Android

Prioridade high acorda o aparelho e entrega na hora; normal pode ser adiado pelo sistema para poupar bateria. Também define o apns-priority no iOS (10 para high, 5 para normal). TTL em segundos Quanto tempo o FCM guarda a mensagem se o aparelho estiver offline. 0 significa entregar agora ou descartar. Em branco usa o padrão do FCM (4 semanas) — que é diferente de 0. Collapse key Notificações com a mesma chave se substituem: a nova apaga a anterior ainda não lida. Útil para não empilhar dez avisos do mesmo aluno. Canal (channel_id) Precisa existir no app com este nome exato. Canal inexistente no Android 8+ significa notificação silenciosamente descartada. Importância do canal Apenas documentação. O FCM não transmite importância de canal — quem a define é o app, ao criar o NotificationChannel. Registre aqui o valor que o app usa, para o diagnóstico bater. Som Nome do arquivo de som no app, ou 'default'. Em branco, silencioso.

iOS

Som Nome do arquivo no bundle do app, ou 'default'. Em branco, silencioso. Interruption level time-sensitive fura o Modo Foco; passive entrega sem alertar; active é o comportamento padrão. Enviado como interruption-level dentro do aps.

Definir badge no ícone Envia badge=1. Desligado, o número no ícone não é alterado.

Comum

Incluir a URL da foto no data Modo padrão: a foto vai como URL dentro do data, e o app a exibe quando aberto. Não aparece no banner. Mostrar a foto no próprio banner Liga mutable_content e APNSFCMOptions(image=...). Exige Notification Service Extension no app iOS — sem ela, nada muda. Desligado, a foto só aparece ao abrir o app. Push silencioso (content_available) Entrega sem banner nem som, só acorda o app em segundo plano para atualizar dados. Se ligar isto esperando ver notificação, não verá. Modo dry run (validate_only) O FCM valida a mensagem e responde sucesso sem entregar no aparelho. Vale para todos os disparos até ser desligado.

Deep link Vai no data como deep_link. Aceita {{movimento_id}}. Máximo de tokens por lote O envio é fatiado em lotes desse tamanho via send_each_for_multicast. O limite do FCM é 500.

Qualquer alteração aqui aparece imediatamente na pré-visualização do simulador, sem reiniciar a aplicação.