Knowledge Base Article

Orchestrator Admin Configuration Guide

This guide provides a comprehensive overview of the Community Orchestrator(Automations) tool. It will go into detail on how to build rules & what each trigger/condition/action means within the tool.

 

Figure 1. Community Automations rule list in the Admin panel.

1. Overview

Orchestrator (Community Automations) lets administrators configure rule-based workflows that respond to specific events in the community. Each rule follows a simple logic pattern: when a trigger occurs, the system checks any configured conditions and then executes the selected actions.

  • Use orchestrator to streamline repetitive admin work.
  • Apply actions only when the defined criteria match.
  • Combine business rules with community events such as registration, role assignment, group joins, and topic activity.
  • Configure one or more actions per rule.

When a trigger happens  →  evaluate conditions  →  run one or more actions

2. Accessing the tool

In the admin settings, navigate to: Admin Panel → System → Community Automation.

From the Orchestrator landing page, admins can see whether rules are enabled, review existing rules, and create a new rule from the Create Rule button in the upper-right area of the page.

Figure 2. Community Automations landing page showing existing rules and the Create Rule entry point.

3. Creating a rule

To create a rule, open the Create Rule form and complete the key sections shown in the builder.

Step

What to do

Notes

1

Enter a rule name.

Required.

2

Add a description (Optional).

Useful for internal admin clarity.

3

Set the rule to enabled or disabled.

Rules can be created in a disabled state if you want to activate later.

4

Choose the trigger.

Required and cannot be changed after the rule is created.

5

Add conditions if needed.

Optional; use them to narrow when the rule should execute.

6

Add one or more actions.

Required.

7

Create the rule.

The rule is saved with the selected configuration.

 

Figure 3. Create Rule form with name, description, enable toggle, trigger, conditions, and Create action.
Note: Limit of maximum 10 custom rules at a time. 

4. Rule builder anatomy

Builder area

Purpose

Name

Identifies the rule in the admin list.

Description

Provides optional internal context for administrators.

Enabled toggle

Controls whether the rule is active.

When a member…

Defines the trigger event that starts the rule.

If…

Adds optional filtering conditions.

Then…

Defines the action or actions that should be performed.

5. Available triggers

Triggers are the events that initiate a rule. Once a trigger occurs, Orchestrator checks the configured conditions and executes the actions if the rule criteria are satisfied.

Trigger

Meaning

User Registers

A new user completes registration in the community.

User Email Verified

A user successfully verifies their email address.

Role Granted

A role is assigned to a user.

User Requests to Join Group

A user submits a request to join a group.

Topic Posted

A new topic or thread is created.

Topic Updated

An existing topic is edited or updated.

Topic Moved

A topic is moved from one board to another.

Topic Deleted

A topic is deleted.

Solution Accepted

An answer is marked as the accepted solution.

Expert Notification Triggered

The system identifies that an expert should be notified about a topic or question needing specialist attention.

Clarification Nudge Requested

The AI system automatically detects that a question or post is unclear and nudges the original author to add more detail. This is an AI-powered trigger - it fires based on system intelligence, not a manual user or admin action. The target of actions under this trigger is the original post author. You can find more information here. 

Figure 4. Trigger selector showing the currently available trigger options.
Note: Unlike other triggers that fire based on explicit user or admin actions, "Clarification Nudge Requested" is an AI-powered trigger that fires when the system's intelligence layer detects a question that lacks enough detail to be answered effectively.

6. Conditions and operators

Conditions are optional. Use them when a rule should run only for a subset of users, boards, or groups. The current UI supports the operators Equal To and Not Equal To.

Condition type

What it checks

Email Domain

Matches the domain portion of a user email address, such as company.com.

Role

Checks whether the user has a specific role.

Group

Checks whether a specific group is involved.

Board

Checks whether a specific board is involved.

Figure 5. Example of conditions using Role and Email Domain, with an AND connector and the condition type dropdown.

Guidance for using conditions:

  • Use Email Domain to separate internal users from external users.
  • Use Role when actions should apply only to members with a known entitlement or status.
  • Use Group when approving or messaging should be scoped to a specific community group.
  • Use Board when a content-related automation should apply only in a particular board or forum.
Note: Each rule in the Rule Builder supports up to 10 total conditions (across IF, THEN, and webhook headers).

7. Available actions

Actions determine what the system does when the trigger occurs, and the conditions match. A rule can include more than one action.

Action

Purpose

Assign Roles

Automatically assigns one or more roles to the user.

Approve Request

Automatically approves a pending request when the rule criteria are met.

Call Webhook

Sends an HTTP request to an external URL so the event can be passed to another system.

Send Email

Sends an email notification using available event variables.

Send Private Message

Sends a community private message using available event variables.

Figure 6. Action picker showing the currently available action types.

8. Action configuration details

Assign Roles

Use this action to automatically add one or more roles to a user when the rule criteria are met. This is useful for onboarding, entitlement mapping, or permission management.

Figure 7. Assign Roles action configured with multiple target roles.

Call Webhook

Use this action to notify an external system by sending an HTTP request to a configured endpoint. The UI supports a destination URL and optional custom request headers.

Figure 8. Call Webhook action with endpoint URL and optional custom headers.

How it works

The Call Webhook action pushes event data from the community to any external system that can receive HTTP requests. Common use cases include sending notifications to Slack or Microsoft Teams, logging events to an audit system, triggering workflows in automation platforms (such as Zapier or Make), and syncing data with a CRM, ticketing system, or internal tool.

When the rule fires, Orchestrator sends an HTTP POST request to your configured URL. The request body contains a JSON payload with details about the event that triggered the rule, such as the user involved, the board, topic title, and any other relevant context.

Configuration fields

