Getting Started

Create your first chat room and embed it on your website in under 5 minutes.

Quick Start

Create an Account

Sign in to the Dashboard using one of the offered sign-in providers. This creates your owner account and lets you manage rooms.

Create Your First Room

New hosts start at "Create your first room." Give the room a name, choose who can join, and select "Create Room." If you already have rooms, use "Create a new room" above the room list. The room count shows your plan limit.

Copy the Embed Code

Your room appears in "My Rooms." Use "Copy chat link" to invite your audience, or "Open Chat" to try it. To embed interactive chat, choose "Manage room," then "Copy embed." The resulting code has this form:

<iframe
  src="https://ninjachatter.com/index.html?room=YOUR_ROOM_ID"
  style="width:100%;height:500px;border:none;"
  allow="clipboard-write"
></iframe>

Paste into Your Website

Add the iframe code to your website, streaming page, or blog. The chat loads automatically. Viewers choose "Join Chat" and enter a display name if guests are allowed, or sign in with a provider enabled by the host.

The free tier includes 1 room with up to 100 concurrent viewers. Upgrade to Pro for more rooms and higher viewer limits.

Basic Customization

Room appearance and testing

Choose "Manage room" from the room list to change the room's appearance and join settings. Use "Save Changes" above the settings sections to apply your changes. Use "Test your room" to send a test message, and open the public chat in another browser tab to confirm it arrives.

The standard interactive chat link is:

https://ninjachatter.com/index.html?room=YOUR_ROOM_ID

For OBS/Streaming

Select "Copy OBS link" on the room card for the read-only display. Add its URL as a browser source in OBS or Streamlabs; viewers use the interactive chat link to send messages. The overlay URL has this form:

https://ninjachatter.com/overlay.html?room=YOUR_ROOM_ID

See the OBS Overlay Guide for detailed setup instructions.

Authentication Options

Configure how users join your chat:

Guests allowed - Anyone can join with a display name
Discord only - Require Discord authentication
Patreon only - Require Patreon authentication; configure campaign and tier requirements for a members-only room
Selected providers - Allow the Discord, Twitch, YouTube, Google, or Patreon identities you enable for the room

Requiring authentication helps with moderation since users have verified identities.

Moderation

Room owners and moderators can:

Ban users - Permanently remove a user from the room
Mute users - Prevent a user from sending messages (timed or permanent)
Stealth ban - User appears normal to themselves but messages aren't shown to others
Delete messages - Remove specific messages from the chat

Access moderation controls by clicking on a user's name in the chat or through "Manage room" → "Moderation" in the dashboard.

Next Steps

Set up OBS Overlay Integrate Webhooks Developer API