Rate limit

Rate limiting allows you to restrict the number of messages a single user can send to your AI Agent in a given period of time. This helps prevent end-users from spamming your agent and depleting your account’s AI credits.

(Note: Rate limiting is currently only applied to web widgets and not to external integrations such as Instagram, WhatsApp, or the API).

How to set a rate limit

To configure a rate limit for your agent:

1. Open your workspace and select your AI Agent.
2. From the dashboard sidebar, click on Rate limit under the General Settings section.
3. Add a rate limit rule (e.g., 10 messages per minute). You can add multiple rate limits for different periods of time, such as per minute, per hour, or per day.
4. Optionally, add a Custom error message to be displayed when the user hits the rate limit. If left blank, a generic default error message will be shown.
5. Click Save.

The rate limit is applied to individual users based on their session. For example, if you set a rate limit of 10 messages per minute, each unique visitor can send up to 10 messages per minute before being blocked.

Note on Translations: The default error message is automatically translated into the primary language of your agent’s chat widget. However, if you override it with a custom message, your exact text will be displayed and will not be automatically translated.

Once you’ve saved the rate limits, your AI Agent will automatically prevent users from sending more messages than allowed. If the rate limit is exceeded, the input field will be temporarily locked and the error message will be displayed.