The Call Webhook action has three parts in the UI:

  • Destination URL: The full HTTPS endpoint where the request will be sent (e.g., https://hooks.slack.com/services/T00/B00/xxxx).
  • Test Endpoint button: Sends a test request to verify the URL is reachable and responding correctly before the rule goes live.
  • Custom Headers (Optional): Key-value pairs added to the HTTP request headers. Use these for authentication tokens, content-type overrides, or any custom metadata your receiving system requires.

Step-by-step: Setting up a webhook action

  • Create or edit a rule and select the trigger and conditions you need
  • In the “Then…” section, click Add Action and select “Call Webhook” from the dropdown.
  • Enter the destination URL. Paste the full endpoint URL provided by your external system. This must be an HTTPS URL.
  • Add custom headers if required. Click “+ Add Header” to add each header as a key-value pair (see examples below).
  • Click “Test Endpoint” to confirm the external system receives the request successfully.
  • Save the rule. Once created and enabled, the webhook will fire every time the trigger and conditions are met.

Example: Sending a Slack notification when a new topic is posted in a particular/any board

Slack Incoming Webhooks let external applications post messages directly into a Slack channel. You create a webhook URL inside Slack, and any HTTP POST request sent to that URL appears as a message in the channel you chose.

How to get your Slack webhook URL:

  • Go to api.slack.com/apps and create a new Slack App (or select an existing one).
  • In the left sidebar, go to Features → Incoming Webhooks and toggle it to On.
  • Click Add New Webhook to Workspace and select the channel where you want alerts posted (e.g., #community-alerts).
  • Slack generates a unique URL in this format: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
  • Copy this URL - you will paste it into the Orchestrator webhook Destination URL field.

Note: Treat this URL like a password. Anyone who has it can post messages to your Slack channel. Do not share it publicly.

Send Private Message

Use this action to send an in-community private message. The UI supports recipients, subject, body, and event variables for dynamic content.

Figure 9. Send Private Message action with available event variables.

Send Email

Use this action to send an email notification. The UI supports To, Subject, Message, content format selection, and event variables for personalization.

Figure 10. Send Email action showing recipient, subject, message, and available variables.

Approve Request

Use this action to automatically approve a pending request when the rule criteria are satisfied. This is especially useful for group join workflows where qualified users should be approved immediately.

9. Using variables in email and message content

The Send Email and Send Private Message screens display the event variables that can be inserted into the message content. Based on the current UI, the following variables are available in the examples shown:

Variable

Meaning

{USER_NAME}

Name of the requesting user

{USER_EMAIL}

Email address of the requesting user

{NODE_NAME}

Name of the group or node involved

{REQUEST_DATE}

Date the request or event occurred

{REGISTRATION_DATE}

Date and time of the user's registration. Available for the User Registers trigger.

{TOPIC_TITLE}

Title of the topic/question involved. Available for content lifecycle triggers (Topic Posted, Topic Updated, Topic Moved, Topic Deleted) and Clarification Nudge Requested.

Use variables to make messages more relevant and reduce manual follow-up. For example, you can address the user by name, reference the group involved, or include the request date in an approval notification.

The available variables panel updates dynamically based on the selected trigger. User lifecycle triggers expose user-related variables, group-related triggers add {NODE_NAME} and {REQUEST_DATE}, content triggers expose topic-related variables, and the Clarification Nudge Requested trigger exposes the question/topic that needs clarification.

10. Example rule patterns

Scenario

Configuration pattern

Employee onboarding

Trigger: User Registers.
Condition: Email Domain Equal To company domain.
Actions: Assign Roles and Send Email.

VIP auto-approval

Trigger: User Requests to Join Group. 
Conditions: Role Equal To premium role and Group Equal To target group.
Actions: Approve Request and Send Private Message.

Critical issue escalation

Trigger: Topic Posted.
Condition: Board Equal To critical issues board.
Actions: Call Webhook and Send Email.

Clarification nudge

Trigger: Clarification Nudge Requested.
Conditions: None.
Actions: Send Private Message to {{USER_NAME}} encouraging them to add detail, and Send Email with a "Clarify Your Question" template.

Expert routing

Trigger: Expert Notification Triggered.
Conditions: None (or Board Equal To specific boards).
Actions: Send Private Message to the expert team and Call Webhook to Slack/Teams.

New member welcome

Trigger: User Registers.
Conditions: None.
Actions: Assign Roles ("New Member"), Send Email ("Welcome" template), and Send Private Message with onboarding tips.

Solution author recognition

Trigger: Solution Accepted.
Conditions: None.
Actions: Send Email ("Thank You" template) and Call Webhook to external leaderboard/gamification system.

Topic moved notification

Trigger: Topic Moved.
Conditions: None.
Actions: Send Email ("Topic Moved" template) and Send Private Message to {{USER_NAME}} explaining the move.

Content deletion audit

Trigger: Topic Deleted.
Conditions: None.
Actions: Call Webhook to audit/logging system and Send Email to original author explaining the deletion.

11. Admin best practices

  • Use clear rule names and add a simple description so other administrators can understand the purpose.
  • Keep triggers broad and use conditions to narrow the scope when needed.
  • Avoid overlapping rules that may send duplicate messages or assign duplicate roles.
  • Document external webhook destinations and business owners before enabling production rules.
  • Review message content carefully when using variables so recipient-facing communications read naturally. Always preview before enabling the rule.
  • Start with a small, specific rule before expanding automation coverage.
  • Leverage the "Not Equal To" operator for exclusion-based rules (e.g., "Role Not Equal To Admin") when it's simpler than listing every role you want to include.
  •  
Updated 8 hours ago
Version 11.0
No CommentsBe the first to comment