Introduction
Infobip is an omnichannel engagement platform that helps brands create meaningful relationships with their customers at scale and offers a broad range of solutions, messaging channels, and tools for advanced customer engagement, authentication, security, support, and retention.
library_add_check |
Prerequisites Ensure you have access to your Infobip Dashboard and have the API key for your Infobip account. |
Configure Infobip as a Custom SMS Connector (Service Provider)
This article will help you set Infobip as a Custom Connector on the MoEngage dashboard.
info |
Information We've revamped our dashboard settings. This article describes the steps to be followed to configure Infobip as a Custom Connector (Service Provider) in the revamped settings UI and the older UI. |
Configure in Revamped UI
Log in to the MoEngage Dashboard and follow these steps:
- Navigate to Settings -> Channel -> SMS -> Sender Configuration.
- Click +Add custom service provider at the top right corner.
- Add the following details in the Sender Details screen.
Field Description Mark as default
Turn on this toggle to mark the sender as the default sender for the service provider being configured. If marked as default, this sender would be used for sending all SMS campaigns from MoEngage unless you select a different sender while creating the campaign.
Service provider name This field identifies the service provider you are configuring on the MoEngage Dashboard and has to be unique. Type the name of the service provider here.
Sender name
This field identifies the Sender. Type the name of the sender here.
Sender type
The Sender type can either be Promotional or Transactional. Choose the Sender type as Promotional when you would be using the Sender for sending information about your brand, promoting deals, or engaging with users. Choose the Sender type as Transactional when you would be using the Sender for sending alerts about transactions, OTPs, security information, or any information that can be classified as transactional in nature.
- Configure the Webhook by adding the following details:
Field Description API URL
This field contains information about the URL that should be used to send an API request to the Sender. You can get this information from the API Documentation of the Sender. Type the API Endpoint of the sender here. The API URL for Infobip is: https://yr8qyp.api.infobip.com/sms/2/text/advanced
Method
Select POST as the HTTP method.
URL Parameters
Add the URL Parameters to be passed to the API as Key-Value pairs using this option. You can get this information from the API Documentation of the Sender. For example, if the API URL call uses the GET method, all the parameters, such as API Key, Authorization, and so on, are passed as URL Parameters.
Headers
Add the Request Headers to be passed to the API as Key-Value pairs using this option. You can get this information from the API Documentation of the Sender. Add the Authorization Header.
Body Type
Choose the Body Type as JSON and add the following details:
{ "messages":[ { "destinations":[{"to":"Moesms_destination"}], "from":"RAPIDA", "text":"Moesms_message", "intermediateReport":"True", "notifyContentType":"application/json", "notifyUrl":"YourMoEngageAccountURL" }] }
Change the values of Sender_ID and YourMoEngageAccountURL based on your Infobip and MoEngage accounts.
- Send a test SMS to verify your configuration.
- Click Save to save the Sender Configuration.
- You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to Delivery Tracking for Custom Connectors.
- You can map the attributes of the delivery tracking response manually or automatically.
Configure in Old UI
Log in to the MoEngage dashboard and follow these steps:
- Navigate to Settings > Channel > SMS & Connectors and click the SMS Connector Config tab.
- In Custom Connecters, click +CREATE.
Step 1: Set the Connector
Fill in the following details:
Field | Description |
---|---|
Connector Name | Type the name to identify the Infobip custom connector. |
Sender Name |
Type the name to identify the Infobip sender. |
Step 2: Configure Webhook
- Add Infobip API URL. Use POST Method to send the API request and copy the URL below in API URL Field.
https://yr8qyp.api.infobip.com/sms/2/text/advanced
- Add the Authorization Header details request headers as shown below.
- Choose the Body Type as Raw and add the following details:
{ "messages":[ { "destinations":[{"to":"Moesms_destination"}], "from":"RAPIDA", "text":"Moesms_message", "intermediateReport":"True", "notifyContentType":"application/json", "notifyUrl":"YourMoEngageAccountURL" }] }
Change the values of Sender_ID and YourMoEngageAccountURL based on your Infobip and MoEngage accounts.
Step 3: Test and save the settings
Do a test SMS to make sure everything is set up correctly. And finally, click Save to save the settings.
Step 4: Delivery Tracking
You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to Delivery Tracking for Custom Connectors.
Sample response from Infobip for a successfully sent message
Sample response from Infobip for a delivered message
Mapping delivery response
Choose fields from Delivery Response to auto-populate the response mapping fields, as shown below.
Next Steps
- Create an SMS campaign using the Getting Started for creating SMS campaign.
- Set the Frequency Capping for SMS.
- Set the Current Service Provider.
- Read more about campaign analytics.