dialnexa 0.1.0

DialNexa Python SDK

Nexa Python SDK

Install

• Requires Python 3.8+
• From PyPI: pip install dialnexa
• From source (in repo root): pip install .

Environment

• DIALNEXA_API_KEY (required)
• DIALNEXA_ORGANIZATION_ID (required for Calls, Agents, Batch Calls, Voices)
• DIALNEXA_BASE_URL (optional, default https://api.dialnexa.com)

You can place these in a .env file in your project root:

DIALNEXA_API_KEY=your_api_key
DIALNEXA_ORGANIZATION_ID=your_encrypted_org_id

The SDK automatically loads .env when imported.

Usage

from dialnexa import NexaClient

# Option A: pass credentials directly (no .env required)
client = NexaClient(api_key="your_api_key", organization_id="your_encrypted_org_id")

# Option B: rely on environment (.env is optional)
# from dotenv import load_dotenv
# load_dotenv()
# With env set, you can simply do:
# client = NexaClient(api_key="your_api_key_here", organization_id="your_org_id_here")  # reads DIALNEXA_API_KEY, DIALNEXA_ORGANIZATION_ID, DIALNEXA_BASE_URL

# Languages
print(client.languages.list())
print(client.languages.get("en-US"))

# LLMs
print(client.llms.list())
print(client.llms.get("llm_123"))

# Calls
created = client.calls.create(
    phone_number="[phone]",
    agent_id="agent_123",
    agent_version_number=1,
    metadata={"source": "sdk"},
)
print(client.calls.get(created.get("call_id")))

# Batch Calls
with open("./leads.csv", "rb") as f:
    resp = client.batch_calls.create(file=f, filename="leads.csv", title="My batch", agent_id="agent_123", agent_version_number=1)
    print(resp)

# Agents
created_agent = client.agents.create({
    "title": "Customer Support Agent",
    "prompts": {
        "prompt_text": "Hello!",
        "welcome_message": "Welcome! I'm here to help.",
        "conversation_start_type": "user",
    },
})
print(created_agent)
listed = client.agents.list()
print(listed)
agent_id = created_agent.get("data", {}).get("id") or created_agent.get("data", {}).get("agent_id")
print(client.agents.get(agent_id))
print(client.agents.update(agent_id, {"version_number": 1, "title": "Updated Title"}))

# Voices
print(client.voices.list(provider_name="elevenlabs", limit=10))
print(client.voices.get("voice_abc"))

Notes

• The default base URL is https://api.dialnexa.com. Override by passing base_url to NexaClient or setting DIALNEXA_BASE_URL.
• Timeouts use seconds internally; pass timeout_ms to NexaClient.
• Multipart uploads rely on requests handling for simplicity.