Daily Limit

Kaleyra.io allows you to set a daily or monthly threshold (or both) for limiting the number of units you can send to any given country. You can set limits for a few specific countries manually or you can perform a bulk configuration.

The threshold is based on the number of requests (that is, the number of phone numbers). For example, if you send 1000 messages of two units to the same phone number, the total number of requests is 1000.

Daily or monthly limits help you keep under control your usage and eventually reduce the impact of any potential misuse of your system by spam attackers or bots (For example, misusing a registration form to generate OTP).

You can use the Daily Limit feature to send the number of requests, using the SMS Campaigns from Kaleyra.io and using APIs.

Once the daily or monthly limit has been reached, any further messages get rejected with the status NOT SENT. You can view messages that have reached the SMS limit on the SMS > Analytics > Logs page. Any request to send SMS after that the daily limit has been reached, will not be charged. The status trace for these rejected messages will be labeled as SMS limit reached. This trace informs you about the reason for message rejection.

📘

Notes:

• By default, there are no message limits for any country.
• You can not enter the message limit as zero for the Daily Limit OR Monthly Limit fields.
• The daily limit numbers must be lesser than the monthly limit.
• If you want to update the daily limit in bulk, then you must enter the ISO Code of the countries, Daily Limit, and Monthly Limit as the column of a .xls, .csv, or .xlsx file format. The maximum size of the File should not be more than 1 MB.
• If the daily limit reaches the threshold, you can see the status as NOT SENT in the Status column by navigating to SMS > Logs.
• When you upload multiple files, if the country ISO is already updated with the required details, then it replaces the existing value. Also, if the ISO code is not available in other than the first file, then the previous value will be the same.

Use cases to avoid while using the Daily Limit feature:

Case 1: You should avoid keeping a much lesser daily limit compared to the monthly limit. For example, if you set the daily limit as 100 message requests and the monthly limit as 4000 message requests. Then, approximately 1000 message requests are beyond the threshold, and they will be unutilized.

Case 2: You should avoid keeping a much lesser monthly limit compared to the daily limit. For example, if you set the monthly limit as 10000 message requests and the daily limit as 1000 message requests. Then, in 10 days all the message requests may be utilized, and you cannot request more messages for the rest of the days in your monthly billing cycle.

Benefits

Daily/monthly limit help in the following ways:

• Keep volume/cost under control avoiding any user/team misuse the system.
• Prevent bill shock due to attacks on customers' public pages (for example, attackers triggering multiple OTPs or multiple notifications on the brand's system).

You can update the message limit in the following ways:

• Set Message Limit for a Country
• Set Message Limit in Bulk for Countries

Set Message Limit for a Country

You can set the message limit for a day and a month for a country.

To set the message limit for a day and a month for a country, perform the following steps:

1. From the Daily Limit section, click Edit Details.

    The Daily Limit detail appears.

📘

Note:

By default, the Daily Limit is disabled for your account. To change the settings, toggle Daily Limit. After enabling the daily limit, there is no default limit set for the Daily Limit.

2. Perform one of the following:
   • Scroll down and select the country. For example, Italy.
   • Search and select the country. To search the country, click the arrow next to the Select Country field and a search field appears. Enter the country name and based on your entry the list of countries appears. Select the country. For example, Italy.

3. Click the Pencil icon on the right side of the country for which you want to set the daily limit.
   A pop-up with the selected country appears on the right side.

4. Perform the following steps:
   1. In the Daily Limit field, enter the message requests limit you want to allow daily.
   2. In the Monthly Limit field, enter the message requests limit you want to allow in a month for the selected country. The daily limit must be less than the monthly limit.
   3. In the Trigger After field, click and then select the percentage from the drop-down list after which you want to get a notification for the configured utilized limit (Daily and Monthly).
   4. In the Email Address field, enter the email address to get the limit (Daily and Monthly) utilization notifications. You can enter multiple email addresses separated by a comma.
   5. Click Add Another Set, to configure another set for limit (Daily and Monthly) utilization based on percentage. You can configure one set based on percentage utilization. For example, you want to get the first notification when 50 percent of the daily limit is utilized to your email address and also you want to add a few of your other team members when 85 percent of the limit is utilized.
   6. Select Use the same notification configuration across all countries. to configure the same setting for all the selected countries. For example, if you have enabled daily limits for other countries but you want to configure the same notification trigger limits for them.

📘

Note:

The daily limit must be less than the monthly limit.

6. Click Save.
   The confirmation message Request successfully executed! appears, and the daily and monthly limits for the selected country are set.

Set Message Limit in Bulk for Countries

You can set the daily message limit for many countries in bulk.

To set the message limit in bulk for countries, perform the following steps:

1. From the Daily Limit section, click Edit Details.

📘

Note:

By default, the Daily Limit is disabled for your account. To change the settings, toggle Daily Limit. After enabling the daily limit, there is no default limit set for the Daily Limit.

    The Daily Limit feature gets enabled.

2. Click the arrow on the right side of the Daily Limit section.
   The list of countries appears.

3. Click Limit Bulk Upload.
   The Upload Daily Limit pop-up appears.

4. Click the Download Sample CSV file link to download the sample bulk upload spreadsheet.
5. You can perform one of the following steps:

• Click the highlighted section to upload the file with the daily limit from the mapped location.
• Drag and drop the .xls, .csv, or .xlsx file with the countries' ISO Code, Daily Limit, and Monthly Limit data. Limit will be update only for the countries listed in the file.

A sample daily limit format for bulk upload using the .xls or .xlsx file.

📘

Note:

The maximum size of the file should not be more than 1 MB.

The confirmation message with Document Uploaded message and a popup appear.

6. Click Save. The confirmation message Request successfully executed! appears for successful bulk upload.

📘

Note:

For information related to SMS status and status trace codes, see SMS Status and Status Trace Codes.