Discourse Automation

[joffreyjaffeux]

	Summary	Discourse Automation lets you automate actions through scripts and triggers. Customisation is made through an automatically generated UI.
	Repository Link	https://github.com/discourse/discourse-automation
	Install Guide	How to install plugins in Discourse

As this is an official plugin maintained by the Discourse team, support, bug, ux, and feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

• Easy automation of complex workflows
• Triggers automations at specific dates, periodically, or on specific events
• Provides automatically generated UIs to specify options for your automation

Configuration

Automations can be created and updated from Admin → Plugins → Automations, or directly from /admin/plugins/discourse-automation.

Available scripts

Guide	Script	Trigger(s)	Description
	Add user to group through custom field	Recurring First logged on	Adds a user to a group based on a Custom User Field
	Append last checked by	After post cook	Adds a ‘last checked by’ function to the bottom of the OP
	Append last edited by	After post cook	Adds a ‘last edited by’ note to the bottom of the OP
	Auto Responder	Post edited/created PM created	Given a series of keywords and associated replies, automatically respond with the corresponding reply
	Auto Tag topic	Post created/edited PM created	Automatically tag a topic
	Close topic	Point in time Stalled wiki	Automatically close a topic
	Create Post	Recurring Point in time	Creates a post
	Flag post on Words	Post edited/created	Flag a topic on creation/edition if it contains specific words
	Gift Exchange	Point in time	Simple implementation of the Secret Santa game
	Group Category Notification Default	Category created/edited	Automatically sets a group notification level for newly created subcategories
	Make banner topic	Point in time	Convert a topic into a banner notice
	Pin Topic	Point in time	Pin and Unpin a topic in the future
	Random Assign (Assign)	Point in time Recurring	Randomly Assign a topic
	Schedule a PM with data explorer results (Data Explorer)	Recurring	Send a regular PM with the results of a data explorer query
	Send Chat message (Chat)	Event started Recurring	Sends a Chat message to a Channel
	Send PMs	First accepted solution (Solved) User badge granted User added to group Stalled wiki Recurring User promoted API call User removed from group	Send PMs with support for placeholders
	Suspend User By Email	API call	Suspend a user for a specified duration
	Topic required words	Topic	Enforce the presence of at least one of the specified words in the posts of a topic
	User Global Notice	Stalled topic First accepted solution (Solved)	Displays a global notice on the site for a specific user
	User Group Membership through Badge	Recurring User first logged in	Automatically add users to a group based on their earned badges
	Zapier webhook	User promoted User added to group User badge granted User removed from group	Calls a Zapier webhook

Available triggers

Note that due to their nature, each script only supports certain triggers. For example it wouldn’t make sense for a script enforcing the content of a post to trigger when a user is added to a group.

All of the available triggers are mentioned in the “Available scripts” table above.

Most of the triggers are self-explanatory, but here are a couple that may need a little more detail:

Trigger	Description
After post cook	Triggers after a post is rendered for display
API Call	Triggers when a certain API endpoint is called
Stalled wiki	Triggers when a wiki hasn’t been edited for a while
Stalled topic	Triggers when a topic has not received replies after a certain time
Topic	Triggers when a reply is made to a topic

If you need any clarification on any others please feel free to ask below.

More scripts and triggers to come!

Custom Automations

You can also create custom Automations. Check out our developer’s guide for more information - Create custom Automations

Hosted by us? This plugin is available on our Business and Enterprise plans. Automation | Discourse - Civilized Discussion

[JammyDodger]

Just to note, I’ve updated the OP with a table of all the existing Automations and their accompanying triggers.

(I’m also hoping to add more guides too, as the one for ‘Add user to group…’ looks a bit lonely all by itself )

[JammyDodger]

There are a couple more walkthroughs added for 'Append last edited by' Automation and 'Append last checked by' Automation.

And a brand new script, User Group Membership through Badges. That one is pretty hot off the press so if you try it out, let us know how you get on.

[Jonathan5]

@joffreyjaffeux

Most of the triggers are self-explanatory, but here are a couple that may need a little more detail:

Would you be able to list them all here? Or are they listed elsewhere?

[JammyDodger]

They’re all in the table in the OP. If you’re using the ready-made ones, they’re linked in the UI to the scripts that can use them. I was considering formatting them as a list of their own again for the custom Automation guide, but it’s not had much interest so far, I don’t think, so have held back for now.

[Jonathan5]

@JammyDodger

They’re all in the table in the OP.

I’ve added a sentence to the original post here to clarify that. Thanks.