Quickstart

import asyncio
from unpod import AsyncClient

async def main() -> None:
    async with AsyncClient() as client:
        profiles = await client.voice_profiles.list(language="en")
        for p in profiles:
            print(p)

asyncio.run(main())

name='Riya'                     # ← the handle you pass to create()
description='English Voice'  gender='F'  quality='good'
profile_id='e2531acb-ad1e-4408-94ca-77dd3279d208'
voice_temperature=0.8  voice_speed=1.02
greeting_message="Hello! How are you? I'm Riya, what can I help you with today?"
transcriber={'name': 'smallestai', 'model': 'pulse',
             'languages': [{'code': 'multi', 'name': 'Multilingual'}]}
voice={'name': 'Unpod', 'voice': 'Riya', 'model': 'unpod-tts-1.5-max',
       'languages': [{'code': 'en'}, {'code': 'hi'}]}
chat_model={'name': 'OpenAI', 'codename': 'gpt-4.1-mini'}
temperature=0.3  estimated_cost='0.0385'  latency='~699ms'

import asyncio
from unpod import AsyncClient

async def main() -> None:
    async with AsyncClient() as client:
        numbers = await client.telephony.numbers.list()

        for n in numbers:
            print(f"{n.number}  status={n.status}")

        attachable = [n.number for n in numbers if n.status == "not_assigned"]
        if not attachable:
            print("No unattached numbers on this org.")
            return
        print(f"\nFree to attach: {attachable[0]}")

asyncio.run(main())

+918071539102  status=not_assigned
+918071539118  status=assigned

Free to attach: +918071539102

import asyncio
from unpod import AsyncClient

AGENT_ID = "my-support"

async def main() -> None:
    async with AsyncClient() as client:
        numbers = await client.telephony.numbers.list()

        attachable = [n.number for n in numbers if n.status == "not_assigned"]
        if not attachable:
            print("No unattached numbers on this org.")
            return

        result = await client.agents.numbers.attach(AGENT_ID, attachable[0])
        print(f"number={result.get('number')} "
              f"agent_id={result.get('agent_id')} "
              f"status={result.get('status')}")

asyncio.run(main())

number=<attached_phone_number> agent_id=my-support status=assigned

import asyncio
from unpod import AsyncClient

async def main() -> None:
    async with AsyncClient() as client:
        call = await client.calls.create(
            agent_id="my-support",
            to_number="+9188473xxxxx",   # your phone
            data={"customer_name": "Arshpreet", "order_id": "ORD-10482"},
        )
        print(f"call_id={call.call_id} status={call.status} "
              f"from={call.from_number}")

asyncio.run(main())

import asyncio
from unpod import AsyncClient

CALL_ID = "..."   # from step 5

# Terminal statuses. Current servers report connected / notConnected / failed;
# the rest are older names a call record may still carry.
TERMINAL = {"connected", "notConnected", "failed",
            "completed", "not_connected", "ended", "no_answer",
            "busy", "canceled", "cancelled", "rejected"}

async def wait_for_call(client, call_id, budget_s=300, poll_s=5):
    waited = 0
    call = await client.calls.get(call_id)
    while call.ended_at is None and call.status not in TERMINAL:
        if waited >= budget_s:
            break
        await asyncio.sleep(poll_s)
        waited += poll_s
        call = await client.calls.get(call_id)
    return call

async def main() -> None:
    async with AsyncClient() as client:
        call = await wait_for_call(client, CALL_ID)
        print(f"status        = {call.status}")
        print(f"end_reason    = {call.end_reason}")
        print(f"disposition   = {call.disposition}")
        print(f"from -> to    = {call.from_number} -> {call.to_number}")
        print(f"duration_s    = {call.duration_s}")
        print(f"recording_url = {call.recording_url}")
        print(f"session_id    = {call.session_id}")
        print(f"transcript    = {len(call.transcript or [])} turns")
        for turn in call.transcript or []:
            print(f"[{turn.get('role')}] {turn.get('content')}")

asyncio.run(main())