Setting up Vonage

Please Note: Due to a recent acquisition of Nexmo by Vonage you may see Nexmo and Vonage used interchangeably in the product as well as online.

Go to https://dashboard.nexmo.com/sign-up and sign up for a Vonage account.
Go to Alarms and Notifications>AlertWorX>Vonage Configurations. Right-click and select Add Vonage Configuration, as shown below.

Add Vonage Configuration

Check the “Is Default Configuration” box at the top to set the configuration as default.
Set up the Phone Number and WhatsApp Number with it’s token in the highlighted tabs (1, 2 respectively in the image below). Select the ones that you want to use as default ones under Default Phone Number (3 in the image below) and Default WhatsApp Number (4 in the image below). If the default Phone number is not selected, SMS and voice messages will not be sent. And if default WhatsApp number is not set, WhatsApp message cannot be sent.

General Settings, Phone Numbers, and WhatsApp Numbers Tabs

Set up the API Key and API Secret under the Credentials Tab. You can find these here https://dashboard.nexmo.com/settings.

Credentials Section

You will need to have a WhatsApp business account set up with Vonage to use WhatsApp and the template should be an extension of MsgID: {{1}} Msg: {{2}} You can read more about WhatsApp Templates here: Click HERE for more info on WhatsApp Templating.

Following the above steps sets up SMS and WhatsApp. Below steps will additionally set up voice.

Go to https://dashboard.nexmo.com/applications. Create an Application and give it a name.
1. Enable voice.
2. Generate the Public and private key and store the downloaded private key as Nexmo.key to C:\ProgramData\ICONICS\pki\own\private or the OEM equivalent of this location.
3. Copy the Application ID to the Workbench.
4. Link the Vonage number to this newly created application in the Vonage dashboard online.

Once you Link the number to the above application, save the private key in correct location and provide the Application ID, you should be able use text to talk.

Once these are set up you can test this configuration in the Test this Configuration section.

Test this Configuration Section

Ensure that the configuration is set to default and AlertRest service is running.
Enter a number to which you want to send message (format 15555555555) in the ‘To Number’ field.
Use ‘Test Sms’, ‘Test WhatsApp’ or ‘Test Voice’ buttons to test that it is working.

Apply all your changes.

Note: Once a Default configuration is set, you can see that the methods show up under the Data browser.

Vonage Configurations