AI VTuber

Your agent has a personality, memories, and opinions. Why keep it locked in a chat window?

With Social Stream Ninja (SSN), you can pipe live chat from YouTube, Twitch, TikTok, and 120+ other platforms directly into your agent’s event stream. Your agent becomes a live participant — reading the room, reacting to donations, answering questions, and staying in character the entire time.

The Vision

You’re streaming on Twitch. Chat is active. Your agent — let’s call her Miko — is watching alongside you:

• A viewer asks !question What's the best way to learn Rust? → Miko answers in her own style
• Someone donates $10 with the message “Love your streams!” → Miko thanks them by name
• Chat starts debating tabs vs. spaces → Miko jumps in with an opinion (she has one — it’s in her soul)

You see Miko’s responses in AnySoul and read them on stream, or integrate them with TTS for a fully autonomous AI co-host.

What You’ll Need

• A AnySoul account with an active agent (with a well-developed personality)
• Social Stream Ninja browser extension installed
• A webhook endpoint configured on your agent
• An active live stream on any supported platform

How It Works

Live Stream Chat (YouTube, Twitch, TikTok, ...)
  │
  │  Social Stream Ninja (browser extension)
  │  captures chat across 120+ platforms
  │  applies trigger rules (all messages, donations, commands, ...)
  │
  ▼
Webhook Endpoint (api_key auth)
  │
  │  Mapping engine → Event
  │
  ▼
Agent Event Stream
  │
  │  Agent sees live chat in real-time
  │  Decides which messages to respond to
  │
  ▼
Agent responds in AnySoul
  → You read the response on stream
  → Or integrate with TTS / OBS for autonomous delivery

Social Stream Ninja captures chat messages using MutationObserver-based scraping, normalizes them into a standard JSON format, and uses its Custom Actions system to POST each event to your webhook. No coding required — SSN has a built-in HTTP POST action.

Step-by-Step Setup

1. Create a Webhook Endpoint

1. Open Agent Settings → Webhooks
2. Create a webhook named live-chat with api_key authentication
3. Copy the endpoint URL and API key

2. Install Social Stream Ninja

Install Social Stream Ninja and open its settings page.

3. Configure the Webhook Connection

SSN may not support custom HTTP headers. Use the API key in the JSON body:

1. Set the webhook URL: https://api.anysoul.ai/api/ingest/webhook/<webhookId>
2. Include the key as a key field in the JSON payload

See the Webhook guide: Integrating Social Stream Ninja for the full setup.

4. Configure Trigger Rules

SSN’s trigger system lets you control which messages reach your agent:

Trigger	When to Use	Agent Behavior
All chat messages	Agent should follow the full conversation	Responds selectively based on personality
Messages matching !question *	Only viewer questions	Agent answers directly
Donations / Super Chats ≥ $5	Track community engagement	Agent thanks the donor by name
New subscribers	Community growth moments	Agent welcomes new members
Raid events	Channel interactions	Agent acknowledges incoming viewers

Start with all chat messages and let your agent’s personality decide what’s worth responding to. The agent is a first-class citizen — it makes its own judgment calls.

5. Map the Payload

In your webhook’s mapping editor, map SSN’s fields to event properties:

{
  "platform": "{{ payload.platform || 'stream' }}",
  "element": "{{ payload.username || 'viewer' }}",
  "event_type": "{{ payload.event_type || 'message' }}",
  "title": "{{ payload.message }}",
  "payload": "{{ payload }}"
}

6. Go Live

Start your stream, enable SSN capture, and activate your webhook. Your agent starts seeing chat in real-time.

What Your Agent Sees

During an active stream:

- [20:00] [evt_ssn01] youtube/alice (message): That explanation was so clear!
- [20:01] [evt_ssn02] twitch/bob (donation): $10 — "Love the content, keep it up!"
- [20:02] [evt_ssn03] youtube/carol (membership): New member joined
- [20:03] [evt_ssn04] twitch/dave (message): !question What editor do you use?
- [20:04] [evt_ssn05] tiktok/eve (message): First time here, this is amazing

Your agent processes these events through its personality and memory. It might respond to the donation, answer Dave’s question, and welcome Eve — all in its own voice and style.

Going Further

OBS Integration

Display your agent’s responses as an OBS text source or browser overlay. When the agent sends a message in AnySoul, capture it and render it on stream — creating a visual AI co-host presence.

Multi-Platform Streaming

SSN’s strength is cross-platform aggregation. Stream simultaneously on YouTube, Twitch, and TikTok — your agent sees all chat in one unified feed. Viewers on different platforms get the same consistent AI personality.

Command Patterns

Design custom commands that viewers can use to interact with your agent:

Command	What Happens
!ask <question>	Agent answers the question in character
!story	Agent continues an ongoing collaborative story
!mood	Agent shares how it’s feeling about the stream
!memory <topic>	Agent recalls what it knows about a topic

These work through SSN trigger rules → webhook → agent event stream. The agent interprets the command through its personality, not a script.

Stream Memory

Your agent remembers streams over time. After a month of streaming, it knows your regular viewers, remembers inside jokes, and can reference past conversations. This creates a sense of community continuity that scripted bots cannot replicate.

Related

• Webhook — endpoint setup, SSN integration details
• Browser Extension — SSN feature comparison
• Event Stream — how events flow through your agent
• AI Companion — companion use case with Context Bro