Connect Slack and use /testoptim commands
Post test results, new issues and run failures to a Slack channel, choose which events to send, and use /testoptim to list issues or start a run from Slack.
In this article
To get TestOptim alerts in Slack, open your project's Integrations tab, choose Slack, select Add to Slack and pick a channel. You then get test results, new issues and failures where your team works, and can list issues or start a run with /testoptim.
Before you start
- You need the Owner or Admin role. See Roles and permissions.
- Integrations are available on the Startup plan and above. On the Solo plan or a trial you see an upgrade prompt instead of the setup. See Compare plans and limits.
- You need permission to add apps in your Slack workspace.
- Setup is per project. Use one project per Slack channel.
Connect Slack
Open the project, then select Integrations in the left sidebar.
Open the Slack tab. The card says Not connected.

Each project has its own Slack connection Select Add to Slack. Slack opens and asks you to sign in and approve the TestOptim app.
After you approve, you return to the Integrations tab. Under Post to channel, choose a channel and select Save channel.
If your Slack workspace is already connected to another project in your organization, TestOptim reuses it and skips the Slack approval. You only choose a channel.
Note
Public channels work immediately and are listed automatically. For a private channel, run /invite with the TestOptim bot name inside that channel first, then refresh the list. TestOptim can only see private channels it has been added to.
Note
The Slack approval step happens on Slack's own screens, so this article doesn't show them.
Choose what Slack receives
Once a channel is saved, the card shows the Workspace, Channel and Last message. A second card lets you tune what the project sends. These are the defaults.
| Event | Sent by default |
|---|---|
| Issue created | Yes |
| Issue status changed | Yes |
| Test run completed | Yes |
| Test run failed | Yes |
| Issue assigned | |
| Issue commented | |
| Test generation completed | |
| Exploration completed | |
| Agent job failed | |
| Quota exhausted |
Under the toggles you can also set:
- Minimum severity: Low — everything, Medium and above (the default), High and above or Critical only.
- Daily digest: turn it on and pick a time. The default time is 09:00. You get one summary a day, in the project's timezone.
- Thread test run results: on by default. TestOptim posts one message per run and puts each failure in its thread, instead of one message per failure.
Select Save changes to apply, or Reset to discard.
To check everything works, select Send test message on the connection card. Change channel moves alerts to another channel, and Disconnect removes the connection.
Use /testoptim in Slack
Type these in the connected channel.
| Command | What it does |
|---|---|
/testoptim help |
Lists the commands and offers a File an Issue button. |
/testoptim status |
Replies that the bot is online and shows the linked project. It doesn't check your app's health. |
/testoptim issues |
Lists the 10 most recent issues that aren't closed, fixed or rejected. |
/testoptim issues open |
Same list. |
/testoptim issues high |
Only high and critical issues. |
/testoptim run |
Starts a run of the whole test suite and replies with a link. If you have fewer executions left than test cases, it runs as many as you have left and says so. |
Replies are private to you.
Warning
/testoptim issues mine doesn't filter to your issues. It shows the same open issues as /testoptim issues.
Starting a run from Slack
/testoptim run runs as you, so TestOptim has to recognise you:
- Your Slack profile email must exactly match your TestOptim email.
- You must belong to the organization and have a role that can start runs (QA Engineer or higher).
If not, Slack replies "We couldn't match your Slack account to a TestOptim user in this organization. Make sure your Slack email matches your TestOptim account email, or ask a workspace admin to invite you." or "Your TestOptim role doesn't allow you to do that."
Other replies you may see: "A test run is already in progress for this project." and a quota message if the plan's test executions are used up.
File an issue from Slack
Use the File an Issue button in the /testoptim help reply to add an issue to the project without leaving Slack. Fill in the title, description, severity and category, then submit. It appears in the project's Issues list like any other.
As with /testoptim run, TestOptim files the issue as you:
- Your Slack profile email must exactly match your TestOptim email.
- Your role must be allowed to create issues: QA Engineer or higher. Developers and Viewers can open the form, but submitting it is refused.
If not, the form shows the same "We couldn't match your Slack account…" or "Your TestOptim role doesn't allow you to do that." message.
An issue filed from Slack has no test case behind it, so its fix is checked by looking at the page, and it has no Re-test this fix button. See Mark an issue fixed and let TestOptim verify the fix.
Buttons on alert messages
Messages about issues (created, status changed, assigned, commented) carry these controls:
| Control | What it does | Who can use it |
|---|---|---|
| View Issue | Opens the issue in TestOptim. | Anyone |
| The ⋯ menu: Mark In Progress, Mark Fixed, Close, Reopen | Changes the issue's status. Mark Fixed and Close start the same fix check as in the app. | Developer or higher |
| Assign to me | Assigns the issue to you. | Developer or higher |
| Mute this alert | Turns off this type of alert for the project's channel. | Owner or Admin |
Test run messages have a View Test Run button. Slack must match your account by email for every control except View. The reply to /testoptim issues also has a Share to channel button that posts the list for everyone in the channel.
Why does /testoptim run say my Slack account can't be matched?
TestOptim runs the command as you, so your Slack profile email must exactly match your TestOptim email and you must be in the organization. See the list above.
Fix common problems
- "This Slack channel isn't connected to a TestOptim project." The channel isn't linked to exactly one project. If two projects post to the same channel, commands stop working. Give each project its own channel.
- The card says "Needs attention". The bot isn't in the channel anymore. Invite it, or pick a different channel.
- Slack's connection is no longer valid. Select Disconnect & reconnect and add the app again.
Related
Keep reading
- Account & notificationsChoose which email and in-app notifications you getTurn TestOptim email and in-app notifications on or off, choose which events you hear about, and opt in to the Monday weekly digest.
- Integrations & APIConnect Jira and sync issue statusFile the issues TestOptim finds into a Jira project automatically or by hand, and keep their status in sync both ways, with optional re-verification.
- IssuesAssign issues and discuss them in commentsHand an issue to a teammate, get them notified, and keep the conversation on the issue with comments. Includes what does and does not work with @mentions.
- Integrations & APIRe-explore automatically on every GitHub pushConnect a GitHub repository so each push or merged pull request re-explores your app and refreshes its knowledge. It does not run your tests; use CI for that.