Daily Limit

Kaleyra.io allows you to set a daily or monthly threshold (or both) for limiting the number of messages 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 in keeping under control your usage and eventually reducing 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. The SMS sent after the daily limit will not be charged.

📘

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 formats. The maximum size of the File should not be more than 1 MB.
• If the daily limit reaches the thereshold, you can see the status as NOT SENT in the the Status column by naviagting to SMS > Logs.
• When you upload multiple files, if country ISO is alreday updated with reqired details, then it replaces the existing value. Also, if the ISO code is not available in other than frst 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 requests more messages for the rest of the days in your monthly billing cycle.

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, toggle to enable 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. 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.

4. 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 to set the limit appears.

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

📘

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, toggle to enable 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. 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.

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