Documentation

Getting Started

W3 Engage is a Discord bot that rewards your community for engaging with your X (Twitter) posts. Track likes, retweets, comments, and award points automatically.

Quick Start

  1. Subscribe to a plan at /pricing
  2. Invite the bot to your Discord server
  3. Configure channels with /config
  4. Create your first engagement with /tweet

Setup

1. Configure Channels

Set up the required channels for the bot:

/config tweets #engagement-channel
/config logs #bot-logs
/config marketplace #shop

2. Link Your X Account

Users need to link their X (Twitter) accounts to participate in engagements. They can do this via the web dashboard when they click the "Engage" button.

Commands

Admin Commands

/tweetADMIN

Create a new engagement task for your community.

Options: tweet_url, type (RT/Comment/Like), duration, points, roles, assign_role, role_gate
/configADMIN

Configure bot channels and settings.

Subcommands: tweets, logs, marketplace
/marketplaceADMIN

Manage marketplace items.

Subcommands: add item, remove item, edit item, delete item
/adjust-pointsADMIN

Add or remove points from a user.

Options: user, points (can be negative)
/user-infoADMIN

View detailed information about a user.

Options: user
/tweet-permissionADMIN

Allow team members to create engagement tasks. Grant permissions to trusted users so they can use the /tweet command.

Subcommands: grant, revoke, list

User Commands

/rank

Check your current rank and total points.

/leaderboard

View the top members by points in the server.

/profile

View your complete profile with points, rank, and engagement history.

Options: user (optional - view another user's profile)
/set-twitter

Link your Twitter/X account to your Discord profile.

Note: Required to participate in engagements

Dashboard

Access the web dashboard to manage your server, view analytics, and configure settings.

Open Dashboard

FAQ

How do users link their X account?

When a user clicks the "Engage" button on a tweet task, they'll be redirected to authorize their X account via OAuth 2.0. The process is secure and takes only a few clicks.

Can users reply to tweets?

Yes! Users can like, retweet, and reply directly from the engagement page. Each user can only reply once per tweet.

How are points awarded?

Points are awarded when users complete the required actions (like, retweet, comment) and click the "Claim" button in Discord. The bot verifies the engagement before awarding points.

Need more help?

Join our Discord community for support and updates.