Workspace Action Triggers

The Action Triggers Module in Panora allows you to create customizable, command-based actions within your Discord server. These triggers are ideal for structured announcements and shift announcements.

Creating a Trigger

1. Open Your Workspace Log in to the Panora Dashboard and select your workspace. Navigate to the Action Triggers tab from the sidebar.

2. Create a New Trigger Click + New Trigger and enter the required details, including the trigger name and description.

3. Configure Trigger Settings Customize settings such as:

   • Announcement channels

   • Embed formatting

   • Message templates

   • Timing features

   • Custom fields

4. Using the Trigger Command In your Discord server, type the command for your trigger: !triggerName (replace with your trigger’s name). This will execute the trigger according to your configured settings.

---

Configuration Breakdown

Trigger Parameters

Parameter	Type	Description	Example
Trigger Name	string	Name used to activate the trigger	training
Description	string	Message template executed when triggered	Welcome to {server}! Event starts in {channel}
Allowed Roles	array	Roles allowed to execute the trigger	@Executive, @Management
Channel ID	number	Target Discord channel for messages	#announcements
Embed	boolean	Enable or disable embedded formatting	true/false
Embed Colour	string	Border color for the embed	24bef9
Embed Title	string	Optional title for the embed	Training Announcement
Embed URL	string	Clickable link for the embed title	https://discord.gg/...
Embed Author Name/Icon	string	Name and icon displayed in the embed header	Panora Management Team
Embed Image/Thumbnail	string	Optional images for the embed	URL
Embed Footer Name/Icon	string	Footer text and icon	Panora Bot System
Embed Footer Timestamp	boolean	Toggle timestamp in footer	true/false
Ping	string	Who should be pinged, supports {args1}	@Events, {args1}
Trigger Delete	boolean	Auto-delete the command message	true/false
Message Delete	number	Auto-delete bot’s response after X seconds	30
Cooldown	number	Prevent repeated usage per user	60 (seconds)

---

Embed Fields

You can add up to 5 custom fields to embeds:

Field	Type	Description
Field Name	string	Title/header of the field
Field Value	string	Body/content, supports variables and arguments
Field Inline	boolean	Display inline with other fields (true/false)

---

Variables & Arguments

Use variables and arguments to create dynamic, personalized messages.

Common Variables:

Variable	Description
{user}	Mentions the user executing the command
{avatar}	Displays user avatar URL
{username}	Displays username
{server}	Server name
{channel}	Mentions current channel
{&role}	Dynamically mention a role
{#channel}	Dynamically mention a channel
{everyone}	Mentions @everyone
{here}	Mentions @here

Arguments: Insert {args1}, {args2}, etc., to reference user input dynamically. Arguments work in all fields including titles, descriptions, and custom embed fields.

Example: Set Ping to {args1} to ping a dynamic target instead of a pre-configured role.

---

Trigger Logic & Execution

• Role-Based Access: Only users with Allowed Roles can execute the trigger.

• Channel Targeting: Messages are sent to the configured channel or where the command is used.

• Embed Support: Enable for visually rich messages with custom formatting.

• Cooldown Protection: Prevent spam by setting per-user cooldowns.

---

Timing Features

• Auto-Delete Trigger: Remove the user’s command message after execution.

• Auto-Delete Response: Remove the bot’s response after X seconds.

• Cooldown System: Prevent repeated triggering by the same user.

---

Error Handling

• Misconfigured triggers return a friendly error message.

• Role or channel lookup failures retry up to three times.

• Cooldown violations display the remaining wait time.

---

Example Trigger

Training Session Announcement:

!training

We're excited to announce that there is currently a training, hosted by our wonderful management member {user}. We warmly invite you to join us and obtain a Staff Rank!

Session Host: {user}
Co-Host: {args1}
Server: {args2}

Signed,
{user}
Panora Talent Team

Dynamic Ping Example: Set Ping to {args1}, then run: !training @EventTeam → This pings @EventTeam dynamically instead of a static role.

---

Summary

Action Triggers in Panora provide flexible, automated, and dynamic messaging for your Discord server. Use triggers for events, announcements, reminders, or any structured messages, with full control over embeds, variables, role permissions, and timing features.