Inbound Calling Configuration Guide

Overview

Inbound call setup involves three steps: purchasing a phone number, assigning it to an agent, and optionally configuring call routing rules.

Step 1: Purchase a Phone Number

numbers = client.phone_numbers.search(country="US", area_code="415")
for n in numbers:
    print(f"{n.phone_number} ({n.type})")

number = client.phone_numbers.purchase(
    country="US",
    area_code="415",
    type="local"  # or "toll_free"
)
print(f"Purchased: {number.phone_number}")

Step 2: Assign to Agent

client.phone_numbers.assign(
    number_id=number.id,
    agent_id="agt_9f2k4h1a"
)

Step 3: Configure Call Routing (Optional)

client.phone_numbers.update(number.id,
    routing={
        "rules": [
            {
                "condition": "time_between",
                "params": {"start": "09:00", "end": "17:00", "timezone": "US/Eastern"},
                "action": "route_to_agent",
                "agent_id": "agt_support_bot"
            },
            {
                "condition": "default",
                "action": "route_to_agent",
                "agent_id": "agt_after_hours_bot"
            }
        ]
    }
)

Test Your Setup

Call your purchased number from any phone to test the inbound flow. The agent will answer and follow its configured conversation flow.

• Check the call dashboard for real-time call status
• Review transcripts after the call completes
• Monitor agent performance in the Analytics dashboard

For high-volume contact centres, connect your existing telephony infrastructure via SIP trunking instead of purchasing numbers through Voxentis.