Each Telerivet service plan has several different limits (quotas), as described on the Pricing page and the Change Service Plan page. To see each of your quotas and your current usage, click "view details" on the Billing page. You can see your account's historical usage for each quota on the Usage History page.
Included Messaging Capacity
The included messaging capacity depends on the type of connectivity you use to send and receive messages:
Direct connectivity
If you pay Telerivet directly for each message, there is no overall limit on the number of messages you can send or receive, although particular routes may have their own limits. The per-message pricing for the route will be charged directly to your Telerivet account, in addition to the price of your Telerivet plan.
In order to use Telerivet's direct connectivity, Telerivet must approve your use case. If your use case is not supported using Telerivet's direct connectivity, you can connect your own connectivity provider instead.Bring your own connectivity
When connecting your own connectivity provider to Telerivet (including the Telerivet Gateway app), you will pay the provider directly for each message you send or receive, in addition to the price of your Telerivet plan. Each Telerivet plan has a certain number of messages per day included when using your own connectivity provider, counting both sent and received messages.
The count resets at midnight in the time zone configured on the Organization Settings page.
What happens when the included messaging capacity is reached:
Telerivet provides “soft” daily limits for all paid plans by default, so you can continue sending/receiving messages in excess of the included messaging capacity. Telerivet will deduct $0.0025 (¼ cent) from your Telerivet account balance for each message in excess of the included messaging capacity. (What happens if your account balance is negative?)
If you don't want to be charged this fee when your account exceeds the included messaging capacity, you can contact support@telerivet.com to disable soft daily limits for your account.
If using a Test plan (or a plan selected before July 14, 2022 that is below the Pro plan), soft daily limits are disabled by default. When soft daily limits are disabled, additional messages will not be able to be sent or received when the included messaging capacity is reached. For incoming messages, this may result in messages being received the next day, or possibly dropped permanently.
Simulated Messages
Each account has a default limit of 1000 simulated messages per day, which you can use to test automated services without sending actual messages. If you need to increase this limit, contact support@telerivet.com.
Enhanced contact storage
The maximum number of different contacts stored in your contact database at any time. Each contact can have a name, phone number, and up to 100 custom fields, and can be added to groups.
By default, a contact is automatically created for each phone number you communicate with, as long as there is space in your contact database. If you don't need to store these contacts, you can disable automatic contact creation on the Messaging Settings page.
Contacts that are automatically created by Telerivet will also be automatically deleted once all of their messages are deleted, as long as the contact doesn't have any data other than a phone number (e.g., name, custom fields, groups, or if you block sending messages to them). Updating your Message Retention settings allows Telerivet to automatically delete old messages so that the corresponding contacts are also deleted.
Each service plan allows sending messages to an unlimited number of different phone numbers if you don't store them in your contact database.
What happens when the contacts limit is reached:
If your account reaches the maximum number of contacts, you’ll still be able to send and receive messages with new phone numbers. However, Telerivet will no longer automatically save contacts associated with new phone numbers that you send messages to. Telerivet will automatically save new contacts associated with incoming messages for a grace period of 7 days, since some automated services may require saving information on the contact associated with each message.
Telerivet will send a notification email to the primary account contact, as well as a reminder email after 5 days, and show a notification in the web app. However, you will not be able to add new contacts via the Telerivet web interface during the 7 day grace period or afterwards. You can delete contacts or upgrade your plan to stay under the limit.
After the 7 day grace period, you will still be able to send and receive messages with new phone numbers, although some automated services may stop working if they require information on the contact associated with the message (e.g. adding the contact to a group, getting the contact's name, retrieving or updating custom fields).
For users on the free Test plan, deleting contacts is only allowed if the contacts have no messages (or if you delete all messages for those contacts first).
Custom Automation
Custom Automation controls the level of functionality available in the drag-and-drop flow builder (Custom Actions and Custom Call Flow), and via JavaScript code (Cloud Script API). Telerivet service plans have two options for Custom Automation: Basic and Advanced.
Basic custom automation limits each service using the drag-and-drop flow builder or JavaScript to a maximum of 10 custom actions.
When using the Cloud Script API, each of the following JavaScript statements or expressions counts as a custom action towards the Basic custom automation limit:
- function call
- assignment expression (x = 1)
- new expression
- if statement
- conditional expression (a ? b : c)
- case statement
- for loop
- while loop
- do-while loop
Except for "run JavaScript code" actions, each custom action and condition counts as 1 action toward the limit, including actions within poll services and timeout handlers.
Advanced custom automation has increased limits on actions in the drag-and-drop flow builder and JavaScript. In the drag and drop flow builder, most services support up to 200 custom actions per response handler or subroutine, with a limit of 100 response handlers or subroutines per service. For JavaScript code you write in the browser, the maximum script size is 100 KB, or 20 KB for scripts as part of a "run JavaScript code" rule in a Custom Actions service. An additional storage quota is provided for Cloud Script Modules to run JavaScript code from a GitHub repository.
Advanced custom automation also supports supports several additional features, including:
- Automatic retry and failover for outgoing messages
- Exporting messages and contacts to cloud storage (e.g. Amazon S3)
- Support for Telerivet to provide static IP addresses for whitelisting in your firewall if needed
Maximum Number of Routes
The maximum number of different routes that your organization uses to send messages through Telerivet, including Android phones, virtual numbers, SMS shortcodes, and alphanumeric sender IDs.
If you share the same route in multiple projects, the shared route will count towards the limit in each project. Also, if you have multiple routes with the same phone number or sender ID in the same project, each one counts toward the limit.
Note that most organizations only need one route.
"Test Number" routes are not counted towards this limit.
What happens when the routes limit is reached:
If your account reaches the maximum number of routes, you’ll be unable to add new routes until you delete a route or upgrade your plan.
Maximum User Login Accounts
The maximum number of user accounts you can add for people in your organization to log in and use Telerivet. Each user account can have its own permissions.
(User accounts are not needed for people who only use Telerivet via SMS, who count toward your maximum number of contacts.)
What happens when the user accounts limit is reached:
If your account reaches the maximum number of user accounts, you’ll be unable to add new user accounts until you revoke all permissions for a user account in your organization, or upgrade your plan.
Maximum Stored Messages
The total number of messages stored in your Telerivet account. You can delete old or unneeded messages to stay under this limit. Scheduled messages are also counted as stored messages.
What happens when the stored messages limit is reached:
If your account reaches the maximum number of stored messages, you’ll still be able to send and receive new messages. After a grace period of 7 days, Telerivet will start deleting the oldest messages in your organization (across all projects) in excess of the stored messages limit.
Before deleting the oldest messages, Telerivet will send a notification email to the primary account contact, as well as a reminder email after 5 days, and show a notification in the web app. To stay under the limit, you can update your Message Retention settings, manually delete stored messages, or upgrade your plan.
Maximum active automated services
The number of automated services that can be active at any time across all projects in the organization. Automated services run in response to certain events, such as when a new message is received, when a message's status changes, or when triggered by a user.
When using the Cloud Data Export feature to automatically export your Telerivet data to cloud storage, each scheduled export is also counted as an active automated service.
What happens when the active automated services limit is reached:
If your account reaches the limit, new automated services will be inactive and will not be able to be turned on until you deactivate (turn off) or delete an existing service.
Included daily service invocations
The number of times automated services can be triggered per day, excluding Webhook API services. The quota resets at midnight in the time zone configured for your account.
Services can be triggered when a new message is received, when a message's status changes, when triggered by a user, or when a contact clicks a short link. If using voice or USSD, a service will also be triggered each time a contact responds to a prompt.
What happens when service invocations exceed the included daily service invocations:
Telerivet provides soft daily limits for paid plans by default, so you can continue invoking services in excess of the included daily service invocations. If the quota is exceeded for a particular day, a fee of $0.001 (⅒ cent) per additional service invocation will apply. (What happens if your account balance is negative?)
If you don't want to be charged this fee when your account exceeds the included daily service invocations, you can contact support@telerivet.com to disable soft daily limits for your account.
If using a Test plan, soft daily limits are disabled by default. When soft daily limits are disabled, additional service invocations will fail when the daily limit is reached.
Included daily API requests
The number of requests allowed to the Telerivet developer API in one day, counting both REST API and Webhook API requests. Cloud Script API methods are also counted when they correspond to a REST API request.
The count resets at midnight in the time zone configured on the Organization Settings page.
When using direct connectivity (i.e., if you pay Telerivet directly for each message you send), API requests to send and receive messages are exempted from this limit.
If you aren't using the developer API, you won't encounter this limit.
What happens when API requests exceed the included daily API requests:
Telerivet provides soft daily limits for paid plans by default, so you can continue making API requests in excess of the included daily API requests. Telerivet will deduct $0.0001 (0.01 cent) from your Telerivet account balance for each API request in excess of the included daily API requests. (What happens if your account balance is negative?)
If you don't want to be charged this fee when your account exceeds the included daily API requests, you can contact support@telerivet.com to disable soft daily limits for your account.
If using a Test plan (or a plan selected before July 14, 2022 that is below the Pro plan), soft daily limits are disabled by default. When soft daily limits are disabled, additional API requests will fail when the daily limit is reached.
Maintaining Balances for Extra Messages/Day, API Requests/Day, or Service Invocations/Day
The fees for extra messages/day, extra API requests/day, and extra service invocations/day may cause your Telerivet account balance to go negative. Having a negative balance due to these fees is generally OK and will not interrupt your service. If your balance is negative, that amount will automatically be added to your next monthly or annual payment. If you have a large negative balance, Telerivet may set a limit and contact you to request that you resolve the balance before your next scheduled monthly or annual payment.
However, if you are paying Telerivet directly to send messages or send airtime, you will need a positive account balance. When paying via credit card, you can enable Auto-Refill to make sure that you maintain a positive balance on your account.