How to Receive and Respond to Incoming SMS Messages in Go with Gin and Plivo

How to Receive and Respond to Incoming SMS Messages in Go with Gin and Plivo

Sending an outbound message using the Plivo SMS platform is easy, but communication should be a two-way street. Customers should be able to text you, and you should acknowledge their messages and address their concerns. To do this, you can build a Go Gin-Gonic application to receive and respond to incoming SMS messages on a Plivo phone number. In this post, we walk you through how to implement this.

Prerequisites

Before you get started, you’ll need:

  • A Plivo account — sign up for one for free if you don’t have one already.
  • An SMS-enabled Plivo phone number as you want to receive incoming SMS messages. To search for and buy an available number, go to Phone Numbers > Buy Numbers on the Plivo console.
  • Golang, Gin-Gonic, and Plivo go packages.
  • ngrok — a utility that exposes your local development server to the internet over secure tunnels.

Create a Gin web application to receive SMS messages

Once you’ve installed Golang, Gin-Gonic, and Plivo go packages, create a simple Gin web application to handle incoming SMS messages on a Plivo number. Use this code:

package main

import (
  "net/http"

  "github.com/gin-gonic/gin"
)

func main() {
  r := gin.Default()
  r.GET("/receive_sms", func(c *gin.Context) {
     fromnumber := c.Query("From")
     tonumber := c.Query("To")
     text := c.Query("Text")
     c.String(http.StatusOK, "Message Received %s %s %s", fromnumber, tonumber, text)
  })
  r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}

Return a Message XML document to reply to incoming messages

To reply to an incoming SMS message, you need to return an XML document from the URL configured as the message_url in the application assigned to the Plivo number. The Go SDK can manage the XML document generation, and you can use the Message XML element to reply to incoming SMS messages. Use this code:

package main

import (
   "github.com/gin-gonic/gin"
   "github.com/plivo/plivo-go/v7/xml"
)

func main() {
   r := gin.Default()
   r.GET("/reply_sms", func(c *gin.Context) {
       c.Header("Content-Type", "application/xml")
       fromnumber := c.Query("From")
       tonumber := c.Query("To")
       response := xml.ResponseElement{
           Contents: []interface{}{
               new(xml.MessageElement).
                   SetDst(tonumber).
                   SetSrc(fromnumber).
                   SetContents("Thanks, we have received your request"),
           },
       }
       c.String(200, response.String())
   })
   r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}

Test the code locally

Save the code in any file — we named the file reply_sms.go. To run the code on the server, go to the folder where the file resides and use the command

$ go run reply_sms.go

You should see your basic server application in action on http://localhost:8080/reply_sms/.

Expose the local server to the internet using ngrok

Once you see the application working locally, the next step is to connect the application to the internet to receive and reply to messages. For that, we recommend using ngrok, which exposes local servers behind NATs and firewalls to the public internet over secure tunnels. Install it and run ngrok on the command line, specifying the port that hosts the application on which you want to receive messages (8080 in this case, as our local Gin web application is running there):

$ ./ngrok http 8080

Ngrok will display a forwarding link that you can use as a webhook to access your local server over the public network.

Ngrok CLI

Test the link by opening the ngrok URL(https://6d2adbcd5861.ngrok.io/reply_sms/?From=14156667777&To=14156667778) in a browser to check the XML response from the ngrok URL.

XML document with Message XML element

Connect the Gin web application to a Plivo number

The final step is to configure the app as a Plivo messaging application and assign it to a Plivo number on which you want to receive SMS messages.

Go to the Plivo console and navigate to Messaging > Applications > XML, then click on the Add New Application button in the upper right.

Provide a friendly name for the app — we used “App-Incoming-SMS” — and configure the ngrok URL https://6d2adbcd5861.ngrok.io/reply_sms/ as the Message URL. Select the HTTP verb as GET, then click Create Application.

Create Plivo App to handle incoming SMS messages

Now go to Phone Numbers > Your Numbers and click on the number to which you want to assign the application. From the Plivo Application drop-down, choose the message application you just created. Finally, click Update Number.

Assign the Plivo App to a Plivo Number

Test the application

Send an SMS to the Plivo number you selected. You should see that the Gin web application automatically sends a reply back to your mobile number.

And that’s how simple it is to receive and respond to incoming SMS messages using Plivo’s Go SDK and a Gin web application.

Haven’t tried Plivo yet? Getting started is easy and only takes five minutes! Sign up today.

Get Volume Pricing

Thousands of businesses in more than 220 countries trust Plivo’s cloud communications platform

The best communications platform forthe world’s leading entertainment service

Frequently asked questions

No items found.
footer bg

Subscribe to Our Newsletter

Get monthly product and feature updates, the latest industry news, and more!

Thank you icon
Thank you!
Thank you for subscribing
Oops! Something went wrong while submitting the form.

POSTS YOU MIGHT LIKE