Vonage SMS Integration Guide

Overview

This guide explains how to connect your Vonage SMS Provider with the klink.cloud platform. Once integrated, you can send and receive SMS messages directly from your klink.cloud inbox, manage customer interactions, and automate workflows — all within a unified omnichannel communication dashboard.

1. Prerequisites

Before starting, ensure that you have:

  • A klink.cloud account with admin or integration access.

  • A Vonage (formerly Nexmo) account.

  • At least one active phone number purchased in your Vonage account.

  • Your Vonage API Key and API Secret.

  • Internet access to log in to both dashboards.

2. Step-by-Step Setup Instructions

Step 1: Access the Messaging Channel Settings

  1. Log in to your klink.cloud dashboard.

  2. Navigate to: Settings → Message Channels → Add Channel → SMS.

  3. A new setup window will open.

  4. Enter a Channel Name — this helps you identify the SMS line (e.g., Demo SMS, Sales SMS, or Support Line).

  5. Optionally, you can use your phone number as the channel name for clarity.

Step 2: Select Vonage as the SMS Provider

  1. Under SMS Provider, select Vonage from the dropdown list.

  2. In the Mobile Number field, log in to your Vonage account and choose one of your available numbers.

    • If you don’t have one yet, go to your Vonage dashboard → Numbers → Buy Number, and select one for your region.

  3. Copy the number (e.g., 6581234567) and paste it into the Mobile Number field on klink.cloud.

    Important: Do not include the country code (“+65” or “+1”) in this field.

Step 3: Configure Sender ID (Optional)

  • If your Vonage account supports a Sender ID (also known as a Brand Name or Sender Name), enter it under Sender ID.

  • The Sender ID will replace your phone number in outbound messages when allowed by the recipient country’s carrier.

  • If you don’t have a Sender ID, you may leave this field blank.

Step 4: Retrieve and Add Your Vonage API Credentials

  1. In your Vonage Dashboard, go to API Settings → API Keys.

  2. Copy your API Key and API Secret.

  3. Paste them into the following fields in klink.cloud:

    • API Key → Your Vonage API Key

    • API Secret → Your Vonage API Secret

  4. If you don’t have an API secret yet:

    • Click Create New Secret in Vonage, copy it, and then paste it into klink.cloud.

Step 5: Configure Webhook for Inbound SMS

To ensure klink.cloud receives inbound messages:

  1. In klink.cloud, copy the Webhook URL displayed on your SMS channel setup page.

    • This webhook URL allows Vonage to forward all incoming SMS to klink.cloud.

  2. Go to your Vonage Dashboard → Numbers → Edit Number.

  3. Locate the field labeled Inbound Webhook URL (or Webhook for Incoming Messages).

  4. Paste the Webhook URL you copied from klink.cloud.

  5. Save the settings in your Vonage dashboard.

✅ Tip: This ensures that every SMS received on your Vonage number is automatically routed to your klink.cloud inbox for real-time visibility.

Step 6: Complete and Save Channel Setup

  1. After filling all the required fields — Channel Name, Provider, Mobile Number, API Key, API Secret, and Webhook URL — click Save Channel.

  2. The channel will appear in your list of active SMS channels.

  3. Status will show Connected once klink.cloud successfully communicates with Vonage’s API.

3. Testing the Integration

To verify your connection:

  1. Open your mobile phone and send a test SMS to the Vonage number you linked.

  2. Check your klink.cloud Inbox → SMS Channel to see if the message appears.

  3. Try replying directly from klink.cloud — this should deliver a message back to your phone.

If both inbound and outbound messages are successful, your Vonage SMS integration is complete.

Last updated