didww/ai / skills/didww-to-ultravox
didww-to-ultravox
VerifiedConnect a DIDWW phone number to an Ultravox Realtime voice agent over SIP. Use whenever the user wants an Ultravox agent on a real phone number via DIDWW, mentions pairing DIDWW with Ultravox, an account SIP domain, agent_ addresses, allowedCidrRanges, or debugging calls between the two. Covers the address-based routing model that makes Ultravox different from every number-import platform.
DIDWW to Ultravox
Ultravox has no number-import object and no official MCP: inbound routing
is ADDRESS-BASED. Calls arrive at agent_{agent_id}@{account_sip_domain}
and the account's SIP settings decide what is accepted. That inverts the
usual setup: instead of importing the number into the platform, you point
the DIDWW trunk at the right SIP address. The DIDWW MCP (OAuth) automates
the number and the inbound trunk (it has no outbound trunk tools: the
user creates the DIDWW outbound trunk in the panel); scripts/connect.py automates the Ultravox side via
its REST API (X-API-Key header).
The two routing shapes: pick one in intake
One agent per number (simple): the DIDWW inbound trunk's destination is the agent's own SIP address. Works when the trunk can carry a custom destination user part; where the DIDWW trunk format sends the DID as the user part instead, use the second shape.
Fallback webhook (flexible, needed for multiple numbers): calls that
match no agent address hit the account's fallbackHandler webhook, which
receives toUri (the DID) and answers startAgentCall with the chosen
agent, or reject. A tiny public HTTPS endpoint maps DID to agent; this
is the general answer for carrier trunks and the honest cost of
Ultravox's model.
The flow
- Confirm in one message: number (or country to buy), agent, one agent per number or a DID-to-agent map, transfer target.
- Read the account SIP domain:
GET /api/sip(thedomainfield is read-only and per-account; never guess it).scripts/connect.py --showprints it. - Ultravox side (
scripts/connect.py): always restrictallowedCidrRangesto DIDWW (--allow-didwwsets46.19.208.0/21and185.238.172.0/22, which cover every DIDWW signaling location per doc.didww.com). The allowlist IS Ultravox's inbound authentication: until DIDWW's ranges are on it, DIDWW's INVITEs are not accepted, and never use0.0.0.0/0(any address; Ultravox itself advises against it). Then eitherallowedAgents(--allow-agent AGENT_UUID[=TO_USER_REGEX], objects{agentId, toUserPattern}, max 20; the pattern defaults to^agent_<agent_id>$, so a DID-as-user-part trunk needs a pattern such as^\+?33144556677$) or thefallbackHandlerURL (https; Ultravox generates its signing secret, which the handler must verify;--show --show-secretsreveals it, normal output redacts it). For outbound note that calls are placed per call viaPOST /api/callswithmedium.sip.outgoingcarrying the DIDWW host and outbound trunk credentials. - DIDWW inbound trunk (MCP): pointed at the account SIP domain
(destination per the routing shape chosen),
capacity_limit= expected concurrent calls, DID attached. DIDWW outbound trunk (panel, the user does it, only for outgoing calls): Under Voice, Outbound Trunks a Get Access button means the account is not approved yet (business account with company name and VAT/TAX ID; DIDWW answers within 48 business hours): say so and finish the inbound side meanwhile. Create New, Authentication method Credentials & IP-Based, which needs at least one Allowed SIP IP. Ultravox publishes no SIP egress range (its SIP runs on Voximplant): ask Ultravox support for the source addresses, or DIDWW support (support@didww.com); never invent a range or suggest0.0.0.0/0. Termination: 24 Hour Limit (USD) at its minimum, 50 (default 3000), Capacity limit = expected concurrency, usage limit notification on; CLI limited to the DID; Destination dialing Reject All except the countries the agent calls. Enable the trunk if it shows Disabled. Host: the region-nearest ofnyc.us.out.didww.com,lac.us.out.didww.com,mia.us.out.didww.com,fra.eu.out.didww.com,ams.eu.out.didww.com,sg.out.didww.com,hk.out.didww.com. The user hands the generated credentials over in a file or environment variables, not pasted into chat. These credentials go intomedium.sip.outgoing. - Verify: inbound from a mobile; outbound via a test
POST /api/calls; transfers (Ultravox has the richest transfer set: cold REFER, warm, bridged). SIP minutes bill separately from model time; mention it.
Failure map
- Inbound 603 rejects: the To address matches no allowed agent and no
fallback handler is set; fix
allowedAgentsregex or add the handler. - Inbound never arrives: CIDR allowlist missing DIDWW's signaling range, or the trunk sends the DID as user part while routing expected an agent address (switch to the fallback shape).
- Outbound auth failures: credentials in
medium.sip.outgoingdo not match the DIDWW outbound trunk. - Outbound 403 or rejected from DIDWW: source not in the outbound trunk's Allowed SIP IPs, caller ID not allowed in its CLI settings, destination not allowed, or the 24 Hour Limit was reached (DIDWW then disables the trunk; re-enable it in the panel).
Panel map and money
Ultravox keys: app.ultravox.ai, Settings, API Keys, Generate New Key.
Pricing runs two meters per call: 0.05 USD/min agent time plus SIP
minutes billed separately (about 0.005 USD/min); quote both. 30 free
minutes to start; pay-as-you-go has concurrency caps that only the
100 USD/month Pro plan removes. DIDWW side: prepaid; top-up, Auto-charge
and Low Balance Notification (OFF by default) in Billing, Payment
Methods.
Built around DIDWW SIP trunking and Ultravox's SIP docs; verified August 2026, DIDWW outbound trunk rules October 2026.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |