Conversations for Service Providers

Introduction

The White Label messaging platform enables you, as Service Provider, to start a Software-as-a-Service business under your own brand and provide your customers conversational-style messaging software. It’s a turnkey solution that offers instant setup and configuration of customer accounts and allows your customers’ existing phone numbers to be text-enabled. White Label seamlessly interfaces with the Aerialink Gateway, connecting your customers to mobile end-users around the world. The subscription-based SaaS can be managed in Aerialink’s private cloud, your own private cloud or your customer’s own registered domain.

In this guide you will receive step-by-step instructions and learn concepts key for service provider setup of the application. To learn more about what the application is and how to perform functions as an Agent, see our For Agents guide. For standard admin instructions (like the ones your customers will need), check out For Admins

Please refer to the 8xx Reach tab on our Long Code Reach List for supported carriers on this route.

Step 1

To get started with White Label, Aerialink will provision your own account so that you as the Service Provider can text with your customers. This setup also lays the framework for you to add sub-accounts and customers. You can choose a custom domain address or utilize a default conversations domain address with your company name.

Step 2

Next, you as the Service Provider can brand your account using the Theme feature to add logos and select a color scheme. This “Owner Theme” can also be used for any of the companies - your customers’ sub-accounts - set up under your account, or they can each have their own theme.

Step 3

White Label enables Service Provider-level accounts to create and manage multiple “companies” within the application, and select the functionality each company will receive. Each company is a self-contained instance of the application that can be modified to suit your needs as a service provider, and is used by your customers. Although you will attribute administrative accounts within each company which will give those users admin control over that specific company, they will not be able to access the service provider account.

The Service Provider will set up their customer’s company account by initiating a request to Aerialink. Once the account is provisioned in the Aerialink Platform, the Service Provider can add the company.

Service providers can also manage a company’s Agents, numbers and groups.

Get Started

The dashboard of a service provider looks similar to any other account with one exception - access to the Service Provider Menu.

To access the service provider menu:

  1. Log into the application
  2. Click the dropdown for your company, located in the upper right-hand corner of the page.
  3. Select “Service Provider Menu.”

Optional Features

Conversations for Service Providers offers many optional features you can use to customize your Conversations experience for you and your users, such as:

  • Email forwarding by user
  • TXT relay by user (forwards messages to the native messaging app on an Agent’s mobile device)
  • Account-wide MMS enabling
  • Number-specific MMS enabling (allow inbound and/or outbound)
  • Message concatenation enabling
  • Click-to-Text
  • Private groups
  • Agent-Number lock (allows Agents to send messages only from numbers assigned to them)
  • Country code requirement disabling (+1 will no longer be required when setting contact number for end-users)
  • Dealer Intelligence Repair Order Status*

*Available to auto dealers with Dealer Intelligence on their accounts

Brand The Application

As a White Label user, you can alter two themes - the Service Provider theme and the Company theme. Setting the Service Provider theme allows you to fix the application’s color scheme, your Service Provider logo, the application logo and application name for all company accounts set up under your Service Provider account. Then, any Company-level theme beneath your Service Provider account can alter the theme somewhat by changing the color scheme or the company/application logo.

By default, a Service Provider’s theme carries over to each of their sub-accounts/companies. Each individual company has the ability to modify this default theme. The company may change the theme colors, and replace the Service Provider’s Application logo with their own logo. However, the Company cannot change or replace the Service Provider’s Logo.

To alter and customize your theme:

  1. From Settings, click “Theme” under the “APPLICATION” subsection on the left-hand sidebar.
  2. Select the turquoise “EDIT THEME” button at the top of the page.

Note that the tip text recommends a logo that is at least 350 pixels wide with a transparent background. However, be aware that transparency is only supported via GIF and PNG image types, so be sure to save your image as one of those two formats and that transparency is enabled upon saving. Otherwise, the image uploaded will display a white background.

Add New Company

Adding a new company requires the configuration of three components:

  • “New Company” details.
  • At least one number associated with the company.
  • At least one Agent in the “admin” group.
  • A new connection or subaccount under your Aerialink Platform Portal account. (See Account Structure below for details.)

You can access your Companies by clicking either on “Companies” under “COMPANIES” in the left-hand nav, or by clicking the “Companies” link on the Service Provider Overview page.

  1. Click the “Service Provider” link in the dropdown menu in the upper right corner.
  2. Access “Companies”
  3. Click
  4. Retrieve the API credentials from Aerialink Platform associated with your connection.

  5. Enter the desired settings for the company.
  6. Click when finished.

Account Structure

For every new Company added to your Conversations account, we recommend adding a new connection or subaccount to your Platform Portal account as well to provide better reporting capabilities per company.

