Skip to content
ClickRuntime

Guides

Troubleshooting

Fix failed runs, missing setup, signature errors and connection problems.

Start by asking the assistant. It can read the same run history and logs you see in the ClickRuntime dashboard.

Example prompt: Why did my last run fail, and what should we change?

A run failed#

Open the automation, then the failed run. The error is shown in plain language with the log lines around it. Common causes:

  • The outside service returned an error: a 401 or 403 usually means the secret is wrong or expired. Save a new value under the same name.
  • The page or API changed shape: ask the assistant to update the script using the latest response.
  • Timed out: the run hit the time limit. Ask for a lighter check or split the job.
  • Import error: the script used a package that isn't available. See the package list.

"Needs setup"#

A connection or secret is missing. The setup checklist on the automation page has a button for each missing item. Secrets must be added by an owner or admin.

It's live but nothing happened#

  • Check the schedule's timezone and the next run times on the automation page.
  • For trigger links, check Recent events. If nothing is listed, the sender isn't reaching the URL: check you pasted the whole link.
  • If events are listed but no runs appear, look for Rejected: signature invalid next to them. Require signature is rejecting them: check the provider and signing secret.
  • Check Billing. When monthly runs are used up, runs are skipped until the next period.

Slack messages don't arrive#

For alerts and notify.slack messages, make sure Slack for notifications is connected on Connections & secrets, that the channel exists, and that the ClickRuntime app has been invited to it. For automations that post through your own Slack app, invite that app to the channel instead. If the connection shows Reconnect, connect it again.

The assistant says it can't find my automation#

The assistant only sees the workspace chosen when you connected it. Settings → AI assistants shows each connected assistant and its workspace. To use a different workspace, disconnect the assistant there and connect it again, choosing that workspace.

Still stuck#

Report it under Issues in the ClickRuntime dashboard, or ask your assistant to report it. Include the automation and, if relevant, the run. Support replies there. You can also email hello@clickruntime.com. Never include secret values.