Enfonica Platform

Limits

On this page
  1. All APIs
  2. Cloud SMS
  3. Cloud Voice
  4. Cloud SIP
  5. Phone Numbers
  6. Not supported

This page lists the limits that Enfonica enforces on the API, on webhooks, and on messages, calls, and phone numbers. Design your app to stay within them.

Only the Cloud SIP limits can be raised. If you expect to exceed one, tell our team before you launch.

All APIs

Limit Value
Items in one page of a list 10 by default, and 100 at most. A pageSize above 100 returns INVALID_ARGUMENT.
Access token lifetime Up to one hour. Your app gets a new token before the old one expires. See Authentication.

Cloud SMS

Limit Value
Message length 10 segments. That's 1,530 characters when every character is in the GSM-7 alphabet, or 670 characters when any character isn't, such as an emoji. A longer body is cut to fit. The segmentCount in the response shows how many segments were sent.
Segment size In GSM-7, a message of up to 160 characters is one segment, and a longer message is split into segments of 153. In Unicode (UCS-2), the sizes are 70 and 67.
Recipients One to number in each request.
Sender ID Up to 11 characters. See Alphanumeric sender IDs for the characters that it can use. A message to an Australian number from a sender ID that isn't registered to your project returns FAILED_PRECONDITION, with the message "This sender ID is not registered for Australian SMS."
Opt-outs A message to a number that has replied STOP returns FAILED_PRECONDITION, with the message "Recipient is unsubscribed". A message whose classification is TRANSACTIONAL isn't checked, and is sent. See How SMS opt-outs (STOP) work.
Labels on a message 50. A key has up to 100 characters, and a value has up to 1,000.
statusUpdateUrl An absolute URL of up to 2,000 characters.
Time to answer a webhook 10 seconds.
Webhook redirects Enfonica follows up to 5 redirects.
Webhook retries Each handler URL is tried once. If they all fail, Enfonica tries 8 more times, after 1, 2, 4, 8, 60, 1,800, 3,600, and 7,200 seconds. That's more than three hours in total. A slow response is also retried, so your server can receive the same webhook more than once. See Message webhooks.
MessageML Up to 10 <Message> actions in a response, and up to 10 redirects for one incoming message. See MessageML.

Cloud Voice

Limit Value
Call length 4 hours. Enfonica ends a call that reaches this length.
Time to answer a VoiceML request 10 seconds.
VoiceML retries None. Enfonica tries each of the call's handler URLs once, in order. If none returns VoiceML, the call fails.
Handler URLs Up to 5 for a call.
VoiceML document Up to 100,000 characters.
VoiceML requests in one call 2,000. This also stops a <Redirect> loop.
<Call> Up to 10 endpoints. TimeoutSeconds can be up to 600, and MaxDurationSeconds up to 14,400 (4 hours).
<Record> Up to 3,600 seconds (one hour).
<Say> Up to 5,000 characters of text. Voices are in English.
<Stream> Audio is G.711 (mu-law or A-law) at 8 kHz, over gRPC. A call must connect to a stream within 30 seconds of the stream being created.
Time to answer an event webhook 10 seconds. Event webhooks, such as CALL_STATE_UPDATE and RECORDING_READY, are retried in the same way as Cloud SMS webhooks. See Voice webhooks.
Recording download links A link from the API is valid for 60 minutes. A link in a RECORDING_READY or FAX_READY webhook is valid for 24 hours.

Cloud SIP

By default, an account has 100 concurrent calls and 10 outgoing call attempts per second. We raise both on request. See Cloud SIP limits.

A SIP domain for Microsoft Teams Direct Routing has its own channel limit for outgoing calls. It starts at 1, and you can increase it.

Phone Numbers

Limit Value
Buying One number in each request. A number that you buy from Enfonica's stock is active immediately.
Regulatory listing Australian local and mobile numbers, and New Zealand local numbers, need a compatible regulatory listing. Without one, the request to buy the number returns INVALID_ARGUMENT.
Handler URLs on a number Up to 5 for incoming calls, and up to 5 for incoming messages. Each has up to 2,000 characters.
Labels on a number 50. A key has up to 100 characters, and a value has up to 1,000.

Not supported

  • MMS. Cloud SMS sends and receives text messages only.
  • WebRTC. There's no SDK for calling from a browser or a mobile app.
  • A phone system (PBX). Cloud SIP provides SIP trunks that connect your own phone system to the phone network.