Voice API in Node.js: Code Example

Place a Call from Node.js

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

// Node.js 18+ (built-in fetch). No package to install.
const res = await fetch("https://voice-api.edesy.in/v1/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EDESY_API_KEY}`, // sk_...
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+919876543210",
    from: "+918045678901",            // your Edesy number
    text: "Hello from Edesy. Your order has shipped.",
    // or: url: "https://your-app.com/voiceml" (returns VoiceML JSON)
    status_callback: "https://your-app.com/webhooks/call-status",
  }),
});
const { data } = await res.json();
console.log(data.call_sid, data.status);

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."}'