A Limitação de Frequência está disponível em Planos Pagos selecionados.
Como funciona a limitação de frequência
Exemplo: Definindo um limite de frequência de 3 notificações por período de 24h Dia 1:- 9:00 AM: Enviar Notificação 1. Usuário recebe Notificação 1. (Contagem: 1) ✅
- 1:00 PM: Enviar Notificação 2. Usuário recebe Notificação 2. (Contagem: 2) ✅
- 5:00 PM: Enviar Notificação 3. Usuário recebe Notificação 3. (Contagem: 3) ✅
- 8:00 AM: Enviar Notificação 4. Usuário está limitado e não recebe Notificação 4 porque a janela de 24 horas das 9:00 AM do Dia 1 ainda não expirou. A contagem ainda está em 3.
- 9:00 AM: A janela de 24 horas da Notificação 1 (9:00 AM do Dia 1) é redefinida. A contagem cai para 2. O usuário agora pode receber outra notificação.
- 9:01 AM: Enviar Notificação 5. Usuário recebe Notificação 5. (Contagem: 3) ✅
- 10:00 AM: Enviar Notificação 6. Usuário está limitado e não recebe Notificação 6.
- 11:00 AM: Enviar Notificação 7. Usuário está limitado e não recebe Notificação 7.
- 1:00 PM: A janela de 24 horas da Notificação 2 (1:00 PM do Dia 1) é redefinida. A contagem cai para 2.
- 2:00 PM: Enviar Notificação 8. Usuário recebe Notificação 8. (Contagem: 3) ✅
Quando usar a limitação de frequência
A Limitação de Frequência é particularmente útil em cenários onde o volume de mensagens pode se tornar excessivo:- Ambientes de Campanha Complexos: Grandes organizações com várias equipes ou campanhas de marketing sobrepostas.
- Gatilhos de Alta Frequência: Sistemas que enviam notificações com base em eventos frequentes (por exemplo, atualizações de preços de ações ou alertas de notícias automatizados).
Como habilitar a limitação de frequência
Você pode configurar a limitação de frequência no nível do aplicativo através do Painel OneSignal:1
Navegue até Configurações > Push & In-app > Limitação de Frequência.
2
Defina o número máximo de mensagens que um usuário pode receber em um determinado período de tempo.

As notificações podem ser limitadas a x notificações por qualquer período de tempo.
Notas importantes
- A limitação se aplica a todas as mensagens push, independentemente da origem (API, Journeys ou envios manuais).
- Mensagens bloqueadas devido à limitação são descartadas, não enfileiradas para depois.
Sobrepor a limitação de frequência
Em alguns casos, você pode querer enviar uma mensagem mesmo que exceda o limite. Você pode sobrepor a limitação de frequência por mensagem:- Painel
- API
No Agendamento de Entrega da mensagem, selecione Sobrepor configurações de limitação de frequência.

Notas sobre sobrepor
- A limitação de frequência deve estar habilitada no painel OneSignal.
- Mensagens sobrepostas ainda contam para o limite. Isso afeta se mensagens futuras serão entregues.
Relatórios
Quando a limitação está habilitada, você pode monitorar como ela impacta suas notificações através de relatórios de mensagens do painel ou visualizar a API de mensagem. Cada mensagem com limitação habilitada mostrará um status de:- Limitada: A limitação de frequência está habilitada para o aplicativo e quantas foram limitadas.
- Sobreposta: A limitação de frequência está habilitada para o aplicativo, mas foi sobreposta para a notificação.