​

Set up your Java Spring dev environment

​

Install Spring and the Plivo Java package using IntelliJ Idea

<dependency>
    <groupId>com.plivo</groupId>
    <artifactId>plivo-java</artifactId>
   <version>5.9.3</version>
</dependency>

​

Send your first outbound SMS/MMS message

​

Create the PHLO

• SMS
• MMS

• On the side navigation bar, click PHLO. The PHLO page will appear and display your existing PHLOs, if any exist. If this is your first PHLO, then the PHLO page will be empty.
• Click Create New PHLO to build a new PHLO.
• In the Choose your use-case window, 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. This will add an Send Message node onto the canvas.
• Connect the Start node with the Send Message node, using the API Request trigger state.
• Configure the Send Message node with the source/from number using the From field. Enter the destination number you wish to send message in the To field.
• If you’d like to send MMS then Configure the Media URLs node with the Media files you’d like to send using the Media URLs field.
• Once you have configured the node, click Validate to save the configurations.
• After you complete the configurations, provide a recognizable name for your PHLO and click Save. Your PHLO is now ready. You can trigger the PHLO and test it out. For more information, refer to the following section.

​

Trigger the PHLO

​

With a static payload

​

Code

package com.example.demo;
import com.plivo.api.Plivo;
import com.plivo.api.PlivoClient;
import com.plivo.api.exceptions.PlivoRestException;
import com.plivo.api.models.phlo.Phlo;
import com.plivo.api.models.phlo.PhloUpdateResponse;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;

@SpringBootApplication
@RestController
public class PlivoSMSApplication {


	public static void main(String[] args) {
		SpringApplication.run(PlivoSMSApplication.class, args);
	}
	
	@GetMapping("/outbound")
	public PhloUpdateResponse triggerPhlo() throws IOException, PlivoRestException {
		final String authId = "<auth_id>";
		final String authToken = "<auth_token>";
		PlivoClient client = new PlivoClient(authId, authToken);
		String phloId = "<phlo_id>";
		Plivo.init(authId, authToken);
		Phlo phlo = Phlo.getter(phloId).client(client).get();
		PhloUpdateResponse response = Phlo.updater(phloId).run();
		return response;
	}

}

​

With a dynamic payload

​

Code

package com.example.demo;
import com.plivo.api.Plivo;
import com.plivo.api.PlivoClient;
import com.plivo.api.exceptions.PlivoRestException;
import com.plivo.api.models.phlo.Phlo;
import com.plivo.api.models.phlo.PhloUpdateResponse;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

@SpringBootApplication
@RestController
public class PlivoSMSApplication {


	public static void main(String[] args) {
		SpringApplication.run(PlivoSMSApplication.class, args);
	}
	
	@GetMapping("/outbound")
	public PhloUpdateResponse triggerPhlo() throws IOException, PlivoRestException {
		final String authId = "<auth_id>";
		final String authToken = "<auth_token>";
		PlivoClient client = new PlivoClient(authId, authToken);
		String phloId = "<phlo_id>";
		Plivo.init(authId, authToken);
		Phlo phlo = Phlo.getter(phloId).client(client).get();
		Map<String, Object> payload = new HashMap<>();
		payload.put("From", "<sender_id>");
		payload.put("To", "<destination_number>");
		PhloUpdateResponse response = Phlo.updater(phloId).payload(payload).run();
		return response;
	}

}

​

Test

​

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