Skip to content
Help Center
Browse documentation

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.

Updated 6 min read

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

  1. Open the project, then select Integrations in the left sidebar.

  2. Open the Slack tab. The card says Not connected.

    The Slack tab showing Connect Slack with an Add to Slack button
    Each project has its own Slack connection

  3. Select Add to Slack. Slack opens and asks you to sign in and approve the TestOptim app.

  4. 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.