CENCEN Documentation
Community setup guide · Customer guide
Intercept codes
Every reason a CEN call can fail has a code, CEN-01 to CEN-12, and a recorded announcement the caller hears.
When a CEN call can’t go through, the caller’s PBX plays one of these announcements. The same code is returned by the API, so the message a caller hears always matches what your logs show.
| Code | Message | Used when | Listen |
|---|---|---|---|
| CEN-01 | Unassigned exchange“We’re sorry. The number you have dialed cannot be completed because the destination exchange is not assigned. Please check the number and try your call again. CEN message 01.” | No network owns the area code, or no branch owns the block. | |
| CEN-02 | Exchange suspended“We’re sorry. The exchange you are trying to reach is currently unavailable. Please try your call again later. CEN message 02.” | The destination network or branch is suspended by CEN. | |
| CEN-03 | Maintenance“We’re sorry. The exchange you are trying to reach is temporarily unavailable due to scheduled maintenance. Please try your call again later. CEN message 03.” | The destination is paused or not yet activated. | |
| CEN-04 | Exchange retired“We’re sorry. The exchange you are trying to reach is no longer in service. Please check the number and try your call again. CEN message 04.” | The destination network or branch is retired. | |
| CEN-05 | Network unavailable“We’re sorry. Your call cannot be completed due to a temporary network problem. Please try your call again later. CEN message 05.” | The destination network’s Routing API failed or answered incorrectly. | |
| CEN-06 | Destination unreachable“We’re sorry. The destination exchange could not be reached at this time. Please try your call again later. CEN message 06.” | The destination has no IAX password yet, or its PBX did not answer the IAX call. | |
| CEN-07 | Invalid number“We’re sorry. The number you have dialed is not valid on this network. Please check the number and try your call again. CEN message 07.” | Not 7 or 10 digits, or 7 digits dialed without an area code where one is needed. | |
| CEN-08 | Number not found“We’re sorry. The number you have dialed is not in service on the destination exchange. Please check the number and try your call again. CEN message 08.” | The destination network’s Routing API says the number is not in service. | |
| CEN-09 | Incoming calls disabled“We’re sorry. The exchange you are trying to reach is not accepting incoming network calls at this time. Please try your call again later. CEN message 09.” | The destination has turned off receiving calls. | |
| CEN-10 | Outgoing calls disabled“We’re sorry. This exchange is not currently authorized to place calls over the network. Please contact your system administrator for assistance. CEN message 10.” | The calling branch or network is suspended, retired or has placing calls turned off. | |
| CEN-11 | Authentication failure“We’re sorry. This system could not be authenticated with the network. Please contact your system administrator for assistance. CEN message 11.” | CEN_KEY is missing, wrong, expired or revoked. | |
| CEN-12 | Service temporarily unavailable“We’re sorry. The network service is temporarily unavailable. Please try your call again later. CEN message 12.” | Too many lookups, or the PBX could not reach CEN. |
How PBXs play them
- Downloaded once (default): when a recording is first needed, the generated dialplan downloads
https://cenpbx.com/assets/intercepts/cen-XX.wavwith curl into the custom sounds folder. Later calls use the cached file. You can also upload all recordings in advance. Works on any FreePBX version. - Uploaded: download all 12 recordings and upload them in Admin → System Recordings, keeping the names
cen-01tocen-12. Works on any version. - Built-in: Asterisk’s generic “no service” message, without codes.
Choose in the config generator. If a recording can’t be played, the PBX falls back to the built-in message. The recordings are 8 kHz mono WAV, the native telephone format.