Chapters

Chapter 1

Introduction

Spire Bot is a workspace for designing, publishing, and operating conversational bots for web chat and WhatsApp, with a live inbox for the people who take over when a customer needs a human.

Who this manual is for

How a bot is built

Treat a bot as a versioned product. Every release moves through the same six stages.

StageWhat you do
1. PlanDefine the audience, the tasks, the boundaries, the success signals, and when to hand over to a person.
2. DesignTurn each customer goal into a small, connected flow with a clear outcome.
3. ConfigureDeclare variables, content, languages, knowledge, scripts, and approved connections.
4. TestValidate the structure, run conversations in the playground, and exercise failure paths.
5. PublishCreate a versioned release, deploy it to a channel, and test the live path.
6. ImproveReview conversations, analytics, and untrained queries, then fix gaps in the draft and release again.
Note

Your edits are saved to a draft. Customers keep talking to the last published version until you publish again.

Key terms

TermMeaning
WorkspaceYour organisation’s area. It holds the bots, users, departments, and API connections.
BotOne assistant with its own flows, content, settings, deployments, and history.
FlowA canvas of connected steps that handles one customer goal.
StepOne action in a flow, such as sending text, asking a question, or calling an API.
DraftThe editable copy of a bot. Changes stay here until you publish.
ReleaseA numbered, unchangeable published version of a bot.
DeploymentA channel, such as web chat or a WhatsApp number, that serves the published version.
HandoverPassing a conversation from the bot to a department of live agents.