The official marketplace of call flows for WaveKat Voice and wk.
A call flow is a small YAML file that says what happens on an automated phone call: what is said, which keys do what, and when to hang up. Flows are data, not code. Installing one never runs anything on your computer.
wk call +14155550123 --flow ask \ --var question="Deploy to production now?" \ --var option1=Yes --var option2="No, wait" \ --wait --json
Flows from this marketplace install on first use. You can also install them yourself:
wk voice flows install ask
wk voice flows show ask # what it says and which variables it takesNo WaveKat account is needed.
| Flow | What it does | Variables |
|---|---|---|
ask |
Asks one question. The person answers with a key, 1 to 4; 9 repeats it. | intro, question, option1 to option4 |
notify |
Says a message twice, then hangs up. | intro, message |
Any public GitHub repo with a marketplace.json at its root is a
marketplace:
{
"name": "acme",
"description": "Acme's call flows.",
"flows": [
{ "name": "standup", "description": "Daily standup reminder.", "path": "flows/standup.yaml" }
]
}Only name and flows (each with name, description and path) are
required. Optional fields are shown on the flow's web page and in search:
| Field | Where | Meaning |
|---|---|---|
title |
marketplace, flow | A display name ("Ask a question") |
author |
marketplace | { "name": …, "url": … } |
homepage |
marketplace | A link for people who want to know more |
version |
flow | The flow's version, like 1.0.0 |
tags |
flow | A few words for search |
example |
flow | Example --var values, shown as a ready-to-run command |
Add it and install from it:
wk voice flows marketplace add acme/flows wk voice flows install standup@acme
Only flows from this official marketplace install by themselves. Flows
from other marketplaces must be installed with flows install first.
Before saving a flow, install shows any phone numbers it can transfer a
call to.
Open a pull request with a new flow in flows/ and an entry in
marketplace.json. Keep prompts short and plain; they are read aloud on
a phone line.