back to docsautomations

Automations
Triggers, conditions, actions.

Build rules from triggers and actions that work across both platforms: welcome sequences, scheduled posts, role changes, and custom event hooks. One builder for Discord and Telegram.

discord/telegram/event-driven
01overview

What an automation rule is

Event-Driven Triggers
React to messages, user actions, and server events automatically
Smart Conditions
Use powerful filters to trigger automations only when specific criteria are met
Multiple Actions
Execute multiple actions in sequence when conditions are met
Cross-Platform Support
Works seamlessly on both Discord and Telegram servers
Template System
Use variables and templates for dynamic message content
Real-time Processing
Automations execute instantly when triggered
02setup

Six steps from blank rule to live

Six steps. Save and test before flipping the rule on; bad conditions can fire a lot more often than you intend.

  1. 01

    Access Automations

    Navigate to the automations section in your server dashboard

    • 01Select your server from the dashboard
    • 02Click on "Automations" in the server menu
    • 03You'll see your existing automations or an empty list
  2. 02

    Create New Automation

    Start creating your automation from a template or from scratch

    • 01Click "Create Automation" to open the template picker
    • 02Choose from popular templates or browse by category
    • 03Select a template that matches your needs or start with an empty automation
  3. 03

    Configure Event Type

    Choose what event will trigger your automation

    • 01The event type is set based on your template selection
    • 02Common events include message created, user joined, message deleted
    • 03Each event type determines which conditions and actions are available
  4. 04

    Set Up Conditions

    Define when your automation should trigger

    • 01Add conditions to filter when the automation runs
    • 02Use "contains" conditions for keyword filtering
    • 03Combine multiple conditions with AND/OR groups
    • 04Leave conditions empty to trigger on all events of the chosen type
  5. 05

    Configure Actions

    Define what happens when conditions are met

    • 01Add one or more actions to execute
    • 02Actions can include posting messages, moderation actions, or role changes
    • 03Use template variables like $author, $message, $channel for dynamic content
    • 04Actions execute in the order they are added
  6. 06

    Test and Enable

    Save, test, and activate your automation

    • 01Save your automation configuration
    • 02Test the automation with a sample scenario
    • 03Enable the automation when you're satisfied with the setup
    • 04Monitor automation performance in the dashboard

ready to configure

Open the dashboard and start with a template.

The template picker has the most common patterns already set up. Customize from there instead of starting blank.

03event types

Available events

Each event determines which conditions and actions are available. The category tag tells you which class of object the event is about.

  • Message Createdmessage

    Triggers when a new message is posted

    Auto-reply to help requests

  • Message Editedmessage

    Triggers when a message is edited

    Log message changes

  • Message Deletedmessage

    Triggers when a message is deleted

    Log deleted messages

  • User Joineduser

    Triggers when a user joins the server

    Send welcome message

  • User Leftuser

    Triggers when a user leaves the server

    Log departures

  • User Banneduser

    Triggers when a user is banned

    Log ban reasons

  • Channel Createdchannel

    Triggers when a new channel is created

    Set default permissions

04conditions

Available conditions

Combine with AND/OR groups for compound logic. Leave conditions empty to fire on every matching event.

  • Contains

    Check if message contains specific text

    message contains "help"

  • Author

    Filter by message author or user role

    author has role "Moderator"

  • Channel

    Filter by specific channel

    message in channel "#general"

  • User

    Filter by specific user

    user is "JohnDoe"

  • Message Type

    Filter by message type (text, image, file)

    message type is "image"

  • AND/OR Groups

    Combine conditions with logical operators

    (contains "help" OR contains "support") AND author has role "Member"

05actions

Available actions

Actions run in the order they’re listed. The first failure stops the chain unless you’ve set the rule to continue past errors.

  • Post Message

    Send a message to a channel

    Post "Welcome!" in #general

  • Reply

    Reply directly to the triggering message

    Reply with help information

  • Delete Message

    Delete the triggering message

    Delete spam messages

  • Ban User

    Ban the user who triggered the automation

    Ban users posting prohibited content

  • Kick User

    Kick the user from the server

    Kick users for minor violations

  • Add Role

    Assign a role to a user

    Give "Verified" role to new members

  • Create Channel

    Create a new channel

    Create temporary voice channels

06variables

Variables for actions

Each variable expands against the triggering event. Variables resolve to empty strings when the event doesn’t carry that field.

  • $author

    The user who triggered the automation

    @JohnDoe

  • $message

    The content of the triggering message

    Hello everyone!

  • $channel

    The channel where the event occurred

    #general

  • $server

    The name of the server

    My Community

  • $timestamp

    When the event occurred

    2:30 PM

  • $user

    The user affected by the event (for user events)

    @NewMember

07patterns

Six patterns to copy

Six patterns that show up across customer servers. The meta row is the rough shape: which event, how many conditions, how many actions.

  1. case · 01

    Welcome New Members

    Automatically greet new users when they join your server

    e.g. Send a welcome message with server rules when someone joins

    event
    User Joined
    conditions
    1
    actions
    2
  2. case · 02

    Auto-Moderation

    Automatically moderate inappropriate content

    e.g. Delete messages containing banned words and warn the user

    event
    Message Created
    conditions
    1
    actions
    3
  3. case · 03

    Support Bot

    Provide automated responses to common questions

    e.g. Reply with FAQ when users ask for help

    event
    Message Created
    conditions
    1
    actions
    2
  4. case · 04

    Link Filter

    Control where users can post links

    e.g. Delete messages with links in general channels

    event
    Message Created
    conditions
    3
    actions
    2
  5. case · 05

    Event Notifications

    Notify users about important events or announcements

    e.g. Cross-post announcements to multiple channels

    event
    Message Created
    conditions
    2
    actions
    2
  6. case · 06

    Keyword Reactions

    Automatically react to messages with specific keywords

    e.g. Add reactions when users mention specific topics

    event
    Message Created
    conditions
    1
    actions
    2
08troubleshooting

Common issues

still stuck

Talk to the people who wrote the code.

Support is run by the same team that ships the product. Both rooms below are watched during working hours, and answers do not go through a tier-one queue.

end of page