Errors
Voxtelesys provides error details, if applicable, to your callback URL via an error object. The error object provides a unique code and description of the error and is primarily intended to help you self-diagnose the issue.
Voxtelesys uses an error schema that is comprised of a 4 digit code. The first digit is used to determine if the error was caused by the client (customer) or server. The remaining 3 digits are error specific codes.
- Client Errors (
4xxx):- Voxtelesys Rejected, or
- Carrier Rejected
- Server Errors (
5xxx):- Voxtelesys Rejected, or
- Carrier Rejected
Client Errors
A 4xxx error code indicates that Voxtelesys or the downstream carrier has identified some element of the message request to be unacceptable. Repeating the request will produce the same result.
| Code | Description | Rejection Source |
|---|---|---|
| 4101 | invalid message encoding | Voxtelesys |
| 4102 | invalid from number | Voxtelesys |
| 4103 | forbidden from number | Voxtelesys |
| 4104 | forbidden country | Voxtelesys |
| 4105 | 24hr message count exceeded | Voxtelesys |
| 4106 | invalid RBM sender | Voxtelesys |
| 4501 | carrier rejected invalid service type | Carrier |
| 4502 | carrier rejected invalid destination address | Carrier |
| 4503 | carrier rejected invalid source address | Carrier |
| 4504 | carrier rejected invalid message | Carrier |
| 4505 | carrier rejected message too long | Carrier |
| 4506 | carrier rejected as SPAM | Carrier |
| 4507 | carrier rejected user opt out | Carrier |
| 4508 | carrier rejected unknown msisdn | Carrier |
| 4509 | carrier rejected bad msisdn | Carrier |
Server Errors
A 5xxx error code indicates that either Voxtelesys or the downstream carrier has reported a service failure. For Voxtelesys failures, the customer can retry the request and expect a different result. For downstream carrier errors, a retry may also yield a different result.
| Code | Description | Rejection Source |
|---|---|---|
| 5300 | internal error | Voxtelesys |
| 5301 | internal error | Voxtelesys |
| 5302 | internal error | Voxtelesys |
| 5303 | internal error | Voxtelesys |
| 5304 | internal error | Voxtelesys |
| 5305 | internal error | Voxtelesys |
| 5306 | internal error | Voxtelesys |
| 5307 | internal error | Voxtelesys |
| 5308 | internal error | Voxtelesys |
| 5309 | internal error | Voxtelesys |
| 5310 | internal error | Voxtelesys |
| 5311 | internal error | Voxtelesys |
| 5312 | internal error | Voxtelesys |
| 5313 | internal error | Voxtelesys |
| 5351 | internal error | Voxtelesys |
| 5352 | internal error | Voxtelesys |
| 5353 | internal error | Voxtelesys |
| 5354 | internal error | Voxtelesys |
| 5355 | internal error | Voxtelesys |
| 5101 | carrier service unavailable | Carrier |
| 5102 | carrier service error | Carrier |
| 5103 | carrier application error | Carrier |
| 5104 | carrier routing error | Carrier |
| 5105 | carrier unknown error | Carrier |