New Rules of SMS Marketing in India - Important!

W.e.f from Sept 25, 2020 (tentatively), TRAI has mandated the registration of - SMS templates, Business entities, Sender IDs & User consent with mobile operator owned DLT portals. Failing to do so will cause message delivery failure for all your campaigns. (Detailed read)

Follow the below steps to add Gupshup as your SMS Service Provider (SSP).


Click to enlarge

As shown above:

Step 1: Select SSP

Select Gupshup from the List of Available SSPs. In doing so, you will be prompted by a configuration modal.

Step 2: Name your Configuration

Please add a user-friendly name that enables you to identify the right SSP for a campaign while creating it. This comes in handy, especially when you have multiple accounts with the same SSP for sending different types of campaigns.

For example, if you have chosen to use Gupshup for sending Promotional campaigns, then we recommend that you indicate the same by naming the configuration something like:

  • Gupshup Promo Pipeline
  • Gupshup Promotional

Step 3: Add Your Username & Password

Navigate to your Gupshup dashboard to find your credentials and paste them in the configuration modal.

Step 4: Add Principal Entity ID

(Applicable only if you are sending messages to users located in India via domestic messaging pipeline. International messaging routes remain unaffected.)

  • As per TRAI's latest SMS Marketing regulations for India, you must be registered on a DLT portal as a business entity. Once registered, a unique Principle Entity ID (PE ID) will be assigned to you.

  • W.e.f from Nov 19, 2020, it is mandatory for all SSPs to pass a PE ID in the payload of each SMS message being sent to Indian phone numbers. We have partnered with Gupshup to make this a seamless process for you.

  • Simply add your PE ID during configuration - we will ensure that it is relayed to the SSP for each SMS sent to your users.

Step 5: Add SSP

Click on Add SSP to save details.

Step 6: Add WebEngage Webhook URL in Gupshup Dashboard (Highly Recommended)

Adding the WebEngage Webhook in Gupshup will enable us to receive delivery status notifications for each user. This includes campaign performance indicators like message delivered, failed, and queued.

Here's how you can go about it:

Step 6.1: As shown below, you will find your Gupshup integration under the section, Your SMS Service Provider List.


Click to enlarge

Step 6.2: Click the overflow menu placed on the extreme right, click View Webhook URL, and copy it.

Step 6.3: As highlighted below, navigate to Settings > SMS Settings in your Gupshup dashboard. Paste the WebEngage Webhook under the field, Realtime Delivery URL and click Save.


Click to enlarge



You've now successfully integrated Gupshup with your WebEngage dashboard.

You can test the integration by creating a test SMS campaign and sending it to a group of internal users (aka your teammates).

A quick guide on Editing/ Deleting an integration.

Please feel free to drop in a few lines at [email protected] in you have any further queries. We're always just an email away!