Managing SMS aggregators for your account

Important: Managing SMS aggregators for your account is available by default if your account is on the interaction SKU. However, SMS Full Service is its own separate SKU.

If you plan to use the SMS channel for your marketing campaigns, you have choices about which SMS aggregators to use. Oracle Responsys provides a network of SMS aggregators from which you can order services. You can search for aggregators from the SMS Public Aggregator Network page that provide service in the countries in which you want to do business. You can view the prices, terms, and conditions for the types of services provided. Once you have chosen the aggregator that provides the route types you have selected, you can then order the mobile codes and sender names for the route types from that aggregator.

Alternatively, you can request Full Service. With Full Service, Oracle becomes the single contracted vendor for your account. This simplifies the process of managing aggregators and codes for your account, as Oracle Responsys manages it for you. Learn more about the difference between Full Service and Self Service.

To access the Manage Aggregator page:

Log in to Oracle Responsys. If your user role is SMS Aggregator Manager, then the Manage Aggregator page opens. If you are an Account Administrator, do the following:

From the side navigation bar, select Account. (If you do not see the side navigation bar, click the icon.)
In the Search menu box, type SMS, and then click SMS Public Aggregator Network.
If the page does not show a search box but shows the Account Management page, locate the link by pressing Ctrl+F on your keyboard and typing SMS Public in the search box. Click the SMS Public Aggregator Network link.

From the Manage Aggregator page, you can:

Set up aggregators and order codes
View aggregator information
Remove an aggregator from your account
Test aggregator mobile codes

Note: To use this page, you must be logged in as a user with either the SMS Aggregator Manager role or the Account Admin role.

Set up aggregators and order codes

SMS Self Service

Note: If your account has Full Service enabled, please see the Full Service instructions. Learn more about Full Service and Self Service.

There are two main tasks you must perform to manage aggregators for your Responsys account:

Search for aggregators and compare prices, and then add the aggregator to your account.
Order codes and message types from the aggregators you have selected to work with.

To find and add an aggregator:

Access the Manage Aggregator page.
Click the Find Aggregator button. If this is your first time on this page, click the icon below the "Get started by setting up your aggregator" message.
The Find Aggregator dialog opens.
Select one or more countries where you want to send SMS messages.
Select one or more route types that you want to support for your SMS campaigns. The route type specifies whether you want to send Priority, Promotional, Transactional SMS traffic, or a combination thereof.
- Send only options - SMS messages sent by a marketer to a mobile device:
  - Mobile Terminated(MT) - One way bulk
  - Mobile Terminated(MT) - Priority
  - Mobile Terminated(MT) - Promotional
  - Mobile Terminated(MT) - Transactional
- Send and Receive options - SMS messages sent to a mobile device, and from a mobile device to a marketer:
  - Mobile Terminated - Promotional + Mobile Originated (MT+MO)
Optionally, select Short or Long code types to limit your search to the desired code type.
- Short code: Short codes are special numbers provided by carriers. They are used for sending and receiving SMS messages in a single country. They are typically five or six digits long.
- Long code: Long codes are used for sending and receiving SMS text messages internationally. They are numeric and can be up to 15 digits long.
Optionally, if you know the aggregator that you want to use, select the aggregator's name to show only their plans in the results.
Optionally, change the Deliverability score range by moving the slider to show the desired range. You can also exclude aggregators that do not have (or have not declared) a deliverability score by deselecting the check box labeled Include aggregators that do not have deliverability score yet.
Click Find.
The results show a list of aggregators that met your search criteria. For each country/route type combination, the results show the setup fees and prices for their services. It also shows deliverability scores.
To contact an aggregator for further details: Click the aggregator's Contact us link.
To further refine the results list: Use the filters on the left side of the Find Aggregator dialog and click Find.
About Deliverability score: This score is the average deliverability (messages delivered divided by messages intended), computed with data from the past 90 days. Each plan shows either a deliverability score (expressed as a percent) or the message "No data available."
Deliverability scores are either an Oracle-derived score or an Aggregator-declared score. Oracle-derived scores are color-coded: green for 100-90%, yellow for 80-89.99%, or red if the score is less than 80%. If an Oracle-derived score is not available, then the Aggregator-declared score is displayed. Aggregator-declared scores are shown in gray. This score is provided by the aggregator and is not validated by Oracle.
To view more details about a deliverability score: move your mouse cursor over the number. This displays the Oracle-derived value (if available), when it was last updated, and the Aggregator-declared score, if available.
From the resulting list, use the check boxes to choose the services that you want from the aggregators.
- You may choose route types across multiple aggregators.
- A service for long code might cover several countries. Move your mouse cursor over the country to see all of the countries serviced in a given plan.
Click Review and Submit.
The Review and Submit dialog opens.
Click Back to change your choices, or click Submit to place your order for the route types with the aggregators.

After the aggregator(s) confirm your order(s), you can use codes for the requested route types from within Responsys.

To order codes for your route types:

Access the Manage Aggregator page.
From the list of aggregators, click the Configure icon for the aggregator from which you want to order codes.
Click Order codes.
For each route type, enter the quantity and the sender name. Sender names are required when the route type is Mobile Terminated (MT) - One way bulk, but they are optional for other route types. Each sender name is limited to 11 characters and may include letters (a-z or A-Z) and numbers (0-9).
Click Order for each set of codes.
Review your order. Click Cancel to go back and change the order, or click Place your order to place the order and continue.

The Order codes page displays a message that the order was placed successfully, and an email is sent to the Responsys user who placed the order and to the Responsys Account Administrator(s).

