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, Prompt

PROMPT_TEXT = (
    "You are Riya, a support agent for an online electronics store. "
    "Greet the caller by name if you know it, ask what problem they are "
    "calling about, confirm the order number, and tell them the resolution "
    "timeline. Keep every reply under two sentences. End the call politely "
    "once the caller has no further questions."
)

async def main() -> None:
    async with AsyncClient() as client:
        voice = await client.agents.voice.create(
            agent_id="my-support",   # you choose this; everything later resolves from it
            name="My Support Line",  # human label, shown in dashboards
            brain=Prompt(PROMPT_TEXT),
            voice_profile="Riya",
            recording=True,
        )
        print(f"agent_id        = {voice.agent_id}")
        print(f"name            = {voice.name}")
        print(f"voice_profile   = {voice.voice_profile_name}")
        print(f"brain.type      = {voice.brain.get('type')}")
        print(f"brain_execution = {voice.brain_execution}")

asyncio.run(main())

agent_id        = my-support
name            = My Support Line
voice_profile   = Riya
brain.type      = prompt
brain_execution = bridge

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}  country={n.country}")

asyncio.run(main())

+918071539102  status=not_assigned  country=IN
+918071539118  status=assigned      country=IN

import asyncio
from unpod import AsyncClient

async def main() -> None:
    async with AsyncClient() as client:
        result = await client.agents.numbers.attach(
            "my-support", "+918071539102")  # the not_assigned number from step 3
        print(f"number={result.get('number')} "
              f"agent_id={result.get('agent_id')} "
              f"status={result.get('status')}")

asyncio.run(main())

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 = {"completed", "ended", "failed", "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())