Connecting TikTok

Connection Modes

VMSC supports two methods for receiving TikTok LIVE events:

Most users should start with Standalone mode. The TikFinity bridge is useful if you already use TikFinity for other integrations and want a single connection to TikTok.

Standalone Mode

This is the default and simplest connection method. VMSC connects directly to TikTok's LIVE WebSocket endpoint.

Setup

1. Open Settings from the sidebar
2. In the TikTok section, set Connection Mode to Standalone
3. Enter your TikTok username (without the @ symbol)
4. Click Save

Connecting

1. Start your TikTok LIVE stream from the TikTok app
2. In VMSC, click the Connect button on the dashboard (or it will auto-connect if the Live Checker is enabled)
3. The status indicator turns green when connected

Once connected, VMSC receives all stream events in real-time: gifts, likes, follows, shares, comments, and viewer joins.

Sign API Key

TikTok's LIVE API requires a signed connection token. VMSC uses the Eulerstream Sign API for this. By default, VMSC includes a built-in API key that works for most users.

If you encounter rate-limiting issues (especially during peak hours), you can obtain your own Sign API key:

1. Visit eulerstream.com and create an account
2. Generate an API key from your dashboard
3. In VMSC, go to Settings > TikTok > Sign API Key
4. Paste your personal key and click Save

TikFinity Bridge Mode

If you already run TikFinity alongside your stream, you can use it as a bridge instead of connecting VMSC directly. This avoids opening two separate connections to TikTok.

Prerequisites

• TikFinity installed and connected to your TikTok LIVE
• TikFinity's WebSocket server enabled (check TikFinity settings)
• VMSC Premium license

Configuration

1. Open Settings > TikTok in VMSC
2. Set Connection Mode to TikFinity
3. Enter the TikFinity WebSocket host and port:

{
  "tikfinityHost": "127.0.0.1",
  "tikfinityPort": 21213
}

The default port for TikFinity is 21213. Only change this if you have customized TikFinity's WebSocket settings.

4. Click Save, then click Connect
5. VMSC will connect to TikFinity's WebSocket and begin receiving events

Live Checker (Auto-Connect)

VMSC can automatically detect when your TikTok LIVE starts and connect without manual intervention. This is especially useful if you start your stream from mobile and want VMSC to begin processing events immediately.

Enabling the Live Checker

1. Go to Settings > TikTok
2. Toggle Live Checker to ON
3. Set the Poll Interval (default: 30 seconds)

When enabled, VMSC periodically checks whether your TikTok account is broadcasting. Once a live stream is detected, VMSC automatically initiates the connection. When the stream ends, VMSC disconnects gracefully and resumes polling.

Troubleshooting

If you are having trouble connecting to your TikTok LIVE, check the following common issues:

Connection Refused / Timeout

• Are you actually live? VMSC can only connect to an active LIVE stream. Make sure your stream is running on TikTok before clicking Connect.
• Check your username. The username must match exactly (case-insensitive, no @ prefix). Check for typos.
• Firewall or VPN. Some corporate firewalls or VPNs block WebSocket connections. Try disabling your VPN temporarily.

Rate Limited (429 Errors)

• The built-in Sign API key is shared across all free-tier users. During peak hours, you may hit rate limits.
• Solution: Get your own API key from eulerstream.com and enter it in Settings.
• Wait 60 seconds and try again — rate limits reset quickly.

Connected But No Events

• Check the Live Feed widget on the dashboard. If it shows "Connected" but no events appear, your stream may have very low activity. Try sending a gift from a second account to confirm.
• TikFinity bridge: Make sure TikFinity itself is receiving events. If TikFinity shows no events, the problem is upstream, not in VMSC.

Disconnects Frequently

• TikTok's LIVE WebSocket can be unstable during high-traffic periods. VMSC automatically reconnects after a brief delay.
• If reconnection fails repeatedly, restart VMSC and try connecting again.
• Check your internet connection stability. Packet loss or high latency can cause WebSocket drops.

Connection Status Indicators

The VMSC dashboard shows a real-time connection status badge in the sidebar:

Next Steps

Once you are connected to TikTok, you are ready to build out your stream integration:

• First Setup — Create your first rules and actions
• Rules & Actions — Full event type reference
• In-App Tutorial — Let V.I.T.R.O. walk you through everything