​

Set up your Go Gin dev environment

​

Install Go

​

Install the Plivo Go and Gin packages

$ mkdir mygoapp
$ cd mygoapp

$ go get github.com/plivo/plivo-go/v7
$ go get github.com/gin-gonic/gin

​

Send your first outbound SMS/MMS message

​

Create the PHLO

• SMS
• MMS

• Click Create New PHLO.
• In the Choose your use case pop-up, click Build my own. The PHLO canvas will appear with the Start node.
  Note: The Start node is the starting point of any PHLO. You can choose between the four available trigger states of the start node; Incoming SMS, Incoming Call, and API Request. For this PHLO, we will use the API Request trigger state.
• From the list of components on the left-hand side, drag and drop the Send Message component onto the canvas. When a component is placed on the canvas it becomes a node.
• Draw a line to connect the Start node’s API Request trigger state to the Send Message node.
• In the Configuration pane at the right of the canvas, configure the Send Message node with a sender ID in the From field. Enter the destination number you wish to send a message to in the To field. Put your message in the Text field.
  Note: You can define a static payload by specifying values when you create the PHLO, or define a dynamic payload by passing values through Liquid templating parameters when you trigger the PHLO from your application.
• If you’d like to send an MMS message, configure the Media URLs field with the media files you’d like to send.
• Once you’ve configured the node, click Validate to save the configuration.
• After you complete the configuration, give the PHLO a name by clicking in the upper left, then click Save.

​

Trigger the PHLO

​

With a static payload

​

Code

package main

import (
	"fmt"

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

// Initialize the following params with corresponding values to trigger resources
const authId = "<auth_id>"
const authToken = "<auth_token>"
const phloId = "<phlo_id>"

func main() {
	r := gin.Default()
	r.GET("/trigger-phlo", func(c *gin.Context) {
		c.Header("Content-Type", "application/JSON")
		phloClient, err := plivo.NewPhloClient(authId, authToken, &plivo.ClientOptions{})
		if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
		phloGet, err := phloClient.Phlos.Get(phloId)
		if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
		response, err := phloGet.Run(nil)
		if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
		fmt.Printf("Response: %#v\n", response)
		c.JSON(200, response)
	})
	r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}

​

With a dynamic payload

​

Code

package main

import (
	"fmt"

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

// Initialize the following params with corresponding values to trigger resources
const authId = "<auth_id>"
const authToken = "<auth_token>"
const phloId = "<phlo_id>"

func main() {
	r := gin.Default()
	r.GET("/trigger-phlo", func(c *gin.Context) {
		c.Header("Content-Type", "application/JSON")
		phloClient, err := plivo.NewPhloClient(authId, authToken, &plivo.ClientOptions{})
		if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
		phloGet, err := phloClient.Phlos.Get(phloId)
		if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
		//pass corresponding from and to values
		type params map[string]interface{}
		response, err := phloGet.Run(params{
			"From": "<sender_id>",
			"To":   "<destination_number>",
		})

		if err != nil {
			println(err)
		}
		fmt.Printf("Response: %#v\n", response)
		c.JSON(200, response)
	})
	r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}

​

Test

$ go run TriggerPhlo.go

​

Receive your first inbound SMS/MMS message

​

Prerequisite

​

Create the PHLO

• SMS
• MMS

• Click Create New PHLO.
• In the Choose your use case pop-up, click Build my own. The PHLO canvas will appear with the Start node.
  Note: The Start node is the starting point of any PHLO. It lets you trigger a PHLO to start upon one of three actions: incoming SMS message, incoming call, or API request.
• From the list of components on the left-hand side, drag and drop the HTTP Request component onto the canvas. When a component is placed on the canvas it becomes a node.
• Draw a line to connect the Start node’s Incoming Message trigger state to the HTTP Request node.
• In the Configuration pane at the right of the canvas, configure the HTTP Request node. Specify the address of your web server and specify that from, to, and text fields should be passed along with the request.
• Once you’ve configured the node, click Validate to save the configuration.
• After you complete the configuration, give the PHLO a name by clicking in the upper left, then click Save.

​

Assign the PHLO to a Plivo number

• On the Numbers page of the console, under Your Numbers, click the phone number you want to use for the PHLO.
• In the Number Configuration box, select PHLO from the Application Type drop-down.
• From the PHLO Name drop-down, select the PHLO you want to use with the number, then click Update Number.

​

Test

​

Forward an incoming SMS/MMS message

​

Prerequisite

​

Create the PHLO

• SMS
• MMS

• Click Create New PHLO.
• In the Choose your use case pop-up, click Build my own. The PHLO canvas will appear with the Start node.
  Note: The Start node is the starting point of any PHLO. It lets you trigger a PHLO to start upon one of three actions: incoming SMS message, incoming call, or API request.
• From the list of components on the left-hand side, drag and drop the Send Message component onto the canvas. When a component is placed on the canvas it becomes a node.
• Draw a line to connect the Start node’s Incoming Message trigger state to the Send Message node.
• In the Configuration pane at the right of the canvas, configure the Send Message node with the phone number to which you want to forward the message.
• Once you’ve configured the node, click Validate to save the configuration.
• After you complete the configuration, give the PHLO a name by clicking in the upper left, then click Save.

​

Assign the PHLO to a Plivo number

• On the Numbers page of the console, under Your Numbers, click the phone number you want to use for the PHLO.
• In the Number Configuration box, select PHLO from the Application Type drop-down.
• From the PHLO Name drop-down, select the PHLO you want to use with the phone number, then click Update Number.

​

Test

​

More use cases