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
- Bot Designers who design flows, test the bot, and publish it to channels.
- API Integrators who set up connections and the APIs a bot calls.
- Agents and supervisors who answer customers in the Agent inbox.
- Security Admins who create users and assign their roles.
- Administrators who manage departments, service health, and everything else.
How a bot is built
Treat a bot as a versioned product. Every release moves through the same six stages.
| Stage | What you do |
|---|---|
| 1. Plan | Define the audience, the tasks, the boundaries, the success signals, and when to hand over to a person. |
| 2. Design | Turn each customer goal into a small, connected flow with a clear outcome. |
| 3. Configure | Declare variables, content, languages, knowledge, scripts, and approved connections. |
| 4. Test | Validate the structure, run conversations in the playground, and exercise failure paths. |
| 5. Publish | Create a versioned release, deploy it to a channel, and test the live path. |
| 6. Improve | Review 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
| Term | Meaning |
|---|---|
| Workspace | Your organisation’s area. It holds the bots, users, departments, and API connections. |
| Bot | One assistant with its own flows, content, settings, deployments, and history. |
| Flow | A canvas of connected steps that handles one customer goal. |
| Step | One action in a flow, such as sending text, asking a question, or calling an API. |
| Draft | The editable copy of a bot. Changes stay here until you publish. |
| Release | A numbered, unchangeable published version of a bot. |
| Deployment | A channel, such as web chat or a WhatsApp number, that serves the published version. |
| Handover | Passing a conversation from the bot to a department of live agents. |