Aerialink Code Management KB

Code Management

Manage, search, edit, and maintain messaging codes including Long Codes (BYON/Leased), Toll-Free Numbers (TFN), International Numbers, Alpha Numeric numbers and Short Codes within the Aerialink v5 Portal.

Overview

The Code Management page is the primary administration interface used to manage messaging numbers provisioned within the Aerialink platform. Support engineers and administrators can search for messaging codes, review provisioning information, edit configuration, verify campaign assignments, configure Email-to-SMS settings, review Number Publisher status, and troubleshoot messaging issues.

Important Note

Changes made on this page can directly affect SMS/MMS routing, 10DLC campaign compliance, Email-to-SMS functionality, and message delivery. Fields such as Provider, ESPID, TON, NPI, and Code Source should only be modified by authorized personnel.

What You'll Need

• Administrator or Support Engineer permissions.
• Access to the appropriate Aerialink account.
• The messaging number, Campaign ID, or Connection name you wish to manage.
• Knowledge of the provisioning request if configuration changes are required.

Navigation

Configuration
    └── Codes
          └── Code Management

Capabilities

Feature	Description
Search Codes	Locate messaging numbers using multiple search filters.
Edit Configuration	Modify provisioning and routing properties.
Campaign Management	Review and verify assigned 10DLC campaigns.
Email-to-SMS	Configure Email-to-SMS routing.
Reserved Keywords	Review HELP and STOP keyword behavior.

Search Filters

The Search section allows administrators to locate one or multiple messaging codes using various filters.

Field	Description
Codes	Enter one or multiple phone numbers. Multiple values may be pasted and formatted.
Format Codes	Converts multiple lines into comma-separated values.
Account	Limits the search to the selected account.
Exclude Sub-accounts	Search only the selected account and ignore child accounts.
Connection	Search within one connection or all connections.
Campaign ID	Locate numbers assigned to a specific 10DLC campaign.
Connection GUID	Search using the unique connection identifier.
Email-to-SMS Name	Search by Email-to-SMS alias.
Email Address	Search by configured email address.
Code Type	Filter by Long Code, TFN, BYON, Short Code, or Alpha Sender.
Provider	Restrict results to a messaging provider.
Output	Display search results on screen.

Example

17022760143
19162889031
15616836247

After clicking Format Codes:

17022760143,19162889031,15616836247

Best Practices

• Use Campaign ID when validating 10DLC assignments.
• Use Connection filter to reduce search results.
• Use Format Codes before searching multiple numbers.
• Verify the selected Account before executing the search.

Search Results

After selecting the desired search filters and clicking Search, matching messaging codes are displayed in the results grid. This grid provides a quick overview of each provisioned messaging number and allows administrators to perform management actions.

Result Columns

Column	Description
Code	Messaging number returned by the search.
Connection	Connection associated with the messaging code.
Account	Customer account that owns the code.
Code Type	Long Code, Toll-Free, BYON, Short Code, or Alpha Sender.
Campaign ID	Assigned 10DLC campaign identifier.
Provider	Current messaging provider.
Created	Date and time the code was provisioned.
Updated	Most recent configuration update.
Status	Indicates whether the messaging code is active.

Available Actions

	Action	Purpose
	View	Display the complete configuration of the selected messaging code.
	Edit	Modify configurable properties of the messaging code.

Bulk Actions

Administrators can select multiple messaging codes and perform bulk operations to reduce repetitive administrative work.

• Select one or more messaging codes.
• Click Update Selected.
• Review the changes before saving.
• Verify that all selected codes were updated successfully.

Important

Bulk updates modify multiple messaging codes simultaneously. Verify the selected records carefully before saving changes to avoid unintended configuration updates.

Best Practices

• Verify the Account before editing production numbers.
• Review the Campaign ID prior to making changes.
• Use search filters to reduce the result set before performing bulk updates.
• Confirm the Provider and Code Type before opening a record.
• Review the Updated timestamp when troubleshooting recent provisioning changes.

What's Next?

The next section documents the Code Details page, including every editable field, provisioning information, routing parameters, and messaging configuration.

Overview

Selecting a messaging code from the search results opens the Code Details page. This page displays provisioning information, routing configuration, campaign details, and messaging attributes associated with the selected number.

General Information

Field	Description	Example
Code GUID	Globally unique identifier assigned to the messaging code. Used internally for system references and troubleshooting.	BF096E2F-A673-4520-B6C6-A9FD6CDA0DB4
Code ID	Internal numeric identifier stored within the Aerialink platform.	50016449
Created	Date and time when the messaging code was originally provisioned.	10/07/26 2:03 PM
Updated	Most recent date and time when the configuration was modified.	10/07/26 2:03 PM
Code is Active	Indicates whether the messaging code is currently active and available for use.	Enabled

Connection Information

Field	Purpose
Connection	Displays the messaging connection associated with the selected code.
Number	Telephone number provisioned for messaging.
Code Type	Identifies whether the number is BYON, Long Code, Toll-Free Number, or Short Code.
Code Source	Indicates how the number was provisioned into the platform.
Item Code	Internal provisioning classification used by the platform.

Important

Fields such as Code Type, Code Source, and Item Code are typically assigned during provisioning and should not be modified unless instructed by Engineering.

