ESS Events V1 (Deprecated)
Most Common Errors In v1 ESS Events
The type of errors and descriptions in v1 of this API is quite extensive and while v2 ESS events will simplify this for our customers, we have compiled a set of the most common error codes and recommended actions from the field.
| Error Code | Error Description | Retry Possible (Yes or No) | Additional Feedback |
| 10DLC Number Failed to register or remove. Please try after sometime | Yes | Retry after an interval may resolve the issue. | |
| 10DLC Number Failed due to Carrier Partner error. Please retry after sometime | Yes | Retry after an interval may resolve the issue. | |
| Backend Service unexpected network or system error | Yes | Retry after an interval may resolve the issue. | |
| Campaign is not in Registered State to Process LongCode | No | When the 10DLC application receives a large number of "Unknown failures" from TMO while provisioning Long codes for a campaign in batch, the campaign status is changed from REGISTERED to FAILED. This was done to prevent the same campaign-LCs from looping indefinitely and further queuing. The Syniverse operations team is presently manually remediating this. This problem will be addressed in the Syniverse Automation API V2 |
|
| Campaign not registered with Syniverse | Yes | Customer can retry after an interval, and it may resolve the issue. Sometime, if the Campaign is not provisioned by Syniverse, then Customer can reinitiate CAMPAIGN_DCA_UPDATE for the same campaign. |
|
| 26 | 26:Throttling failure on throttling level: SERVICEPROVIDER_LEVEL | Yes | This is an intermittent error response from TMO, Customer must retry. First time after 5-minute, second time after 10 minutes. If the issue still persists, contact with Syniverse who will open a ticket with TMO about the same long code. |
| 50008 | 50008:failed to get response from capability access api | Yes | This is an intermittent error response from TMO, Customer must retry. First time after 5-minute, second time after 10 minutes. If the issue still persists, contact with Syniverse who will open a ticket with TMO about the same long code. |
| 50008 | 50008:MT Campaign creation failed | Yes | This is an intermittent error response from TMO, Customer must retry. First time after 5-minute, second time after 10 minutes. If the issue still persists, contact with Syniverse who will open a ticket with TMO about the same long code. |
| 50008 | 50008:Invalid short code And enum server status is: FAILURE | Yes | This is an intermittent error response from TMO, Customer must retry. First time after 5-minute, second time after 10 minutes. If the issue still persists, contact with Syniverse who will open a ticket with TMO about the same long code. |
| 50023 | 50023:Invalid ProviderId or contentProviderId | No | Contact Syniverse Support to validate content provider mapping, If the campaign's content provider (AKA Brand) is not in T-Mobile 3PI/SDG then the responsible party is TCR, AND CUSTOMER SHALL OPEN A TICKET WITH TCR: support@campaignregistry.com REQUESTING CONTENT PROVIDER CREATION. |
| 50024 | 50024:Invalid ApplicationAddressesId. | ||
| 50035 | 50035:ShortCode is associated to MT Campaign/Campaigns | No | Long code was provisioned to another campaign. It needs to be deleted. Any migrated long code(s) needs to be deleted from TMO before provisioning attempt to a new campaign via Syniverse. |
| 60005 | 60005:Shortcode is not present in Application Address | ||
| 60016 | 60016:Short code create/update/remove failed | Yes | Retry after an interval may resolve the issue, If issue persists, do a local ENUM call for that long code, If the call is successful, re-submit to Syniverse. |
| 60022 | 60022:PolicyGroupId is not allowed to change | Yes | Retry after an interval may resolve the issue. |
| 60034 | 60034:Invalid value present in message-service-type field | No | Syniverse to re-process Sole Proprietor campaigns once authorized by T-Mobile |
| 60064 | 60064:Invalid short code And enum server status is: FAILURE | Review 10DLC NETNUMBER and OSR Attributes and/or validate to have no exceeded the allowed amount of TNs to a single campaign. | |
| 60064 | 60064:Invalid short code And enum server status is: FAILURE | Review 10DLC NETNUMBER and OSR Attributes and/or validate to have no exceeded the allowed amount of TNs to a single campaign. | |
| 60064 | 60064:Invalid short code And enum server status is: Unexpected network or system error | Review 10DLC NETNUMBER and OSR Attributes and/or validate to have no exceeded the allowed amount of TNs to a single campaign. | |
| 60065 | 60065:MO Campaign Id in the request is invalid | ||
| 60066 | 60066:Partner cannot create/update with the requested state. | Yes | Retry after an interval may resolve the issue. Review that add LONGCODES to a campaign that has already being set by T-Mobile as a CampaignId based number pool |
| 60083 | 60083:Invalid content-providers | No | Contact Syniverse Support to validate content provider mapping, If the campaign's content provider (AKA Brand) is not in T-Mobile 3PI/SDG then the responsible party is TCR, AND CUSTOMER SHALL OPEN A TICKET WITH TCR: support@campaignregistry.com REQUESTING CONTENT PROVIDER CREATION. |
| 60093 | 60093:Please do not provide Control characters for | This error may occurs when data in to TCR (text fields) contain control characters like \n Enter-New Line, ® , ™ , © or other symbols (the error will indicate what is the current field that is causing the issue). | |
| 60135 | 60135:could not configure the entity in the system |
Topic events (V1)
| Topic | Event Type | Description | ||
| TenDlc-Provisioning | TenDlc_Campaign | Event is reported whenever a campaign is REGISTERED/EXPIRED/FAILED/PENDING with SDG. | ||
| TenDlc_Number | Event is reported whenever a 10DLC number is ADDED/DELETED/FAILED/PENDING with SDG. | |||
| TenDlc_Campaign_NumberPool_Update | Event is reportes whenever a NumberPool is Addedd/Removed from the Campaign | |||
| Event Type | Field | Data Type | Mandatory | Description |
| TenDlc_Campaign | application_id | INTEGER | yes | Application ID - SDC provides this parameter |
| company_id | INTEGER | yes | Company ID - SDC provides this parameter | |
| campaign_status | STRING | yes | Campaign state change (REGISTERED/EXPIRED/FAILED/PENDING) | |
| campaign_status_description | STRING | no | Campaign status description | |
| reason_code | INTEGER | yes | Request Reason code | |
| reason_description | STRING | yes | Request Reason Description | |
| tcr_campaignId | STRING | yes | TCR Campaign ID | |
| number_pool_type | STRING | no | TDB | |
| number_pool_id | STRING | no | TDB | |
| Event Type | Field | Data Type | Mandatory | Description |
| TenDlc_Number | application_id | INTEGER | yes | Application ID - SDC provides this parameter |
| company_id | INTEGER | yes | Company ID - SDC provides this parameter | |
| longcode | STRING | yes | 10DLC Longcode Number | |
| longcode_status | STRING | yes | Longcode state change (ADDED/DELETED/FAILED/PENDING) | |
| longcode_status_description | STRING | no | Longcode status description | |
| reason_code | INTEGER | yes | Request Reason code | |
| reason_description | STRING | yes | Request Reason Description | |
| tcr_campaignId | STRING | yes | TCR Campaign ID | |
| longcode_tlv | STRING | no | Longcode TLV value | |
| number_pool_type | STRING | no | TDB | |
| number_pool_id | STRING | no | TDB | |
| Event Type | Field | Data Type | Mandatory | Description |
| TenDlc_Campaign_NumberPool_Update | application_id | INTEGER | yes | Application ID - SDC provides this parameter |
| company-id | INTEGER | yes | Company ID - SDC provides this parameter | |
| campaign_state | STRING | yes | Campaign state change (REGISTERED/EXPIRED/FAILED/PENDING) | |
| reason_code | INTEGER | yes | Response Reason code | |
| reason_description | STRING | yes | Response Reason Description | |
| tcr_campaignId | STRING | yes | TCR Campaign ID | |
| number_pool_type | STRING | yes | Type of Number Pool based on SubId or based on Campaign Id | |
| number_pool_id | STRING | yes | Number Pool Id that represents the Number Pool in TMO | |
Json Events
| Event_Type | Json Object |
| TenDlc_Campaign | { "attempt": 1, "event": { "evt-tp": “TenDlc_Campaign", "fld-val-list": { "application_id": 6569, "company-id": 2403, "campaign_state": “REGISTERED", "campaign_status_description":"Success" "reason_code": "200", "reason_description": "SUCCESS", "tcr_campaignId": " CYYYYYY ", "number_pool_type": "TBD", "number_pool_id": "TBD" }, "timestamp": "2021-03-19T16:12:38.593Z" }, "event-id": "At7RCpAXRweQ5_rYuvXPyg", "topic": "TenDlc-Provisioning" } |
| TenDlc_Number | { "attempt": 1, "event": { "evt-tp": “TenDlc_Number", "fld-val-list": { "application_id": 6569, "company-id": 2403, "number_id": "1xxxyyyzzzz", "campaign_state": "ADDITION", "longcode_status_description": "Success", "reason_code": "200", "reason_description": "SUCCESS", "tcr_campaignId": "CYYYYYY", "longcode_tlv": "", "number_pool_type": *, "number_pool_id": "None" }, "timestamp": "2021-03-19T16:12:38.593Z" }, "event-id": "At7RCpAXRweQ5_rYuvXPyg", "topic": "TenDlc-Provisioning" } |
| TenDlc_Campaign_NumberPool_Update | { "attempt": 1, "event": { "evt-tp": “TenDlc_Campaign_NumberPool_Update", "fld-val-list": { "application_id": 6569, "company-id": 2403, "campaign_state": “REGISTERED", "reason_code": "202", "reason_description": "Successfully added pool CUST_SYN1-999111", "tcr_campaignId": " CYYYYYY ", "number_pool_type": "SubId", "number_pool_id": "CUST_SYN1-999111" }, "timestamp": "2021-03-19T16:12:38.593Z" }, "event-id": "At7RCpAXRweQ5_rYuvXPyg", "topic": "TenDlc-Provisioning" } |
| TenDlc_Campaign_NumberPool_Update | { "attempt": 1, "event": { "evt-tp": “TenDlc_Campaign_NumberPool_Update", "fld-val-list": { "application_id": 6569, "company-id": 2403, "campaign_state": “REGISTERED", "reason_code": "401", "reason_description": "FAILED TO ADD POOL. Not authorized or reached MAX number pool allowance for the campaign, Max is set to (1)", "tcr_campaignId": " CYYYYYY ", "number_pool_type": "SubId", "number_pool_id": "CUST_SYN1-999111"" }, "timestamp": "2021-03-19T16:12:38.593Z" }, "event-id": "At7RCpAXRweQ5_rYuvXPyg", "topic": "TenDlc-Provisioning" } |