Is there a tool to see a VitalPBX call flow? Yes. Call Flow Studio. VitalPBX has no built-in visual call-flow diagram, and the FreePBX dpviz module won’t install on it. Call Flow Studio reads your VitalPBX configuration in place and draws the routing (inbound routes, time conditions, IVRs, queues, ring groups, extensions) as an interactive graph, with live registration and queue-agent status on every node. It’s read-only on VitalPBX (see below for why).
Does VitalPBX have a native call-flow visualizer?
No. VitalPBX doesn’t ship a built-in graphical dial-plan or call-flow diagram. It’s a long-standing request on the VitalPBX community wish list. The built-in reports (Active Calls, PJSIP Endpoints, CDR) show you what is happening now and what already happened, but not the routing logic: how a call moves from an inbound route through a time condition, IVR, and queue.
FreePBX users reach for the open-source dpviz module for this. dpviz is FreePBX-only. It won’t install on VitalPBX, which uses a different admin framework. On VitalPBX, Call Flow Studio is the tool that fills that gap.
sngrep vs Call Flow Studio: which do you want?
Most people asking “how do I see a VitalPBX call flow” want one of two different things. Both are useful; they’re not the same tool.
| sngrep / Wireshark | Call Flow Studio | |
|---|---|---|
| Shows | Live SIP packets as a ladder (INVITE → 200 OK → BYE), RTP | The routing logic as a map: route → time condition → IVR → queue |
| Best for | Debugging a specific live call / signaling | Understanding & documenting how the dial plan is wired |
| Where it runs | On the server, per-call capture | In the browser, the whole routing graph |
| Live state | The packets of one call in flight | Registration & queue-agent status on every node |
sngrep is excellent at what it does: tracing one call’s signaling. If the question is “why does this DID end up there,” that’s the routing map, and that’s Call Flow Studio. Call replay sits between the two: pick a recent call and Call Flow Studio lights up the route it took through your dial plan, though not its SIP signaling.
What Call Flow Studio shows on VitalPBX
- Inbound routes, time conditions, IVRs, queues, ring groups, extensions, Dynamic Destinations and custom contexts as one interactive graph
- Live registration and queue-agent status on the nodes themselves
- Path highlighting and time travel: set a date and time, in the tenant’s own time zone, and see which branch a call takes
- Call replay: pick one of the last 50 calls on an inbound route and watch the path it took light up
- Most modules’ settings in the details panel, under the field names VitalPBX uses
- Announcements play right on the node
- What else points at any node (In-Use-By)
- Hide any branch, to shrink a big call flow to the path you care about
- Searching a number finds it even when it has no inbound route of its own
- PNG and SVG export with optional one-click sanitization for safe sharing
- Sticky notes and annotations on the canvas
- Back and Forward through the call flows you’ve visited, switching tenants as you go
Built for more than one tenant
Every tenant gets its own canvas, and you switch between them without leaving the graph. Search spans all of them: start typing in the tenant you’re in, widen the search to every tenant, and Call Flow Studio groups what it finds by customer and lands you on that flow in that tenant when you pick one. “Which customer owns this queue?” stops being a question you answer by opening tenants one at a time.
Access follows the same shape. Call Flow Studio runs its own login system, separate from VitalPBX admin auth, and each login is scoped to the tenants you assign it: a tech who handles three customers sees and searches three, not the whole box.
That holds as the box fills up. Add a tenant in VitalPBX and it’s on the canvas the next time Call Flow Studio loads. There’s no second license to buy for tenant number twelve. Call Flow Studio is licensed once per PBX, however many tenants end up on it. One thing to plan around: after the 30-day trial, an unlicensed install covers your first two tenants only, so a login scoped to tenant four has nothing to open until you activate.
Why is it read-only on VitalPBX?
On VitalPBX, Call Flow Studio is a first-class read-only visualizer. The graph, live status, time travel, call replay, export and sticky notes all work as they do on the FreePBX family. What differs is how changes get made. Call Flow Studio’s editing is built on the FreePBX family’s own configuration tools, and on VitalPBX, changes are made in the VitalPBX admin UI, where they’ve always been made. If editing becomes possible on VitalPBX in the future, we’ll add it.
Will it install on my VitalPBX?
Yes, on VitalPBX 3 and 4. Call Flow Studio is self-hosted: it installs over SSH as root and detects VitalPBX on its own. It reads the configuration you set up in VitalPBX, including routes into custom contexts, so your existing call flows are on the canvas the first time it loads. Nothing to migrate, and your routing data never leaves your server.
Get started
Install free, and the first 30 days are unlimited tenants on VitalPBX. After that it settles into a free read-only visualizer for your first two tenants, yours for good, and an optional one-time license keeps unlimited tenants. Questions about running it on VitalPBX: support@callflowstudio.io.