Chat Bot
Use Shocking Energy from Slack, Telegram, or WhatsApp.
The Shocking Energy bot lets you query and manage jobs, flows, and your team directly from Slack, Telegram, or WhatsApp. Same data and same permissions as the dashboard — what you can see in chat is what your role allows.
The bot is included on the Business Pro plan and above. Set it up in Settings > Integrations > Chat.
Supported platforms
| Platform | Direct messages | Channel mentions | Photo / file uploads |
|---|---|---|---|
| Slack | ✓ | ✓ (mention @Jobway) | ✓ |
| Telegram | ✓ | ✓ (mention the bot) | ✓ |
| ✓ | — | — (long content sent as a dashboard link) |
Linking your account
In the dashboard, go to Settings > Integrations > Chat and copy your one-time link code.
Send the link code to the bot in a direct message on your platform. The bot replies confirming the link.
Send whoami to verify your identity.
To unlink later, send unlink.
Commands
All commands are case-insensitive. The bot strips a leading @mention, so @Jobway jobs is the same as jobs.
General
| Command | What it does |
|---|---|
help | Show the command list |
start | Same as help |
whoami / me | Show your linked user, team, and role |
unlink | Unlink your platform identity |
Jobs
| Command | What it does |
|---|---|
jobs | Today's jobs (engineers see only their own) |
jobs week | This week's jobs |
myjobs / my | Same as jobs |
job <ref> | Detail for a job (use the public ref like 1234 or ABC-1234) |
note <ref> <text> | Add a note to a job. Photos attached to the message are saved as job attachments. |
start <ref> | Start a job |
Flows
| Command | What it does |
|---|---|
flows / flows status | 7-day rollup: total, success / sent / pending / fail counts, top failing flow types |
flows errors | Last 24 hours of failures |
flows show <flowId> | Show the flow's file content. If too long for chat, sent as an image (Slack / Telegram) or as a dashboard link (WhatsApp). |
flows fix <flowId> | Plan a fix — see the diagnosis, the recommended action, and a short confirm code |
flows fix <flowId> confirm <code> | Apply the fix planned in the previous step |
flows fix is owner-only — Members and Engineers will be told to ask an owner.
Team
| Command | What it does |
|---|---|
team / members | List team members |
engineers | List engineers (Business Pro and above) |
engineer <name> | Detail card for one engineer (Business Pro and above) |
Anything else
If your message doesn't match a command, the bot answers it with the AI assistant. So you can also ask:
- "Which engineer has the most jobs this week?"
- "What's the most common reason flows are failing?"
- "Summarise yesterday's job activity"
See the AI Assistant page for what it can answer.
Fixing a flow from chat
Flow fixes are destructive (they archive the original and create a fresh one), so the bot uses a two-step confirm:
Send flows fix abc-123. The bot replies with:
- The diagnosis (e.g. "Supplier ABC has no RGMA rooting configured")
- A warning if the recommended fix is something other than regenerate / resend
- The planned action and the flow's current status
- A short confirm code like
f8j2pm
Within 5 minutes, send flows fix abc-123 confirm f8j2pm. The bot applies the fix and replies with the new flow ID.
If the code expires or the flow's status changes before you confirm, you'll get a clear error and can re-run flows fix abc-123 to plan again.
Long messages
When a flow's content is too long to send as text:
| Platform | What happens |
|---|---|
| Slack | Sent as an image attachment with a caption + dashboard link |
| Telegram | Sent as an image document with a caption + dashboard link |
| Sent as a short summary with a dashboard link to the full content |
The bot always includes a dashboard link, so you can open the full file in a browser regardless of the platform.
Permissions and roles
| Role | What you can do in chat |
|---|---|
| Owner | All commands, including flows fix |
| Member | All commands except applying flows fix (planning is allowed; only owners can confirm) |
| Engineer | Read-only: jobs, job, note, team, whoami, flows status, flows show, plus AI fallback for read-only questions |
If a command is gated by your team's plan (e.g. engineers requires workforce-management), the bot replies with a brief upgrade message.
Limits
You can send up to 30 messages per minute. If you hit the limit the bot will ask you to slow down.