Discord Bot

ViewsBase includes a Discord bot that lets creators submit their TikTok and Instagram posts directly from any Discord server. Submissions appear on your dashboard immediately.

How It Works

1. You invite the bot to your Discord server
2. You whitelist that server for a campaign in the dashboard
3. Creators use /submit-post in Discord to submit their videos
4. The video appears in your campaign's Posts tab instantly with stats already populated

No manual video entry needed — creators self-serve through Discord.

Step 1: Invite the Bot

Click the link below to add the ViewsBase bot to your Discord server:

Invite ViewsBase Bot

You'll need Manage Server permission in the Discord server to add the bot.

Step 2: Whitelist the Server

After the bot is added, you need to tell ViewsBase which campaign this server belongs to. This prevents creators from submitting to the wrong campaign.

There are two ways to whitelist a server:

Option A: Use the /whitelist command (recommended)

Run this directly in the Discord server you want to whitelist:

/whitelist action:Add campaign:MyCampaign

The bot will show a dropdown of campaigns you have admin access to. Select one and the server is whitelisted instantly.

To remove a server from a campaign:

/whitelist action:Remove campaign:MyCampaign

Only org admins and campaign admins with a linked Discord account can use this command.

Option B: Use the dashboard

1. Go to your campaign in the ViewsBase dashboard
2. Click the Settings tab
3. Under Discord Server Whitelist, paste a Discord link or server ID
4. Click Add Server

To get a Discord link, right-click any channel in your server and click Copy Channel Link. The link looks like https://discord.com/channels/1234567890/9876543210. ViewsBase extracts the server ID automatically.

Multiple servers per campaign

You can whitelist multiple Discord servers for the same campaign. This is useful if you run the same campaign across different communities.

No whitelist = all servers

If you don't whitelist any servers, the campaign is available in every server the bot is in. Once you add at least one server, the campaign becomes restricted to only those whitelisted servers.

Step 3: Creators Submit Posts

Once the bot is in the server and the server is whitelisted, creators use the /submit-post command:

/submit-post url:https://www.tiktok.com/@creator/video/1234567890

What happens on submit

1. The bot fetches the video's stats (views, likes, comments, shares) from TikTok or Instagram
2. It looks up the creator by their platform handle
3. If the creator has one campaign in this server, the video is automatically assigned to it
4. If the creator has multiple campaigns, they pick one from the dropdown
5. The video is created in the dashboard with status Active and stats pre-populated

The creator must be registered first

The creator's TikTok or Instagram handle must already be added to the campaign in the Creators tab. If the bot can't find the handle, it tells the creator to ask their admin to register them.

48-hour submission window

Creators must submit within 48 hours of posting the video. Older posts are rejected. This keeps campaigns focused on fresh content.

What Creators See

After a successful submission, the bot replies with a confirmation embed showing:

• Campaign name
• Platform (TikTok or Instagram)
• Current view count
• Current like count

If something goes wrong (unregistered handle, expired post, duplicate submission), the bot shows a clear error message explaining what to do.

Paused creators

If a creator has been paused by an admin, they'll see a "Creator Paused" message when trying to submit. They won't be able to submit posts until an admin resumes them from the campaign's Creators tab.

Campaign Selection

When a creator has access to multiple campaigns in the same server, the /submit-post command includes an optional campaign parameter with autocomplete. The bot shows only campaigns that:

1. The creator has an active offer for
2. Are whitelisted for the current Discord server

If the creator only has one matching campaign, it's selected automatically — no need to specify.

Link Your Discord Account

Team members can link their Discord account to ViewsBase for identity verification. This is optional but recommended if you manage campaigns through the bot.

1. Go to your Account page (top nav)
2. Click Connect Discord
3. Authorize via Discord's OAuth flow
4. Your Discord username and avatar will appear on your account

To unlink, click Disconnect on the same page.

FAQ

Can creators submit from DMs?

No, the bot only works in servers. It needs the server ID to check the whitelist.

What if I remove a server from the whitelist?

Existing submissions stay in the campaign. New submissions from that server will be blocked (the bot shows "no active campaigns available in this server").

Can different campaigns share the same Discord server?

Yes. If multiple campaigns are whitelisted for the same server, creators with offers from more than one campaign will be asked to pick which one.

How do I pause a creator?

Go to the campaign's Creators tab and click the status badge next to the creator's name. It toggles between Active and Paused. Paused creators can't submit new posts via Discord and will see a "Creator Paused" message. Their existing posts are not affected.

Who can use the /whitelist command?

Only team members who are org admins or campaign admins and have linked their Discord account. The command only shows campaigns you have admin access to.

Do I need to restart the bot after whitelisting?

No. Whitelist changes take effect immediately — the bot checks the database on every submission.