> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limitação de frequência de push

> Limitar a frequência com que as notificações push são enviadas

O OneSignal ajuda você a alcançar seus usuários de forma eficaz—sem sobrecarregá-los. Enviar muitas mensagens pode levar a cancelamentos de inscrição, desengajamento ou uma experiência ruim do usuário. A Limitação de Frequência permite que você controle a frequência com que os usuários recebem notificações push do seu aplicativo, definindo limites no número de mensagens enviadas por minuto, hora, dia ou semana.

<Note>
  A Limitação de Frequência está disponível em [Planos Pagos](https://onesignal.com/pricing) selecionados.
</Note>

***

## 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) ✅

O usuário agora atingiu o limite de 3 notificações para sua janela móvel de 24 horas, que começou às 9:00 AM no Dia 1.

**Dia 2:**

* 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) ✅

Neste exemplo, as notificações 4, 6 e 7 seriam limitadas e não entregues ao usuário, enquanto 1, 2, 3, 5 e 8 seriam entregues.

***

## 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:

<Steps>
  <Step>
    Navegue até **Configurações > Push & In-app > Limitação de Frequência**.
  </Step>

  <Step>
    Defina o número máximo de mensagens que um usuário pode receber em um determinado período de tempo.

    <Frame caption="As notificações podem ser limitadas a x notificações por qualquer período de tempo.">
      <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/ca59ff47b3c7bd4fe834d818299d7365957de85d86b1b5577b111dcbbef4bfdd-Screenshot_2025-04-16_at_12.07.24_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=d2d6528f4b6cc767fca4c20eef01dfe1" width="2394" height="1520" data-path="images/docs/ca59ff47b3c7bd4fe834d818299d7365957de85d86b1b5577b111dcbbef4bfdd-Screenshot_2025-04-16_at_12.07.24_PM.png" />
    </Frame>
  </Step>
</Steps>

### 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.

Por exemplo, se o limite estiver definido como 2/dia e um usuário já recebeu 2 mensagens de API, uma mensagem de Journey será descartada, a menos que a limitação seja sobreposta.

***

## 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:

<Tabs>
  <Tab title="Painel">
    No **Agendamento de Entrega** da mensagem, selecione **Sobrepor configurações de limitação de frequência**.

    <Frame>
      <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81e1bd0-Screenshot_2022-11-16_at_3.14.52_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=876b3661b21dbdcb5ec1c00920b2912d" width="2102" height="642" data-path="images/docs/81e1bd0-Screenshot_2022-11-16_at_3.14.52_PM.png" />
    </Frame>
  </Tab>

  <Tab title="API">
    Usando a [API Create Push notification](/reference/push-notification) você pode sobrepor a limitação de frequência com o parâmetro:

    * `enable_frequency_cap` definido como `false`
  </Tab>
</Tabs>

### 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.

***