How to Make a Phone Call in Java Using Plivo’s Voice API

Your company has settled on Plivo to handle its voice and messaging communications, and now it’s your job to start integrating Plivo into your company’s applications. Don’t worry — Plivo has an SDK to help you out. Let’s see how to make outbound calls and receive incoming calls through Plivo in a Java application.

Install the Plivo SDK

We’ll presume you already have Java installed. The easiest way to install the Plivo SDK is by using IntelliJ IDEA. Install it, create a new project, and choose a dependency manager and Java SE SDK for the new project. Then edit pom.xml, add these lines, and save the file.

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

If you don’t want to use IntelliJ IDEA, you can download the jar file from our GitHub repo.

Find your Auth ID and Auth Token

You have to have proper credentials before you can use the Plivo API. We provide an Auth ID and Auth Token in the Account section at the top of your Plivo Console.

Find Your Auth Credentials on Plivo Console

Choose a phone number

You need an voice-enabled Plivo phone number if you want to receive incoming calls. Check the Numbers screen of your Plivo console to see what numbers you have available. You can also buy numbers from this screen.

Buy a New Plivo Number

Use PHLO to set up an outbound call

Now you can turn to PHLO, Plivo’s visual workflow design studio, to set up the workflow for an outbound call. Click on the PHLO icon on the left-side navigation bar, then on the Create New PHLO button. In the window that pops up, click Build My Own.

Let’s start with a very simple workflow. From the list of components on the left side, drag and drop the Initiate Call component onto the canvas, then connect the Start node to the Initiate Call node using the API Request trigger state.

Now you can add configuration information for the call in the right pane. Valid phone numbers begin with a plus sign and a country code. Add a caller ID number in the From field and a destination number in the To field, then click Validate to save the configuration.

PHLO lets you use variables for From and To values, but we’re keeping it simple for this example.

Now drag the Play Audio component onto the canvas. Connect the Initiate Call node to Play Audio using the Answered trigger state. In the Configuration panel, enter the text you want to play for the call recipient, then click Validate.

Create a PHLO for outbound calls

That’s all we’re going to do for now — we told you it was simple. Give the PHLO a name by clicking on the pencil icon in the upper left, then click the Save button in the upper right.

Run the PHLO to make a call

Now you can trigger the PHLO and test it out. Copy the PHLO ID of the workflow you just created from the end of the URL. You’re also going to need your Auth ID and Auth Token. Create a Java class in the project — let’s call it PlivoVoiceApplication — and paste this code into it:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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 PlivoVoiceApplication {


	public static void main(String[] args) {
		SpringApplication.run(PlivoVoiceApplication.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;
	}

}

Substitute actual values for auth_id, auth_token, and PHLO_ID. Save the file and run it from Intellij.

Boom — you’ve made an outbound call.

Note: To setup your Java dev environment using Spring framework in less than 5 minutes, refer to the Java quickstart using Spring framework guide.

Set up inbound calls

Of course outbound calls are only half of the equation. Plivo supports inbound calls as well. To see how, let’s create another PHLO and again specify Build My Own. This time, drag the Play Audio component onto the canvas and connect the Start node to it using the Incoming Call trigger state. In the Configuration panel, enter some text to speak to the caller when the call is answered, then click Validate to save the configuration. Give this PHLO a name, then click Save.

Before you can receive a call using this PHLO, you have to assign it to a Plivo number. Go back to the Plivo console and click on Phone Numbers on the left nav bar. From the list of Your Numbers, click on the number you want to use. On the next screen, from the Application Type dropdown, choose PHLO. From the PHLO Name dropdown, choose the PHLO you just created. Then click Update Number at the bottom of the screen.

Create a PHLO to receive incoming call

Guess what? You’re done! You don’t have to run a program for this PHLO to work. Just call the Plivo number you specified and you should hear the message you configured read by Plivo’s text-to-speech processor.

Conclusion

And that’s all there is to sending and receiving voice calls using Plivo’s Python SDK. Don’t use Python? Don’t worry — we have SDKs for PHP, Python, Node.js, Ruby, .NET Core, .NET Framework, and Go.

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

comments powered by Disqus