Build paths

Run work on a schedule with routines

Make a routine by asking in the chat, follow its runs in Library › Routines, run one now, cancel a run, pause or archive a routine, and do the same by asking in the chat.

On this page

A routine is work Ahamo does for you on a schedule, without you starting it, such as a summary of this morning's orders, last week's sales totals in an email, a reminder the day before a booking. Every routine in your workspace is in Library › Routines, with its last result, when it runs next, and Run now.

When to use it

  • The same work should happen every day, every week, or every hour.
  • You want to see whether it worked without opening the app it lives in.

For a one-off task, ask in the chat instead. For something other systems call, build an API; see Build an API or a routine.

Make a routine

Ask in the chat, or open Library › Routines and choose New routine, which opens a chat. Say what should happen and when.

Every Monday at 08:00, email last week's sales totals to the team.

Every night, back up our Notion customer database to a sheet.

Ahamo builds the routine and says in one line when it runs and whether it uses AI on each run. Like an app, a routine runs from the published version, so publish it to start the schedule; see Publish your app. A routine that isn't published shows Not published, so it can't run with a Publish button.

How it runs

Each routine shows how it runs:

  • Same steps every time · no AI means the same code runs on every run and uses no AI, so its runs cost no credits. Good for copying, sending, reminding and backing up.
  • AI each run means its code calls Ahamo's AI, so each run may use your workspace's credits. For example, a digest that reads new emails in Gmail, summarises them with AI and saves the summary to Notion. See AI in your apps.

Ahamo decides this from the routine's code. To change it, ask in the routine's chat.

A routine the AI handles fresh each run

TO BE IMPLEMENTED / ON ROADMAP

This describes an intended Ahamo capability. It is not currently available as a supported end-to-end product.

Some work needs judgement on every run, such as summarising the last day's email and saying what needs a reply, or sorting new support tickets and drafting answers. A routine of this kind will have the AI do the work fresh each time, with a choice between the two kinds on the routine's page, the cost of a run, live steps while it runs, and an Approve step before it changes anything. Until then, ask for fixed steps with one AI step, as in the Gmail-to-Notion digest above.

The Routines list

Open Library in the workspace sidebar and choose Routines. Choose Active, Paused or Archived to see those routines, and type in the search box to find one by name. Each row shows:

  • its schedule, in your own time;
  • its name, and whether it uses AI each run;
  • its last run, when it was and what it did or why it didn't work, in plain words;
  • Run now, and ⋯ with Pause or Turn on, Archive or Restore, Open chat and See code.

On a phone, Run now is in the ⋯ menu.

A routine's page

Select a routine's name to open its page:

  • At the top are its name, one line on what it does, Run now, Change (opens its chat) and ⋯.
  • Its latest result in plain words, with Publish, Connect or Fix in chat when one of them is needed.
  • Schedule holds the switch that turns it off or on, with its schedule.
  • An overview of its runs shows how many ran, how many worked, and the average run time. It covers the last 7 days. When fewer days are kept, it says Since and a date.
  • Run history lists its runs of the last 7 days, newest first, with All, Worked and Didn't work. A run in progress is at the top.
  • Steps shows what starts it, then the run, each with its current state.

Select a run to see its log, with its status, when it started and ended, how long it took, and what it did or why it didn't work. Show output shows what it printed. A failed run offers Fix in chat. Choose Back to runs to return.

Run now and Cancel run

Run now starts a run straight away, without waiting for the schedule. Use it to check a new routine or to try again after a failed run. It also works while the routine is off.

While a run is in progress, open it in Run history and choose Cancel run to stop it. It is recorded as cancelled and isn't tried again.

Run now and Cancel run need permission to publish the app the routine lives in; without it, you don't see them.

Pause, archive and restore

Pause stops the scheduled runs and keeps everything else, including the routine, its settings and its history. Turn on starts the schedule again from the next scheduled time, without running the ones it missed. The switch on the routine's page does the same.

Archive turns a routine off and moves it to Archived, out of the routines in use. Restore brings it back and turns it on.

To remove a routine for good, ask in its chat. Unpublishing the app it lives in also stops it, and deletes its run history.

Dashboard refreshes

A dashboard's refresh schedule is listed with your routines, named after the dashboard, as in Sales overview refresh, with Dashboard beside it and whom it runs as. Its row has Run now, and its ⋯ menu changes the schedule, turns it off, turns it on again, removes the schedule or opens the dashboard. A refresh that is off is under Paused, marked Off. A paused refresh that waits on you is under Needs you.

Ask in the chat

Everything in Library › Routines also works by asking in a chat, as in this example.

Which of my routines failed this week?

Run the morning order summary now.

Pause the weekly sales email until further notice.

Ahamo checks the same permissions as the page and says what it did.

Needs you

When a routine can't go on without a person, it appears under Needs you at the top of Library › Routines and on Home, and Home in the sidebar shows how many things wait on you. For example, when a routine uses Gmail and Gmail isn't connected, the row offers Connect Gmail; see Connectors.

A failed run is not in Needs you. It shows in the routine's row with the reason, and the next scheduled run tries again.

Troubleshooting

Not published, so it can't run. A routine runs from the published version. Choose Publish.

The last run failed. Read the reason in the row or on the routine's page. Choose Run now to try again, or Fix in chat to have Ahamo change the routine.

I can't see Run now. You need permission to publish the app. Ask someone who can publish it.

On this page