Discord Bot

Discord Bot

The Eeko Discord bot allows you to receive live alerts and notifications directly in your Discord server.

Getting Started

Adding the Bot to Your Server

1. Navigate to the Connections page in Eeko.app
2. Click on Connect Discord
3. Authorize the bot to join your server
4. Select the server where you want to add the bot
5. Grant the necessary permissions and complete the setup

Required Permissions

The bot requires the following permissions to function properly:

• Send Messages - To send alert notifications
• Embed Links - To create rich embed messages
• Use Slash Commands - To register and respond to commands
• Read Message History - To provide context when needed
• Manage Messages - To update or delete alerts if configured

Available Commands

The Eeko Discord bot currently provides one command:

/run Command

• Purpose: Execute Eeko automations configured with Discord triggers
• Required Permission: Administrator
• Usage: /run - Shows a list of available automations that have Discord triggers configured

Only automations that have been specifically configured with a Discord trigger in Eeko.app will be available through this command. Users must have Administrator permissions in the Discord server to use this command.

Managing Permissions

Discord provides built-in tools to control who can use bot commands in your server.

Setting Command Permissions

1. Open Server Settings

   • Right-click on your server name
   • Select Server Settings

2. Navigate to Integrations

   • Click on Integrations in the left sidebar
   • Find the Eeko bot and click Manage

3. Configure Permissions

   • Set permissions for each command
   • Control access by:
     • Roles (e.g., @moderator, @admin)
     • Channels (e.g., #bot-commands only)
     • Individual users

Permission Requirements

The /run command requires:

• Administrator permission - Only users with Administrator role can execute automations
• This ensures that automation triggers are controlled and cannot be executed by regular server members

Automation Triggers

The Discord bot can execute automations that you've configured in Eeko.app with Discord triggers.

Setting Up Discord-Triggered Automations

1. Create an automation in Eeko.app
2. Add a Discord trigger to the automation
3. Configure the trigger settings
4. Save the automation
5. Use /run in Discord to execute the automation

Automation Types

Automations can include:

• Stream alerts and notifications
• Custom webhook executions
• Multi-step workflows
• Integration with other services connected to Eeko

Customization

Customization of automations is done through the Eeko.app interface:

Automation Configuration

• Trigger Settings - Configure when and how automations can be triggered from Discord
• Action Steps - Define what happens when the automation runs
• Output Formatting - Customize messages and responses sent to Discord
• Conditional Logic - Add conditions to control automation flow

Discord Output Options

When automations send messages back to Discord:

• Rich Embeds - Formatted messages with colors and fields
• Plain Text - Simple text responses
• Mentions - Tag users or roles when needed
• Channel Selection - Choose where responses are sent

Troubleshooting

Bot Not Responding

1. Check if the bot is online (green status indicator)
2. Verify the bot has permission to read/send messages in the channel
3. Ensure slash commands are enabled for the server
4. Confirm user has Administrator permission to use /run
5. Try re-inviting the bot if issues persist

/run Command Not Working

1. Verify you have Administrator permissions in the Discord server
2. Check that you have automations with Discord triggers configured in Eeko.app
3. Ensure the Discord connection is active in Eeko.app
4. Confirm the bot has necessary permissions in the channel

Permission Issues

1. Ensure the user has Administrator permission to use /run
2. Check that the bot's role is high enough in the role hierarchy
3. Verify channel-specific permission overrides
4. Review integration permissions in server settings

Best Practices

Channel Organization

• Create a dedicated channel for bot commands
• Limit /run command usage to specific channels if needed
• Use channel permissions to control access

Automation Management

• Test automations in Eeko.app before using them in Discord
• Keep automation names clear and descriptive
• Document what each automation does for team members
• Regularly review and update automation configurations

Security

• Only grant Administrator permission to trusted users
• Regularly audit who has access to the /run command
• Review automation triggers and actions for security implications
• Monitor automation execution logs in Eeko.app

Support

Need help with the Discord bot?

• Visit Eeko.app support
• Join our community Discord server
• Check the FAQ section
• Contact support through the app

Updates

The Discord bot is regularly updated with new features and improvements. Stay informed about updates:

• Follow announcements in the app
• Check the changelog in Discord
• Enable update notifications in settings