Discord Bot
Let creators submit posts from Discord, send payment requests, and run admin commands. Set up the bot and allow your servers.
The ViewsBase bot lets creators submit TikTok, Instagram and YouTube Shorts posts from a Discord server. Posts appear in your campaign at once, with stats. The bot also posts payment requests to creators and runs a few admin commands.
Commands
| Command | Who | What it does |
|---|---|---|
/submit-post | Creators | Submit a post for tracking. Options: url and campaign. |
/add-creator | Campaign admins | Read this channel and add the creator to a campaign. Options: campaign and messages. |
/whitelist | Workspace admins and campaign admins | Add or remove this server for a campaign. Options: action and campaign. |
/invite-to-campaign | Campaign admins | Post a one-time join button for a creator in this channel. Options: user and campaign. |
/ping | Anyone | Check that the bot is running. |
/recap and /ask are removed. The admin commands need a linked Discord account.
How it works
- You invite the bot to your Discord server.
- You allow that server for a campaign.
- Creators run
/submit-postin Discord. - The post appears in the campaign's Posts tab with stats.
Step 1: invite the bot
You need Manage Server permission in the Discord server.
Let creators use commands
In Discord, open Server Settings → Roles → Creator → Permissions and turn on Use Application Commands for the role your creators have. Check that the ticket's channel permissions do not deny it. Creators also need View Channel and Send Messages in their own ticket.
These are permissions for the creator. Giving the bot permission to read and send messages does not give creators access to slash commands. Keep private ticket access limited to the existing ticket members and staff.
Step 2: allow the server
Posts sent through Discord need an allowed server. A server that is not allowed for any campaign gets "Server not allowed". The campaign's post submission link always works. There are two ways to allow a server.
Option A: the /whitelist command
Run it in the Discord server you want to allow:
/whitelist action:Add campaign:MyCampaignThe bot shows the campaigns you administer. Choose one. To remove the server later, use action:Remove. Only workspace admins and campaign admins with a linked Discord account can use it.
Option B: the dashboard
- Open the campaign, then Settings.
- In Discord (optional), choose Add server.
- Paste a Channel link or server ID. In Discord, right-click any channel and choose Copy Channel Link.
- Choose Save.
The server name and icon come from Discord. If the bot is not in that server, ViewsBase says so and shows Add the ViewsBase bot. A campaign can use several servers, and several campaigns can share one server. The card lists every allowed server, and you can remove one. If you remove the only server, Discord submissions stop until you add another. Existing posts stay.
Changes work at once. You do not restart the bot.
Step 3: creators submit posts
/submit-post url:https://www.tiktok.com/@creator/video/1234567890For YouTube, paste a Shorts link: youtube.com/shorts/…, youtu.be/… or youtube.com/watch?v=…. The link must be a Short. Longer uploads and live streams are refused.
On submit, the bot:
- Fetches the post's stats from TikTok, Instagram or YouTube.
- Finds the creator by platform handle.
- Picks the campaign. If the creator is on one campaign in this server, it is chosen. If they are on several, they pick with the
campaignoption, which suggests matching campaigns. - Creates the post as Live and replies with Post submitted, the views and the likes.
The creator's handle must already be on the campaign. If not, the bot says the creator is not registered and to ask the admin to register for the campaign.
The 48-hour window
Creators must submit within 48 hours of posting. Older posts get "Post too old". Campaign admins can submit older posts.
Other replies
The bot explains each problem: Invalid URL, Creator paused, Campaign paused, Already submitted and Post not eligible, for example when a post is dated before a per-post offer starts. When the workspace is read-only or its post limit stops new posts, the bot says the campaign is not taking new posts.
YouTube Shorts
YouTube views refresh once a day, so the count after a submit is the count at that moment. The bad post detector checks only TikTok posts. A Short submitted to a campaign with the detector on is tracked, and the bot says it was not checked.
Paused creators
A paused creator sees "Creator paused" and cannot submit. Resume them from the campaign's Creators tab.
/add-creator
Run it in a creator's ticket. The bot reads the recent messages (10 to 100, default 50) and extracts the handle, name, link in bio and agreed offer. It shows Creator info extracted for you to confirm or cancel. A confirmed creator is added, and the bot tells you with Creator added and posts an Added to message in the channel. If the creator already has a ViewsBase account with that handle verified, they are linked at once and get an email. Check the offer before you confirm.
/invite-to-campaign
Run it in a creator's ticket and choose the creator and campaign. The bot posts a one-time button that works for 7 days. When the creator joins through it, ViewsBase also connects the creator and the ticket channel, then posts a starter pack with the campaign's link in bio, requirements, guides and assets. The campaign must be on the server's allowed list.
Payment requests
From Payments, choose More → Send to Discord… for a creator. The bot posts the payment summary in the creator's channel with Mark paid and Cancel buttons. Marking it paid records the payment. See Payment Engine.
Bad post detector
The bad post detector is a Beta setting in Settings → Post rules. It checks each new TikTok post that a creator submits through Discord for your app and a valid call to action. Set the App name, an optional Discord alert channel and a Detector prompt. Type @ in the prompt to point at one of the reference images you uploaded. A post that fails shows in Needs you as Posts flagged for quality. You can skip or reject it. It does not check Instagram, YouTube or posts added in the dashboard.
Link your Discord account
Admin commands need your ViewsBase account to be linked to your Discord account.
- Open Account from the account menu.
- Choose Connect Discord.
- Approve in Discord.
Choose Disconnect on the same page to unlink.
FAQ
Why is /submit-post missing from the command list?
Check the creator's permissions in the ticket, even if an admin can use the command there:
- Confirm the creator has Use Application Commands through their role and that channel overrides do not block it.
- Confirm they can view the ticket and send messages there.
- In Server Settings → Integrations → ViewsBase, check that the app and
/submit-postare allowed for that creator and channel. - Reopen the command list and type
/submit-post.
Discord administrators bypass channel permission limits, so an admin's success does not prove a creator has access. The campaign's allowed-server list is checked after the command runs. It does not make a missing command appear.
See Discord's permission reference.
Can creators submit from DMs?
No. The bot works only in servers, because it needs the server to check the allowed list.
What if I remove a server from a campaign?
Existing posts stay. New submissions from that server for that campaign are refused.
Do I need to restart the bot?
No.