didww/ai / skills/didww-to-vapi
didww-to-vapi
VerifiedConnect a DIDWW phone number to a Vapi assistant over BYO SIP trunking, as automatically as Vapi allows. Use whenever the user wants a Vapi assistant on a real phone number via DIDWW, mentions pairing DIDWW with Vapi, byo-sip-trunk credentials, sip.vapi.ai, or debugging calls between the two. Covers inbound, outbound, transfers and agent binding, following Vapi's and DIDWW's own DIDWW guides.
DIDWW to Vapi
Vapi is fully API-first for this connection, but its official MCP
(https://mcp.vapi.ai/mcp, Bearer API key) is READ-ONLY for trunks and
numbers: it lists and inspects but cannot create. So the write path is
REST, wrapped in scripts/connect.py; use the MCP for verification and
assistant management afterwards. On the DIDWW side the MCP (OAuth)
covers the number and the inbound trunk, but has NO outbound trunk
tools: the DIDWW outbound trunk is created by the user in the panel.
How the two sides recognise each other
Both vendors document the same setup (docs.vapi.ai "DIDWW SIP
integration" and doc.didww.com "Vapi" integration guide): the DIDWW
inbound trunk points at Vapi's regional host sip.vapi.ai (EU org:
sip.eu.vapi.ai), and Vapi recognises the call by its source: an
"inbound" Vapi credential lists DIDWW's seven signaling IPs as
inbound-only gateways (46.19.209.14, 46.19.210.14, 46.19.212.14,
46.19.213.14, 46.19.214.14, 46.19.215.14, 185.238.173.14, from
doc.didww.com General SIP Information). The number is imported on that
credential in E.164 with the +. A separate "outbound" credential points
at the DIDWW outbound endpoint with digest auth. Transfers are SIP REFER:
DIDWW must allow them (max_transfers >= 1) and authenticate them with
the outbound trunk's credentials. Vapi signaling IPs (for the DIDWW
outbound trunk): US 44.229.228.186/32, 44.238.177.138/32; EU
63.182.83.170/32 (docs.vapi.ai SIP networking; DIDWW's Vapi page shows
older EU addresses, trust Vapi's page for Vapi's IPs).
The flow
- Confirm in one message: which DIDWW number (or country to buy), which assistant (existing ID or create one), region of the Vapi organization (US or EU), transport (UDP default, TCP, or TLS on 5061) and transfer target if any.
- DIDWW outbound trunk (DIDWW panel, the user does it; needed for
outbound calls and transfers, inbound can go live without it):
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 before promising any
date. Create New, Authentication method Credentials & IP-Based,
Allowed SIP IPs = Vapi's signaling IPs for the region PLUS DIDWW's
seven signaling IPs (both guides require them for transfers). Never
0.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 assistant 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 username and password over in a file or environment variables (the script readsDIDWW_TRUNK_PASS), not pasted into chat. - Vapi side (
scripts/connect.py): one run creates the outbound credential (with the--didww-*flags), the inbound credential (the seven DIDWW gateways, plus the outbound credentials for authenticated transfers) and thebyo-phone-number(E.164 with+, bound to the assistant), onapi.vapi.aior, with--eu,api.eu.vapi.ai. Without the--didww-*flags it sets up inbound only. It prints the DIDWW-side values for steps 2 and 4. - DIDWW inbound trunk (DIDWW MCP
create_sip_trunk): hostsip.vapi.ai(EUsip.eu.vapi.ai), port 5060 (5061 for TLS),transport_protocolmatching step 3,max_transfers1,capacity_limit= expected concurrent calls; for transfers alsoauth_enabledtrue withauth_user/auth_password= the outbound trunk's credentials. Assign the DID. - Transfers (optional): a Vapi
transferCalltool with a SIP destinationsip:+E164@<DIDWW outbound host>, blind transfer,sipVerb: refer, added to the assistant'smodel.toolIds. - Verify: inbound from a mobile, outbound caller ID, transfer.
Vapi's MCP (
list_phone_numbers,get_call) is handy for reading call outcomes without leaving the conversation.
Failure map
- Inbound never reaches the assistant: the number is not on the inbound
credential, the credential is missing a DIDWW signaling IP (calls can
come from any DIDWW location), the trunk points at the wrong region's
host (EU org on
sip.vapi.ai), or transport/port differ between the DIDWW trunk and the gateways. - Outbound auth failures: the credentials in Vapi do not match the
DIDWW outbound trunk; after regenerating them run
scripts/connect.py --rotate <outbound credential id> --rotate <inbound credential id> --didww-user ...and update the DIDWW inbound trunk'sauth_user/auth_passwordto the same pair. - Outbound 403 or rejected from DIDWW: caller ID not allowed in the outbound trunk's CLI settings, destination not allowed, Vapi's IPs missing from its Allowed SIP IPs, or the 24 Hour Limit was reached (DIDWW then disables the trunk; re-enable it in the panel).
- Transfer fails:
max_transfersis 0 on the inbound trunk, the inbound trunk's Authorization is off or stale, or DIDWW's signaling IPs are missing from the outbound trunk's Allowed SIP IPs. - API calls fail although the key is right: an EU-hosted organization
must use
api.eu.vapi.ai(Vapi's guide); add--eu.
Panel map and money
Vapi keys: dashboard.vapi.ai/org/api-keys, shown ONCE at creation.
Billing: prepaid credits (1 credit = 1 USD) with card auto-reload
(minimum 10 USD); 10 USD free credits with no card to start. Real
per-minute cost is the 0.05 USD platform fee PLUS provider passthrough,
typically 0.15 to 0.30 USD/min; numbers 2 USD/month. Critical warning
for the user: a negative balance freezes the wallet and add-ons
INCLUDING PHONE NUMBERS auto-cancel, so set auto-reload on day one.
DIDWW side: prepaid; top-up, Auto-charge and Low Balance Notification
(OFF by default) in Billing, Payment Methods.
Built around DIDWW SIP trunking and Vapi's BYO SIP trunk API; flow checked against Vapi's and DIDWW's DIDWW/Vapi guides 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: 470k | Updated | Claude CodeCodex | Unverified | 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 |