You can add a connection through the Connections API, or simply email support@aerialink.com and our team will set your new connection or subaccount up for you. If you need separate invoicing for the new Company, request a subaccount; if you don’t, request a new connection with a Conversations endpoint. As a best practice:

  1. Please provide the team the same name for the new connection or subaccount that you intend to use for the new Company in Conversations (e.g. specify in your support request to name it “ABC Company.”)
  2. Specify the number(s) that will be associated with the new Company so that they can be added to the connection or subaccount.

Once this has been set up, you will use the API credentials for the connection/subaccount to link the Company on Conversations to your Platform Portal account and send traffic.

Individual View

A company’s account configuration may be set to this view on the Company Profile page. Enabling Individual View removes some features for a simplified user experience designed for a single user. Some of the changes are outlined below.

Message Center

Because the Message Center will now be used by only one person:

  • “Owner” button is removed, thereby disabling “Transfer” and “Claim Ownership.”
  • “Just Mine,” “My Groups” and “Unassigned” Views are removed

Settings

Because this configuration allows for only one Agent and one number:

  • “Company Profile” is disabled
  • “Agents” is disabled
  • “Business Numbers” is disabled
  • “Auto-Assign by Number” is disabled
  • “Groups” is disabled
  • Quick Replies can no longer be “shared.”

Concatenated Messages

A company’s account configuration may be set to allow concatenated messages which removes the 160 character limitation. If concatenated messages are enabled, an Agent may include up to 459 characters/spaces in a single message send. This is sent as multiple messages.

Important Note: Unlike the AT&T, Verizon and T-Mobile networks which support concatenation - automatically splitting their messages and then sewing them back together in order - the Sprint network lacks this support. Therefore, messages in excess of 160 characters may arrive at Sprint destination handsets out of order. Because of this, the standard 160-character limit is recommended.

MMS Messages

Delivery of MMS (Multimedia Messages) to U.S. and Canadian destinations is supported on 8XX and standard business numbers, as well as on U.S. short codes specifically certified for MMS delivery. Additional details regarding file type and size can be found here, but note that images are resized by the application for improved delivery to carriers.

A Service Provider account may enable a sub-account with MMS. Note that once the account is MMS-enabled, each individual number must also be MMS-enabled. In other words, MMS is enabled at both the connection and the number level.

Manage Company Agents

Adding Agents

To add an Agent a Company you’ve created:

  1. Select the Company to which you wish to add the Agent.
  2. Once inside the Company, click “NEW AGENT FOR COMPANY.”
  3. Ensure that the desired company is selected in the “Company” field, then fill out the information for the Agent.
  4. When finished, click “ADD AGENT.”

Restricting Agents

To restrict the number of Agents that can be added to a Company:

  1. Access your Service Provider menu.
  2. Where the max number of Agents is left blank by default, insert the number you would like the cap to be. Leaving it blank allows it to remain uncapped.
  3. Save.

Delegate Numbers & Groups

In order for your customer’s account to work, you must add at least one text-enabled number.

A single company may have add multiple numbers. A number may be set to auto-assign to a specific Agent or group.

Numbers

  1. From the desired Company’s page, click “NEW NUMBER FOR COMPANY.”
  2. In the “Name” field, enter a name unique to the code you are adding. (optional)
  3. In the “Number” field, enter an Aerialink long-code, TEXT number, or SMS-enabled Toll-Free Number you wish to associate with the specific Company’s account.
  4. Select the Company.
  5. Choose which Agent(s) or group(s) (if any) you would like to receive the number’s messages automatically.
  6. Select “SAVE NUMBER” when finished.

Bear in mind that Numbers can also be viewed on the account level for you as a Service Provider. If you select “Numbers” under “APPLICATION” on the left-hand side, you can add a new number without going through the individual Company’s page - this is convenient if you are adding multiple numbers to multiple Companies simultaneously.

Groups

The “Admin” group is created by default when a Company is created. To add additional groups:

  1. Click “Groups” under the Application section of Settings.
  2. If no Groups exist, click “New Group.”
  3. Choose the Company the group will exist within. This will also determine which Agents can be a part of the Group, as only Agents within that same Company will have access to that Group.
  4. Enter the Internal Name the application will use for the Group.
  5. Enter the Nice Name you wish your Agents to see.

Opt-ins & Opt-outs

For more details about opt-ins and opt-outs, see the Agents User Guide.

Gateway-Level Settings

There are some additional options for Service Providers which can and may be enabled on the application account:

  • By default, the gateway’s “Enforce-Opt Out” blocking agent is disabled to allow application-level logic to manage opt-out.
  • Service Providers can set up a gateway-level, auto opt-out confirmation message in the platform portal via the Hosted Auto Replies feature (e.g. “You have opted out and will receive no more messages”). This is not a requirement, but an optional courtesy message to provide confirmation to a user that the opt-out did in fact get logged.
  • A single gateway-level message can be applied across connections and numbers, or the message can be customized by connection and number.

This page was last updated 1529723856305