To send an SMS via MoEngage, you need to integrate with an SMS service provider. You can either configure the integrated connectors (service providers) or custom connectors (service providers) in MoEngage.
Integrated Connectors(Service Providers)
MoEngage has native integrations with some SMS providers - Gupshup, Kaleyra, ICS, Sinch, and Twilio. These are present under the hood Integrated Connectors on the MoEngage SMS settings page. MoEngage can work with you to set up an account with any of these providers, or you can also configure your existing account with any of these providers on MoEngage.
Refer to the following articles for detailed steps on configuring integrated connectors(service providers).
info |
Information We've revamped our dashboard settings. This article describes the steps to be followed to configure the Sender details for the SMS channel in the revamped settings UI and the older UI. |
Custom Connectors(Service Providers)
If you wish to integrate with a provider apart from the ones mentioned above, you have to work with the provider to set up an account and configure it on the MoEngage dashboard as SMS Custom Connectors.
Refer to the following articles for detailed steps on configuring custom connectors.
Configure Sender
You have to configure senders for integrated and custom connectors(service providers). By having separate threads, you can configure multiple senders for an SMS service provider and streamline your SMS communications for different brands or types. Moreover, you can choose different senders for different SMS campaigns during the creation of SMS campaigns.
Configure Sender (Revamped UI)
You can do the following operations in this section:
Add a Sender
To add a Sender:
- Navigate to Settings -> Channels -> SMS.
- Sender Configuration is the first tab in the SMS settings. You can add a new Sender by clicking +Add Sender at the top right corner.
- The integrated service providers are listed. You can choose one from them or add a custom service provider. For more information about adding custom service providers, refer to Configure a Custom Service Provider.
- To add a sender for an integrated service provider, click on the Integrated Service Provider from the list. You will be asked to enter the following:
Field Description Sender type
The Sender type denotes whether the sender is used for promotional or transactional messaging. Select Promotional or Transactional based on your use case. Sender name
The Sender name is the name that identifies the sender being configured. This name will be available in the Sender selection dropdown while creating campaigns. The default sender configured will be used for sending the SMS campaigns. However, this default setting can be overridden at the campaign level during step 2 of campaign creation. Sender ID
The Sender ID is the name or number that is displayed as the sender of the SMS message. - Depending on the Sender being configured, the fields in the UI will vary. For example, some senders may require a username and password, others may require API endpoint URLs, and so on. For more information, refer to SMS Providers for vendor-specific configuration details.
- Copy the Delivery tracking URL available on the dashboard and paste it into the callback webhook settings of your service provider.
- Click Send a test SMS to test your configuration.
- Click Save to save the Sender details.
View a Sender
To view a sender:
- Navigate to Settings -> Channels -> SMS -> Sender Configuration.
- Click on the ellipsis on the sender listing that you want to view.
- Click View.
- You can Send a test SMS to verify your sender configuration.
Edit a Sender
To edit a sender:
- Navigate to Settings -> Channels -> SMS -> Sender Configuration.
- Click on the ellipsis on the sender listing that you want to edit.
- Click Edit.
- You can edit all the details in the Sender Details screen that loads except for the Mark as default toggle.
- Click Send a test SMS to check your configuration.
- Click Save.
Delete a Sender
To delete a sender:
- Navigate to Settings -> Channels -> SMS -> Sender Configuration.
- Click on the ellipsis on the sender listing that you want to delete.
- Click delete. You will be asked for confirmation with a message that states that the active campaigns for the sender being deleted will be sent using the default sender.
- Provide confirmation to delete the sender.
- Note: You cannot delete a default sender. To delete a default sender, mark another sender as the default first. This will enable the delete option for the sender you want to delete. You can now proceed to delete the sender.
Default Sender
A default sender is a sender that will be picked up by default for sending all SMS campaigns unless you choose a different sender at the campaign level.
- The first sender added to your SMS channel will be the default sender.
- To set a sender as default:
- Click on the ellipsis on the sender listing that you want to mark as default.
- Select delete. You will be asked for confirmation with a message that states that the active campaigns for the sender being deleted will be sent using the default sender.
- Provide confirmation in the confirmation popup.
- The default sender can be identified by the word Default beside its name.
Configure Sender (Old UI)
Add a Sender
To add a sender, go to SMS settings > SMS Connector Config. Select the Connector you want to use: an integrated connector or a custom one. Click +ADD SENDER to create a new tab. Set a sender name, type (Transactional or Promotional), and enter the credentials. Once you click on Save, the new sender gets created.
The following screenshot shows SMS GupShup having 2 Senders - 1 for sending promotional messages and the other one for transactional messages - identifiable by (P) & (T), respectively.
Delete Sender
To delete a sender, go to the Sender tab and click on the "X" button as shown here: You cannot delete a sender if it is also set as a default sender.
Default Sender
A default sender is the one that will be picked up by default for sending all SMS campaigns unless you choose a different sender at the campaign level.
- You can set a sender as default by simply using the toggle button.
- The default sender can be identified by the green circle containing D.
- There will be only one default sender across all the connectors, each with its own default sender.
warning |
Deleting a default sender If you delete a sender and that sender is associated with a campaign, then the default sender will be used as a fallback, and the campaign will now be sent via the default sender. |
Add Sender to customer connector
You can add multiple senders, delete senders, and set any of them as default under Custom Connectors.
In addition to this, you will get two options when you try to Add a Sender in Custom Connector:
- Copy details from an existing sender: Choose this option if your new sender has similar parameters to the existing one and only a few parameters will be changed. This will help minimize the additional work. This is applicable only within a connector, meaning that you cannot copy details from the sender of 1 custom connector to another sender of a different custom connector.
- Enter new details: If the new sender is very different from the existing sender, then you can choose this option and all the details afresh.
warning |
If you are sending SMS to Indian mobile numbers
|
Next Steps
- Configure SMS General Settings
- Configure FC Settings
- Configure DND Settings
- Configure Subscription Categories
- Configure Custom Domain
- Configure Data Privacy