Set up SMS
- Create an SMS database.
- On the Create database/list page, select the flexible database option and ensure it is in a shared location. You can use an existing flexible, single opt-in database, as long as you can add SMS fields.
- Add the SMS phone number type field. In Field name, type the name of the field that will contain the SMS Phone Number value.
- In the Field type list, select SMS phone number.
- Click Add field and save.
Note: Any required fields in your database must have a default value, as SMS cannot update null values.
- On the View data page, select the name of the database you want to use for your SMS campaign.
- Click Settings on the Database summary page.
- Click the Mobile settings tab, select Enable SMS, and enter the name of the SMS phone number field.
Note: The remaining steps are only if you use the SMS campaign manager. If you create SMS programs directly in Acoustic Campaign, you completed the setup and you won't see Campaign Manager option in the SMS menu. Instead, you'll see SMS programs.
- Integrate SMS programs and SMS campaign manager.
- Go to Organization settings and expand Application account access.
- Click Add account access and select SMS integration under Application.
- Select an org admin user for the integration under User account. The org admin must have SMS enabled at the user account-level because certain API calls from SMS partners require that the API user is enabled for SMS in the application. To verify that this setting is enabled, go to User Accounts and expand User Permissions. Verify that the Enable SMS option is checked.
- Click Add. An email is sent to the org admin that contains the user account refresh token.
- Add the refresh token to set up the SMS campaign manager for your organization.
- Navigate to SMS > Campaign manager in the ribbon.
- Click Admin and select ID configuration.
- Click Edit and paste the refresh token.
Note: This setup occurs one time for the entire organization.
Each organization can have only one SMS-enabled database. If your organization is also mobile app notification-enabled, it can have one SMS database and one mobile app messages database, or one database that is enabled for both SMS and mobile app messages. The administrator adds the database ID after SMS is enabled in the database.
Set up a program with the SMPP gateway
- From the navigation bar, select SMS > SMS programs and choose your desired program from the New SMS program dropdown menu.
- Select and fill in the details for your program. The Help message checkbox enables a dropdown for additional details for your program.
- After determining the status for your program (Active or Inactive), select Save.
SMS program types
Choose the optimal SMS program for your communication goal from the selection below:
|Goal||Type of program|
|Get a one-time response from customers in response to a product, promotion, or service.||Text for info|
|Send ongoing marketing messages that include offer coupons, company news, offers, and so on.||Text to join|
|Collect email address opt-ins through text messages.||Text for email|
|Build an advanced program to create custom interactive programs for surveys, quizzes, contests, or drawings.||Multi-step|
|Create a double opt-in message by using web forms.||Multi-step|
|Create a sweepstakes.||Competition|
|Collect and automatically count responses by using polls or votes.||Voting|
|Eliminate ambiguous consent with an additional opt-in confirmation.||Text for response|
Text to join program
Text to join is created to build a list of mobile numbers that can receive promotional SMS messages. This is required for both one-way and two-way messaging. For two-way messaging, set up a Mobile Originated (MO) keyword to capture the opt-in for the mobile user. After a mobile user text in the keyword to the short or long code, the mobile phone number is added to the database.
Mobile users enter a keyword and receive a confirmation SMS message. You can send one-time or recurring SMS messages to contacts that opt in to your program.
Note: After you create a text to join program, you cannot delete it. This security measure eliminates the risk of having orphan consent records.
When a contact texts STOP, CANCEL, END, UNSUBSCRIBE, or, QUIT to the code, their mobile phone number is opted-out of all previously opted-in text to join programs on that code. If this code is shared by more than one organization and pod, the subscribed number is opted out from all text to join programs across all organizations and pods.
Text for info program
The text for info program uses a one-time SMS response to a specific keyword. It works well in numerous types of interaction, such as product, promotion, or service information, instantly providing your customers with the information they need.
If you are using a dedicated code, you need to set up and maintain SMS programs that process STOP and HELP keywords.
First, determine a keyword to use and a method of advertising the keyword and code (short or long) combination to engage your customers. After your customer texts the keyword to the code, they will receive a one-time SMS message that you previously configured.
A multi-step SMS program enables you to create complex interactions with configurable conditions and responses. This program type is used for various flows, including surveys, quizzes, entries for contests or drawings, validations.
You can set up Acoustic Campaign landing page forms to capture double opt-in for countries that require it through web forms.
Text for response program
Create a text for response program to send SMS marketing messages to customers who signed up via a web form. This enables a double opt-in process that confirms a user's desire to join a text messaging list.
To support this program, you will need to have an active text to join or a one-way program, and a published web form that will send the first opt-in message.
Considerations: Should you use dedicated codes or shared codes?
Use a dedicated code
If a text for response program is created with a dedicated code, the usage of a keyword is optional. You may choose to add one or more listeners to the program, and the user may respond with any of the listener(s) as text. Note that the “listener + code” combination needs to be unique so that the system can uniquely identify the program.
If the end user chooses to add keywords as an additional unique identification for the text for response program, you must send a keyword + listener as the message text. Also, the keyword + code needs to be a unique combination.
Two unique combinations are possible in the case of dedicated code:
Listener1 to Code, Listener2 to Code, etc.
Keyword1 + any listener to Code, Keyword2 + any listener to Code, etc.
Use a shared code
A code can be shared at SMS aggregator level (e.g. Karix) assigning a shared code to Acoustic and some other clients, OR a code can be shared with multiple organizations of the same client. If a code is shared by either of the two options, the aggregator needs to have a mapping of the keywords against each org on their end.
The text for response program is created with a shared code and keyword. You may have the additional option of assigning listeners for separating affirmative and negative responses.
The only unique combination is Keyword1 + any listener to Code, Keyword2 + any listener to Code.
Text for email program
The text for email program enables a mobile user to submit their email address with a keyword to the designated short or long code. Their email is then added to the marketer's database as opted-in for email channel, and they receive an SMS confirmation of their submission.
When a mobile user texts the keyword and the email address, the autoresponder sends an email to the email address provided. In this case, the mobile user texts 'COUPONS email@example.com' and receives an email at the email address that is provided and the SMS user sees that John’s email address added to the database or updated with the email consent status.
Using SMPP for a text for email program
- A user submits their email address via the SMS channel.
- The SMPP Receiver listens to SMS and creates an Email Consent Status for the email to send to Engage.
- The SMPP sends the relative reply message to the user.
Using mGage for a text for email program
- Select an email and then configure and automate the text for email program.
- Mobile users send an MO SMS to the code using this : [keyword] [space] [email address].
- Mobile users receive an MT SMS message if the marketer selects Yes for Send response and sets up a reply message.
- The user's email address is added to the SMS database and is marked as opted-in for email channel.
- The autoresponder sends an email to the email address that the mobile user provided.
Set up a text for email program with mGage
- In Acoustic Campaign, choose the email template that you want to automate and then complete the template.
- In Setup as autoresponder based on trigger event, choose Custom.
- Get the autoresponder's mailingID. Go to the Autoresponders tab on the Emails and templates page. Hover your mouse over the email name to show the mailingID. Copy it.
- Complete and activate the text for email template. See Basic details and Message details for a description of each field.
- Name: Name your program.
- Campaign: Assign the program to a parent campaign.
- Program duration: You can choose to have an ongoing program with no end date, Indefinite, or define the start and end dates.
- Start time and date: Choose a start time and date.
- End time and date: Choose an end time and date.
- Text to code: In the Code list, click the short/long code.
- Keyword(s): Assign a keyword to your program. On a Shared code, if a wanted keyword is not available, the system generates an error message.
You can set up more options, such as Time slot and Secondary keywords.
- Originator: The field shows when a non-US code is selected. Used only for countries that support Sender ID. Select the MT sender. Acoustic provisions this field for you. To request a custom originator ID, see How do I request a custom originator ID?
- MailingID: Enter the autoresponder's MailingID here.
- Send response: Select Yes or No.
- Reply: In Send response, if you select Yes, enter the MT SMS message that the mobile user receives after they join this program.
- Stop message: The message the mobile user gets when they send the keyword [program name] STOP.
- Help message: The Help message provides the mobile user with additional information or contact information to the customer service line.
- Advanced options on the template. Click Show advanced options.
Note: If you send a message that uses more than 160 characters (GSM 03.38 character set) and the carrier supports concatenated SMS, the longer text is sent as a concatenated message.
Action settings: choose one of the following options:
- Save entries and forward to email
- Save entries and forward .csv file to email
- Opt-in end user: Select Yes to redirect the user to a text to join program.
Text for email example scenarios
- User opt-in scenario:
- A user sends: XMAS firstname.lastname@example.org to 56567
- The SMPP sends the reply message to the user.
- The SMPP hits Engage kafka topic to opt-in the email email@example.com
- If a Text-To-Join program is linked to Text-To-Email, the phone number is also opted-in for that program.
- User opt-out scenario:
- A user sends: XMAS STOP firstname.lastname@example.org to 56567
- The SMPP sends the stop message to the user.
- The SMPP hits the Acoustic Campaign kafka topic to opt-out the email email@example.com
- If the Text-To-Join program is linked to Text-To-Email, the phone number is also opted-out for that.
- Help scenario:
- A user sends: XMAS HELP firstname.lastname@example.org to 56567
- The SMPP sends the designated help message to the user.
Engage audiences with SMS sweepstakes or contests using a competition program. There are three types of competitions, including: question and answer, prize draw, and instant winner.
First, configure the type of competition:
- Question and answer: This type of competition requires a call to action. It is configured so that each possible answer is a keyword and users only send in a keyword that corresponds to their answer.
- Prize draw: This competition is an entry collector. It accepts all entries into the program and enters them into the drawing. When a mobile contact sends an SMS text with the correct answer, it is counted as an entry. This type of program continues to run and collect entries until the end date. It allows you to set a unique reply when a participant tries to enter the competition after the end date. You can determine the winner by using the SMS campaign manager or exporting the participant list a CSV file and select the winner per the contest rules.
- Instant winner: The program can automatically identify the winners to the competition. The odds are selected from a list of pre-defined odds ranging from 1 in 10 to 1 in 10,000.
In competition programs, users send a text message from their mobile phones and the SMS campaign manager processes the entries. After the competition ends, the winner pool is considered complete and the winner selection feature becomes available, except in instant winner games. You can then export program data such as mobile users, incoming messages, and correct answers.
Competition is an advanced SMS program type. In the US, a client is required to have a dedicated short code and the short code must meet US carrier approvals to run a competition to collect entries by way of SMS. This program type is not available by default and requires provisioning to activate after the criteria for the client to use this program type has been verified. Contact our support team to request access.
Voting programs gather customer input and opinions by creating fun and engaging SMS polls. Collect mobile numbers with each vote and see what your audience has to say.
Use the voting program to collect and count specific responses. This program type can be used for polls or votes and automatically tallies up the responses, which can either be a keyword or a text string. Tallying is based on exact matches to other entries.
In the US, a client is required to have a dedicated short code that must meet US carrier approvals to run this type of program via SMS. Therefore, this program type is not available by default. Contact our support team to request access.