Voice API in Python: Code Example

Place a Call from Python

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

import os, requests

resp = requests.post(
    "https://voice-api.edesy.in/v1/calls",
    headers={"Authorization": f"Bearer {os.environ['EDESY_API_KEY']}"},
    json={
        "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",
    },
    timeout=10,
)
resp.raise_for_status()
call = resp.json()["data"]
print(call["call_sid"], call["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."}'