morevoice

The official Python SDK for the MoreVoice API: AI voice agents, calls, campaigns, webhooks and custom tools. It has a sync client (MoreVoice) and an asyncio one (AsyncMoreVoice).

• Every /v1 operation has a typed method, generated from the API's OpenAPI description.
• Retries with automatic idempotency keys, typed errors, auto-pagination, Server-Sent Event streams and webhook verification are built in.
• Python 3.11 and later. The only dependencies are httpx and attrs.

Install

pip install morevoice

Connect

Create an API key in the MoreVoice dashboard under Developers › API keys. Keep it in the MOREVOICE_API_KEY environment variable. Use a test-mode key (mv_test_…) while you build: test mode never reaches a real phone. API keys are secrets, for your server only.

The public API domain is not live yet. Until it is, also set MOREVOICE_BASE_URL to the address of your MoreVoice workspace, the one your team signs in at:

export MOREVOICE_API_KEY=mv_test_sk_...
export MOREVOICE_BASE_URL=https://voice.example.com   # your MoreVoice workspace; the SDK adds /v1

The REST API is in beta, and it is switched on per organisation. Ask your MoreVoice contact to switch it on for yours.

Quickstart

from morevoice import MoreVoice

client = MoreVoice()  # reads MOREVOICE_API_KEY and MOREVOICE_BASE_URL

# Check the key: which organisation, and which mode.
me = client.whoami.retrieve()
print(f"Connected to {me.org_id} in {'live' if me.livemode else 'test'} mode")

# Place a call with one of your assistants. A test key never dials: the call runs on simulated providers.
call = client.calls.create({"to": "+972501234567", "assistant_id": "asst_...", "purpose": "service"})
ended = client.calls.wait_until_ended(call.id)
print(ended.id, ended.status)

# List methods page automatically.
for c in client.calls.list(status="ended"):
    print(c.id)

You can also pass the settings in code: MoreVoice(api_key=..., base_url=...).

Async

import asyncio

from morevoice import AsyncMoreVoice


async def main() -> None:
    async with AsyncMoreVoice() as client:
        me = await client.whoami.retrieve()
        print(me.org_id)


asyncio.run(main())

Verify a webhook

import os

from morevoice import webhooks

# payload: the request body exactly as received (bytes or str), before any JSON parsing.
event = webhooks.construct_event(payload, request.headers, os.environ["MOREVOICE_WEBHOOK_SECRET"])
if event["type"] == "call.ended":
    ...

Handle errors

from morevoice import MoreVoice, NotFoundError

try:
    MoreVoice().calls.retrieve("call_missing")
except NotFoundError as err:
    print("no such call", err.request_id)

Documentation

• Python SDK guide: every resource and helper.
• Quickstart and authentication.
• API reference.

Versioning and support

The SDK follows Semantic Versioning. Each release speaks the API version its models describe and sends it as the MoreVoice-Version header. To pin another version, use MoreVoice(version=...). Each major version gets fixes for 12 months after the next major is released.

License

MIT © MoreVision Advanced Solutions Ltd. See LICENSE.