Skip to content

Quick start

Jamhooks is a visual editor for IVR call flows on Jambonz. You build a flow from components (Menu, Play Prompt, Transfer, Conditional, AI Agent and more). Jamhooks stores and versions it, compiles it into Jambonz verbs, and serves it as the webhooks a Jambonz application calls.

This page gets an instance running on your own machine, for evaluation. To run it for real callers, follow Deployment afterwards.

You need Docker with Compose.

Terminal window
git clone https://github.com/jamhooks/jamhooks.git
cd jamhooks
docker compose up --build

Open http://127.0.0.1:5001. The first start downloads the editor’s front-end assets once.

  1. Choose New Flow, then Load Example, and pick one of the examples. Each is a complete flow you can take apart.
  2. Click a component on the canvas to see its settings in the side panel. Components run top to bottom; a component with outcomes (a Menu’s keys, a Conditional’s rules) holds a branch per outcome.
  3. Open Simulate and Run the flow with typed input, such as the digits a caller would press. Nothing is called; you see the path the call would take.
  4. Click Deploy to save it. Every deploy is a version you can view and restore later.

Building flows explains every component and how branching works.