To get started with SMS messaging you will need an account on xtremepush and a project. You can login at dashboard.xtremepush.com. Once logged in if you don't have one ready to use, add a NEW project.
Don't have a login?
If you are already a customer all accounts come with multi-user access and the person(s) in your organisation who is responsible for administration of user access will be able to provide appropriate user access to users who are; involved in the integration process, running campaigns etc. If you need help please contact your account manager or submit a support ticket.
If you are not a customer please request a demo.
If you are creating a New project you will need to enter the following details and click save to initialise your project:
- Title: Name used to identify project on the platform, something obvious to help you find it.
- Description: A short description of what the project is for.
- Timezone: The timezone used for analytics in the project. Important this will dictate the starting point for analytics like daily users. You can set this to the local timezone of platform users if this makes sense. Default is UTC, which is a good compromise if users are likely to be spread across different timezones.
- Icon: Helps to identify project on the platform, use app icon to help you find it.
In order to send SMS via the Xtremepush platforms there are two main options you can use the Xtremepush SMS channel or if you already have a vendor for SMS you can integrate them using a webhook so the SMS sends you do with that vendor can be incorporated into your multi-channel strategy.
Xtremepush SMS Channel
If Xtremepush SMS is enabled in your account when you go to create a campaign the SMS channel will be an option.
Can't see the SMS channel?
SMS is disabled by default on customer accounts to prevent charges being incurred accidentally as there is a charge per message. If you need SMS enabled please contact your account manager or submit a support ticket.
If you are not a customer please request a demo.
If SMS is enabled then you can send SMS in standalone campaigns or as part of wider multi-channel programs. You may for example use push notifications as a primary channel on certain campaigns with SMS as a fallback channel (see example below SMS goes to users not subscribed for push).
Once SMS is enabled you will initially want to do some quick tests details on getting started in the next section.
In order to send an SMS to yourself you will need a mobile number in a user profile and active SMS subscription. If you have company admin access you can edit your user profile or create a new one if none exist.
Navigate to Data > Project Data > User Profiles
Then select Create User Profile
Add your mobile number in the format - international dial code (not including prefixed zeroes 00) followed by mobile number (not including prefixed zero 0) set SMS subscription to yes, and save the profile.
To test SMS create your campaign the way that you normally would. Select the SMS channel and on the SMS channel page enter your brand name in the from name and some text for the SMS message.
If you have multiple users and you want to target your own mobile, you can simply use your mobile number in a target segment using the mobile number is condition from the identifiers section of the segmentation engine.
When ready launch the campaign and you will receive an SMS.
Importing More of Your Users
Once you have setup and tested the basics of SMS sending you will likely want to import existing users or begin collecting new users through xtremepush.
For details on how to add some more test users view the docs on:
If you are ready to build out your longer term strategy for importing users from your backend system of record visit the Data section of the docs and review it. The User profiles quick start guide would be a great place to get started a it has all the info you will need on how to sync user profiles with the platform via API and other methods.
Integrate an Existing Provider using a Webhook
Enable the Webhook Channel
The Webhooks channel is required in order to enable SMS. If you are not familiar with this channel Check the Webhooks - Quick Start Guide. Secondly you will need an account, credentials and API documentation for the service you want to send SMS with. You can build your SMS channel using a webhook template, mapped to an SMS providers API. In the next section we detail sample SMS channels built using different providers.
Create an SMS Channel template for an SMS Provider
We have documented some sample SMS providers that have been integrated with the xtremepush platform, click on a provider for more info on how to setup an SMS channel:
If you want to use another provider you can simply build a channel template based on that provider API for sending messages similar to examples above. If you need help integrated with your service provider or do not have an SMS vendor and need pricing please contact your account manager.
To test SMS create your campaign the way that you normally would. Select the webhook channel and on the webhook channel page pick your SMS template:
You can target test user(s). For example for an SMS channel like below:
You can target your own mobile based on a segment that targets your user if or your mobile_number attribute. Details on how to upload test users with the necessary attributes and target them can be found in:
Run a test and you should receive your test message on your mobile device. If you have an errors troubleshoot them as described in the webhook guide. Your SMS channel can be added as a complimentary channel to a campaign that also includes a notification or another comms channel. One common use case is to use the SMS channel as a fallback channel for users who have not opted-in to other notifications. The SMS channel can be trigged just like other channels one use case for this is basket or other drop-off recovery type campaigns.