Introduction
MessageWhiz is an SMS and messaging management multi-agent platform that enables organizations to reach customers, manage their engagements, and conduct two-way conversations across multiple channels.
library_add_check |
Prerequisites Ensure you have access to your MessageWhiz dashboard and have the API key for your MessageWhiz account. |
Configure MessageWhiz as a Custom SMS Connector (Service Provider)
info |
Information This article describes the steps to configure MessageWhiz as a Custom Connector (Service Provider) on the MoEngage dashboard. |
Log in to the MoEngage dashboard and perform the following steps:
- Navigate to Settings > Channel > SMS > Sender configuration.
- Click + Add Sender at the upper right corner.
- Click + Add custom service provider.
- Add details and settings to the Sender Details screen.
Field Description Mark as default
Turn this toggle on to mark the sender as the default sender for MessageWhiz. If marked as default, this sender will be used to send all SMS campaigns from MoEngage unless you select a different sender while creating the campaign. This is not required.
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. Enter MessageWhiz.
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.
- Select Promotional when you plan to use the sender to send information about your brand, promote deals, or engage with users.
- Select the sender type as Transactional 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 sender's API documentation. Type the sender's API endpoint here. The API URL for MessageWhiz is:
https://sms.messagewhiz.com/smsMethod Select POST as the HTTP method. Body Type Choose the Body Type as JSON and add the following details:
{
"messages": [
{
"text": "Moesms_message",
"dest": [Moesms_destination],
"send": "SENDER_ID"
}
"key": "API_KEY",
"ver": "1.0"
]/pre
Change value for these keys:
- SENDER_ID and API_KEY: Set based on the MessageWhiz account credentials.
(If the API key has '=' at the end, add the '=' in the Key Value Pair section explicitly)
- SENDER_ID and API_KEY: Set based on the MessageWhiz account credentials.
- Click Send test SMS. A new step will appear on the top of your screen.
- Click 3 - Delivery Tracking (optional) and copy the Delivery Tracking URL.
- Click Sender Details on the top of the screen.
- Add a new line to the Key and Value table.
- Name the Key callback and paste the API URL.
Key* Value* api_key “Customer key”
from Test sender to Moesms_message text Moesms_destination callback Paste the delivery tracking URL here.
- Send a test SMS again and click Next.
- Check the parameters on the Delivery Tracking URL and click Save.
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.