Best Practices

• Always verify the selected number before making configuration changes.
• Review the Created and Updated timestamps when investigating provisioning issues.
• Use the Code GUID when working with Engineering or reviewing backend logs.
• Confirm the messaging connection before editing production numbers.

Coming Next

Part 5 documents Provider configuration, ESPID, TON, NPI, NetNumber ID, Number Publisher Action, Campaign ID, MNO Status, Email-to-SMS configuration, and Voice settings.

Routing & Provider Configuration

This section defines how the messaging number is provisioned, routed, and managed within the Aerialink platform. Most of these fields are configured during provisioning and generally should only be modified by authorized administrators or Engineering personnel.

Field	Description	Support Guidance
Provider	The SMS/MMS provider responsible for routing traffic for this messaging code.	Only modify if instructed by Engineering or Operations.
ESPID	Provider-specific routing profile used to identify the messaging service configuration.	Changing this value may impact message routing.
TON	Type Of Number used by the carrier for addressing and routing.	Normally configured during provisioning.
NPI	Numbering Plan Indicator defining the numbering plan used by the destination network.	Do not modify unless required.
NetNumber ID	Identifier used by the NetNumber platform when applicable.	Primarily used during troubleshooting.
Number Publisher Action	Displays the current synchronization action (for example, PUBLISH).	Verify status after provisioning.
Campaign ID	Assigned 10DLC campaign associated with the messaging number.	Validate during delivery troubleshooting.
MNO Status	Displays the Mobile Network Operator approval or provisioning status.	Review when onboarding new numbers.
MNO Is Pool	Indicates whether the messaging code belongs to a pooled routing group.	Informational field.

Email-to-SMS Configuration

These settings control Email-to-SMS functionality for the messaging code.

Field	Purpose
Email-to-SMS Name	Friendly name associated with Email-to-SMS.
Email Address	Configured sender email address.
Email Domain	Domain used for Email-to-SMS routing.
Email Template ID	Optional email template used when processing Email-to-SMS requests.

Voice Configuration

If voice services are enabled for the messaging number, voice forwarding options will appear in this section.

• Voice Enabled
• Voice Forward Type
• Voice Forward Destination

Important

Provider, ESPID, TON, NPI, and Number Publisher settings are provisioning-related fields. Incorrect changes may affect message delivery and should only be performed after validation.

Best Practices

• Verify Campaign ID before troubleshooting delivery failures.
• Review Number Publisher status after provisioning.
• Validate Email-to-SMS configuration before production testing.
• Confirm provider settings before escalating routing issues.
• Avoid modifying provisioning fields without change approval.

Coming Next

Part 6 covers Reserved Keywords, Subscriber Auto Responses, Troubleshooting, Frequently Asked Questions, and Related Articles.

Reserved Keywords

Aerialink supports industry-standard reserved keywords that enable subscribers to request help information or opt out of future messaging. These keywords help organizations comply with carrier and messaging regulations.

Help Keywords

Keyword	Purpose
HELP	Returns subscriber help information.
INFO	Alternative help keyword.
AIDE	French language help keyword.

Opt-out Keywords

Keyword	Purpose
STOP	Immediately opt the subscriber out.
CANCEL	Opt-out request.
UNSUBSCRIBE	Opt-out request.
END	Stops future messages.
QUIT	Stops future messages.
REVOKE	Revokes messaging consent.
OPTOUT / OPT-OUT	Alternative opt-out keywords.
ARRET	French language opt-out keyword.

Subscriber Auto Responses

Administrators may configure automatic responses for:

• Subscriber Help Auto-Response
• Subscriber Opt-out Auto-Response

These responses are automatically returned when supported reserved keywords are received by the messaging number.

Carrier Compliance

For hosted numbers, keyword management requires the applicable connection to have Enforce Opt-Out enabled. Toll-Free messaging providers also enforce network-level STOP and UNSTOP processing that cannot be disabled.

Troubleshooting

Issue	Possible Cause	Resolution
Unable to locate a messaging code.	Incorrect account, connection, or search criteria.	Verify search filters and use Format Codes when searching multiple numbers.
Campaign ID is missing.	Number has not been assigned to a campaign.	Confirm campaign provisioning before sending production traffic.
Messages are not being delivered.	Provider, routing, or provisioning issue.	Verify Provider, ESPID, Number Publisher status, and Campaign ID.

Frequently Asked Questions

Q: Can I modify Provider or ESPID values?

A: These values should only be changed under the guidance of Engineering or Operations.

Q: Why is my Campaign ID blank?

A: The messaging code may not yet be associated with a 10DLC campaign.

Q: Why aren't HELP or STOP responses working?

A: Verify that keyword management is enabled for the connection and review the reserved keyword configuration.

Best Practices

• Review configuration before making production changes.
• Always validate Campaign ID assignments.
• Use reserved keywords during post-provisioning testing.
• Avoid modifying provisioning fields without approval.
• Document configuration changes in the support ticket.

Related Articles

• Managing Connections
• 10DLC Campaign Management
• Email-to-SMS Configuration
• Provisioning Long Codes
• Managing Toll-Free Numbers

End of Article
This completes the Code Management Knowledge Base article.