Throttling allows you to control the rate at which communications (Push notifications/Emails/SMS messages/WhatsApp messages/Webhook messages) are sent to users. This is helpful when you want to spread the load on your servers over a period of time instead of spiking the traffic. You can define the number of notifications or messages that can be sent per minute (requests per minute) for the following channels on the MoEngage Dashboard: Push, SMS, Email, WhatsApp, and Connectors.
Configure and Setup Throttling
To enable Throttling, go to the following navigation in the MoEngage Dashboard and set the throttling limit per minute to the desired number to control the communication being sent out.
Settings -> Channels -> Delivery Controls -> Throttling
To enable throttling for a channel:
- Turn the channel toggle on.
- Set the throttling limit to the desired RPM. The throttling value cannot be lower than the minimum limit specified for the channel or greater than the maximum limit specified for the channel. The minimum, maximum, and default rates are displayed on the Dashboard below each channel's setting.
- Click Save.
Throttling at the Campaign level
In addition to the global settings for throttling(the configuration discussed above), you can choose to set different throttling settings for individual campaigns if the option for throttling is available in step 3 of campaign creation. For example, throttling is available for One Time and Periodic Push/Email/SMS/WhatsApp/Connector Campaigns, and you can use the same to send specific campaigns faster or slower.
Campaigns have the Throttling option under Delivery Controls in the third step of campaign creation, as shown in the image below.
info |
Information With the reduction in the default FCM API rate limits to 600,000 RPM, we are changing the maximum allowed throttle speed for Push notifications to 500,000 RPM to ensure a single campaign does not breach the project limit. This change will apply to new and existing campaigns. You may still see drops because of multiple campaigns being triggered together. For more information, refer to Changes in Sending Speed with Private Key Configuration. |
The default setting for throttling at the campaign level will be populated from the global settings.
For example:
If Push/SMS/Email/WhatsApp/Connector Throttling is ON in the Global Settings - The same throttling value will be shown as default in the Campaign Throttle setting in the third step of campaign creation.
If Push/SMS/Email/WhatsApp/Connector Throttling is OFF in the Global Settings - The Campaign Throttle setting will have the default throttle value for the channel. Refer to the table below for the minimum, default, and maximum throttling values for all the channels.
Channel | Default Throttling Value (notifications, messages, or emails)/minute | Minimum Throttling Value (notifications, messages, or emails)/minute | Maximum Throttling Value (notifications, messages, or emails)/minute |
Push | 100K | 1K |
|
SMS | 60K | 1K |
|
60K | 1K |
|
|
60K | 1K |
|
|
Webhook (Connector) | 60K | 1K |
|
Whether global throttling is On/Off, you can change the throttle speed while configuring a campaign and set different options for different campaigns. If the values differ in Global Throttling Settings and Campaign Throttling, campaign-level throttling will be given priority and applied.