The Order codes page shows the status of each order:

"In-Progress" means that the order is being serviced by the aggregator.
"Completed" means that the order is completed and the code is ready to use.
"Rejected" means that the aggregator has rejected the order for some reason. Click the Details button to view more information.

After the SMS Aggregator partner has serviced the order and has marked it either "Completed" or "Rejected", Responsys sends an email to the user who placed the order and to the Responsys Account Administrator(s).

To view codes that you can use:

Access the Manage Aggregator page.
From the list of aggregators, click the Configure icon for the aggregator.
Click View codes.

The View codes page shows details about the codes that have been enabled for your Responsys account. Details include the mobile code, the country for which the code is valid, code type, the sender name (if applicable), when the code was enabled, and the like. You can also request a sender name change from this page.

Next step: Follow the instructions in the Managing SMS campaign keywords topic to configure the keywords that can be used for the mobile codes. Only the Responsys Account Administrator can configure SMS keywords.

To request a sender name change:

Access the View codes page, as described above.
Locate the sender name that you want to change, and click the Update sender name () icon.
In the Update sender name dialog, type the new sender name and, optionally, add comments for the aggregator. Each sender name is limited to 11 characters and may include letters (a-z or A-Z) and numbers (0-9).
Click Update.

NOTE: Sender name rules and usage are subject to regulations in each country. Please contact your aggregator for questions regarding sender name support.

You can track the status of your request on the Order codes page. Once the request is completed by aggregator, the new sender name will be used for subsequent launches.

SMS Full Service

Note: If your account does not have Full Service enabled, please see the Self Service instructions. Learn more about Full Service and Self Service.

Important: This feature is currently released under our Controlled Availability program. To request access to this feature, please log in to My Oracle Support and create a service request that includes the countries to which you'd like to send messages, annual volume commit, and route type. See the possible route types.

When Full Service is enabled for your account, Oracle becomes the single contracted vendor for your account. This simplifies the process of managing aggregators and codes for your account, as Oracle Responsys manages it for you. Users can order all their codes and expected volumes via the order document.

To order codes for your route types:

Note: Oracle reserves the right to choose an aggregator for the SMS Full Service SKU.

Access the Manage Aggregator page.
The page displays a link to contact the deal desk.
Click the deal desk contact link.
In the email, request your codes and provide the countries to which you'd like to send messages and the annual volume commit.

To view codes that you can use:

Access the Manage Aggregator page.
From the list of aggregators, click Configure for the aggregator.
Click View codes.

To request a sender name change:

Access the Manage Aggregator page.
The page displays a link to contact the deal desk.
Click the link and contact the deal desk with your request.

NOTE: Sender name rules and usage are subject to regulations in each country. Please contact the deal desk for questions regarding sender name support.

Once the request is completed, the new sender name will be used for subsequent launches.

View aggregator information

To view aggregator settings:

Access the Manage Aggregator page.
From the list of aggregators, click the Configure icon for the aggregator.

The aggregator's page is displayed. From the aggregator's page, use the side tabs to view codes that you have ordered, order more codes, view the aggregator's configuration settings, or view the vendor's Delivery Receipt codes.

Note: Accounts with Full Service enabled do not display options to order more codes or to view the aggregator's configuration settings. For these kinds of accounts, contact the deal desk to order more codes.

To view Delivery Receipt codes:

Access the Manage Aggregator page.
From the list of aggregators, click Configure for the aggregator.
From the aggregator's page, click View Delivery Receipt Codes.

The table of Delivery Receipt codes is displayed. Each row shows the Category, Sub Category, DR Status code, DR Status code name, and DR Status description for a given Delivery Receipt code. The Last updated field on the page shows when the information was last updated. You can click the Download as csv file link to download the table to your system.

To view aggregator contact information:

Note: This functionality is not available in accounts with Full Service enabled. Contact the deal desk if you have any issues.

Access the Manage Aggregator page.
From the list of aggregators, click the Aggregator contact information icon for the aggregator.

The Aggregator contact information dialog shows the email address and phone numbers at which you can reach the SMS aggregator if you have issues with their service.

To view support tickets that you have filed with the aggregator:

Note: This functionality is not available in accounts with Full Service enabled. Contact the deal desk if you have any issues.

Access the Manage Aggregator page.
From the list of aggregators, click the Configure icon for the aggregator.
From the aggregator's page, click View support tickets.

The Support ticket details table shows the support ticket details for your account from the past 90 days. If there is no data, either the aggregator has not provided support ticket details yet, or no support tickets were raised during the past 90 days.

Remove an aggregator from your account

Note: This functionality is not available in accounts with Full Service enabled. Contact the deal desk if you have any issues.

You can remove or unassign an aggregator from your account only until an order is placed or if no codes are associated with the aggregator. Once an order is placed or codes are associated with the aggregator, you cannot remove the aggregator from your account.

To remove an aggregator from your account:

Access the Manage Aggregator page.
From the list of aggregators, click the Unassign icon for the aggregator.

Test aggregator mobile codes

To test an aggregator's mobile code:

Access the Manage Aggregator page.
From the list of aggregators, click the Test icon for the aggregator that you want to test.
The Test dialog opens.
From the Test dialog, select the mobile code that you want to test from the Code list.
Enter the Mobile Number that you want to receive the test message. The mobile number must be located in a valid country for the selected mobile code.
Type a Test message in the field provided.
Click Send test message. The test message is sent to the mobile number you provided. If the test number does not receive the message, please contact the SMS aggregator.