Vonage

Introduction 

Vonage is a communication platform as a service (CPaaS) provider for consumers and businesses that makes it possible for customers to connect and communicate on any device through cloud-hosted voice, video, chat, and short message service (SMS).
library_add_check

Prerequisites

Ensure you have access to your Vonage dashboard. 

Configure Vonage as a Custom SMS Connector (Service Provider)

This article will help you set Vonage as a Custom Connector on MoEngage dashboard. 

Before proceeding, ensure you have the following parameters for calls to Vonage API (Nexmo). You can find your Key and Secret in Vonage Dashboard. You can also read about Vonage SMS API here.

Parameter Description
api_key - Your Key. For example: api_key=n3xm0rocks
api_secret - Your Secret. For example: api_secret=12ab34cd

 

Log in to the MoEngage Dashboard and follow these steps:

  1. Navigate to Settings > Channel > SMS > Sender Configuration.
  2. Click +Add 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 readable sender name that can be used while creating a campaign or alert.

    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 Vonage URL for Infobip is: https://rest.nexmo.com/sms/json

    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 Form and add the following details:

    Vonage_NewUI_SenderConfig.png

    1. You can find your Key and Secret in Vonage Dashboard.
    2. In the to field, add Moesms_destination to pass the mobile number of the user.
    3. In the text field, add Moesms_message.
    4. In the from field, add the sender ID of your account provided by Vonage.
  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.

Next Steps

Previous

Next

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

How can we improve this article?