Connect SMS Gateways

With a Vonage (formerly Nexmo) account you can rent virtual numbers in over eighty countries and connect them to Grata to send and receive SMS messages in your Grata console. You own your phone numbers and directly pay for the traffic used to Vonage. Grata doesn’t charge any mark-up on your traffic. If someone calls your phone number, you can forward the call to a number of your choice.
Depending on the country, long-code numbers (a typical mobile phone number) can cost less than US$1 per month to rent. Receiving messages is free, and sending messages domestically is often just fractions of a cent, while messages to international numbers vary in cost. You can check pricing by country on the Vonage Numbers page. We also recommend you review the regional carrier differences so you know what’s supported in each country.

Grata’s SMS integration is currently in open beta. SMS as a channel is intended for two-way, interactive customer service. This is not a bulk SMS outbound marketing solution. Every region has different policies on how they handle marketing messages and opt-in permissions to receive messages from a business. In general, your sent message volume should be in balance with your received message volume. At scale, you will likely need to add additional numbers to your Nexmo account to spread the volume across multiple numbers. For example, US carriers are known to throttle traffic from numbers with more than 200 daily active users.

  1. Register a Vonage Account
  2. Go to to get an account if you don’t already have one.

  3. Buy a number
  4. Once you’ve logged into your Vonage account, look in the Dashboard side menu for Numbers < Buy Numbers.

    Select the country, features and type. You can also enter up to four digits you would like to appear in your number, for example, to find numbers in the same area code as your business:

    Once you’ve found a number you like, click buy and then confirm the transaction.

  5. Link Grata to Vonage
  6. From your Vonage dashboard, open the Settings page from the drop-down menu under your username.

    In the Grata Admin backend, open the SMS page listed under Channels and click the button at the top right to add your account. Now copy and paste the the API Key and API Secret from your Vonage dashboard into Grata.

    Copy these Vonage API Values And paste to your Grata Settings


  7. Forward messages from Vonage to Grata
  8. On the same page in Grata and Vonage, you’ll need to 1) copy the two Webhook URLs from Grata into the appropriate fields in Vonage, 2) set the HTTP method to POST-JSON, and 3) save your changes.

    Copy these Grata webhook URLs And paste to your Vonage Settings


  9. Customize your numbers
  10. Click the Next button in Grata. You can now assign a nickname and icon color to your Vonage numbers to help distinguish them in the Grata console. You should also set a forwarding number. If anyone calls your SMS number, Vonage will forward the call to this number if this feature is supported for your number and region.