Voice API in Java: Code Example

Place a Call from Java

Call this from your server and keep the API key in an environment variable.

// Java 11+ java.net.http. No Maven or Gradle dependency.
var body = """
    {"to":"+919876543210","from":"+918045678901",
     "text":"Hello from Edesy. Your order has shipped.",
     "status_callback":"https://your-app.com/webhooks/call-status"}""";
var request = HttpRequest.newBuilder(URI.create("https://voice-api.edesy.in/v1/calls"))
    .header("Authorization", "Bearer " + System.getenv("EDESY_API_KEY"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
var response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body()); // {"data":{"call_sid":...,"status":...},"meta":...}

Control the call with VoiceML

Instead of text, pass url: your endpoint returns VoiceML, a JSON list of instructions. It is not TwiML.

{
  "instructions": [
    { "verb": "say", "text": "Your order has shipped.", "language": "en-IN" },
    {
      "verb": "gather",
      "input": "dtmf",
      "num_digits": 1,
      "action": "https://your-app.com/voiceml/order",
      "nested": [{ "verb": "say", "text": "Press 1 to confirm, or 2 to cancel." }]
    }
  ]
}

Twilio-style request

The Twilio-shaped alias accepts Basic auth with your Account SID and Auth Token.

curl -X POST https://voice-api.edesy.in/v1/Accounts/$ACCOUNT_SID/Calls \
  -u "$ACCOUNT_SID:$AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"+919876543210","from":"+918045678901","text":"Hello from Edesy."}'