# SMS Integration

SMS Integrations enables you to send enrollment requests as text messages to the user’s devices using SMS service providers like Twilio, Nexmo, and Sinch. The administrators can add their vendor accounts to the portal and send enrollment SMS to the users. You can also use the SMPP server configuration instead of vendor account credentials.

Configure SMS Settings
----------------------

Follow the steps below to configure SMS Settings on your Hexnode portal.

1. Go to **Admin > SMS Settings**.
2. Select an SMS vendor from the list, for which you’ve signed up for, and fill in the credentials you obtained from the SMS vendor.
### SMS Vendor

#### **Twilio**

To integrate your Twilio account,

1. Login to your Twilio Account.
2. Go to Dashboard. The **Account SID**, **AuthToken**, and sender phone number will be shown.
3. Now login to your Hexnode portal and configure the following settings.
**Settings****Description**Account SIDEnter the **Account SID** of your Twilio account. It acts as a username.AuthToken Enter the **AuthToken** of your Twilio account. It acts as a password.Sender Phone number  The phone number from which you wish to send an enrollment SMS.
 The number must satisfy the below conditions: - Limited to a maximum of 15 digits.
- Should be prefixed with a leading + (plus) sign, Country Code, Local Area Code, Local Phone number.
- Cannot contain spaces, special characters such as (,),–.
 

5. Click **Save** to add the account.

#### **Nexmo**

To integrate your Nexmo account,

1. Login to your Nexmo Account.
2. Go to **Get Started**. The **API Key** and **API Secret** will be displayed here.
3. Now login to your Hexnode portal and configure the following settings.
**Settings****Description**API KeyEnter the **API Key** of your Nexmo account. It acts as a user ID.API SecretEnter the **API Secret** of your Nexmo account. It acts as a password.Sender Phone number  The phone number from which you wish to send an enrollment SMS.
 The number can contain numeric or alphanumeric values that must satisfy the below conditions: - Limited to a maximum of 15 digits.
- Can include a string of up to 11 supported characters.
- Cannot contain spaces, special characters such as (,),–.
- Cannot include leading + and access codes such as 00 or 001.

5. Click **Save** to add the account.

#### **Sinch**

To integrate your Sinch account,

1. Login to your Sinch Account.
2. Under **Communication APIs** navigate to **SMS > API’s**. The Service Plan ID, API Token, and phone number linked will be shown here.
3. Now login to your Hexnode portal and configure the following settings.
**Settings****Description**KeyEnter the **Service Plan ID** of your Sinch account. SecretEnter the **API Token** of your Sinch account.Sender Phone number  The phone number from which you wish to send an enrollment SMS.
 The must satisfy the below conditions: - Limited to a maximum of 15 digits.
- Should be prefixed with a leading + (plus) sign, Country code, Local Area Code, Local Phone number.
- Cannot contain spaces, special characters such as (,),–.

5. Click **Save** to add the account.

#### **SMPP**

You can also activate SMS settings using SMPP server configurations.

1. Login to your Hexnode portal and configure the following settings.
**Settings****Description**SMSC ID Enter the SMSC ID to which the SMPP SSU routes the message. SMPP HostProvide the SMPP host address.SMPP Port Enter the SMPP port number.Sender Phone number The phone number linked with your SMPP, from which you wish to send enrollment SMS.
 The Sender Phone No cannot contain special characters except white spaces, +, ( , ) ,–. PasswordEnter the password of your SMPP account.3. Click **Save** to add the account.

The **Test SMS** button lets you send a test SMS to any given number and see if the vendor account is added successfully.

The **Remove button** is used to remove the vendor account currently linked with the portal.

[![SMS integration](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2018/08/Screenshot_20180821-112938-1.png)](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2018/08/Screenshot_20180821-112938-1.png)After saving the SMS settings
-----------------------------

After saving SMS settings, you need to enable Text/SMS to start sending enrollment SMS to devices. To do this,

1. Go to **Enroll** tab > **Settings.**
2. Check **Text/SMS** under **Request Modes.**

Sending Enrollment Requests
---------------------------

After successfully syncing your vendor account, you can start sending enrollment requests via SMS to users.

### For already existing users,

#### Method-1

1. Go to **Enroll > All Enrollments > Invite > SMS** or **Enroll > Platform specific > Android / iOS / macOS > Email or SMS.**
2. Select the type of users to be enrolled and set **Ownership.**
3. Click **Continue.**
4. Select the **Domain.**
5. To send a request to a single user, select the user from the list of users and click **Send**. For multiple users, switch to **Bulk user** and upload a CSV file with valid entries and click **Next**. Now choose Send enrollment SMS and click **Send.**

#### Method-2

To send enrollment requests to selected users,

1. Go to **Enroll > Status**.
2. Select the user(s) to whom enrollment request is to be sent.
3. Click on **Manage > New Enrollment**.
4. Click **Send** to send enrollment requests as SMS messages.

#### Method-3

To send enrollment request to selected users,

1. Go to **Manage > Users**.
2. Select the user to whom enrollment request is to be sent.
3. Click on **Manage > New Enrollment.**

Enrollment request will be sent to the selected user.

#### Method-3

To send enrollment requests to selected AD domains, OUs, or groups.

1. Go to **Manage > Directory Services**.
2. Select the domain or OUs, or groups.
3. Go to **Actions** and select **New Enrollment**
4. Click **Send**.

 Note:- Enrollment requests as SMS messages can be sent only to those users whose mobile numbers were included in the appropriate field during user creation.

 

### If the user doesn’t exist, create a new user

#### Method 1

1. Go to **Manage > Users.**
2. Click on **New User**.
3. Enter Display name, Domain, Email, Mobile number.
4. Check Send enrollment request and **Save.**

This sends an Enrollment request to the user’s phone and Email inbox.

#### Method 2

1. Go to **Enroll > All Enrollments > Invite > SMS.**  or Enroll > Platform-specific > Android / iOS / macOS > Email or SMS.
2. Select the type of users to be enrolled and **Ownership** status.
3. Click **Continue.**
4. Select the **Domain.**
5. To send the request to a single user choose **Select user**, click on **+Add New User** and provide the user details. But for multiple users, switch to **Bulk user**, click on **Choose file** and upload the CSV file with the user details.
6. Map the keys and Submit.
7. In the case of Bulk users, click on **Next** and verify the details of the CSV uploaded.
8. Choose **Send enrollment SMS** and click **Send.**

 Notes:- In the case of Bulk users, the CSV file added should contain the details of users synced in the chosen domain. If not, an error message will be displayed. This is not an issue in the case of a **local user.**

 

![Enrollment Text Message](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2017/01/Page-37-Image-85.png) Notes:- If you have not previously configured SMS Settings from the Admin tab, you can configure from the Enroll tab itself.