Infobip

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:

  1. Navigate to Settings -> Channel -> SMS -> Sender Configuration.
  2. Click +Add custom service provider at the top right corner.
  3. 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.

  4. 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.

  5. Send a test SMS to verify your configuration.
  6. Click Save to save the Sender Configuration.
  7. 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.
  8. You can map the attributes of the delivery tracking response manually or automatically.Infobip_NewUI_PG_DT.png

Configure in Old UI

Log in to the MoEngage dashboard and follow these steps:

  1. Navigate to Settings > Channel > SMS & Connectors and click the SMS Connector Config tab.
  2. 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

  1. 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
  2. Add the Authorization Header details request headers as shown below.Infobip_AuthHeader.png
  3. Choose the Body Type as Raw and add the following details:
    JSON
    
    {
        "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

Infobip_SentResponse__1_.png

Sample response from Infobip for a delivered message

Infobip_DeliveredResponse__1_.png

Mapping delivery response

Choose fields from Delivery Response to auto-populate the response mapping fields, as shown below.

Infobip_DeliveryResponseMapping.png

Next Steps

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?