Channels

Connecting Channels

ZoarkBot supports Telegram as the primary control channel. Additional channels (LinkedIn, YouTube, Twitter/X, Gmail) are automated outreach and content channels — you control them through Telegram or Mission Control.

Active

Telegram is the primary channel for controlling ZoarkBot. You send commands, approve content, and receive status updates through your Telegram bot.

To set up Telegram, see Getting Started. Once you have your bot token, configure it in ~/.zoarkbot/zoarkbot.json:

~/.zoarkbot/zoarkbot.json — Telegram config

{
  channels: {
    telegram: {
      // Your bot token from @BotFather
      token: "1234567890:ABCdef...",

      // Only these users can trigger the bot (use @username or numeric ID)
      allowFrom: ["your_username"],

      // Group chat settings
      groups: {
        // In groups, require @mention to avoid bot spam
        "*": { requireMention: true }
      }
    }
  }
}

What you can do via Telegram

Send commands to any agent (Zero, Zorro, Zara, etc.)
Approve content drafts before they are posted
Get status updates and notifications from agents
Start and stop automated tasks
Review agent activity logs

LinkedIn (Ziggy)

Active

Ziggy is ZoarkBot's LinkedIn agent. Once connected, Ziggy can automate LinkedIn outreach, draft DMs, post content, and manage connection requests — all with your approval.

What Ziggy can do

Draft and send LinkedIn DMs with human-like pacing
Post articles, updates, and thought leadership content
Manage connection request queues
Track DM response rates and optimize templates
Rate-limited to 10 DMs/day and 5 new connections/day for safety

Connecting LinkedIn

LinkedIn requires an OAuth token. To connect your account:

# Message Zero via Telegram: Connect LinkedIn

Zero will send you a secure link to authorize the connection. Tokens are stored locally — LinkedIn credentials never leave your server.

Approval required

By default, all DMs require your approval before sending. Reply "approve [name]" or "approve all" via Telegram to confirm.

YouTube (Zelda)

Active

Zelda automates your YouTube content pipeline. On a daily schedule, Zelda generates video scripts, creates visuals, builds the video, and uploads it to your channel.

What Zelda can do

Generate video scripts using Claude AI
Create voiceover audio using EdgeTTS (no additional cost)
Generate thumbnail images using Pollinations.ai FLUX
Assemble MP4 videos using FFmpeg
Upload to YouTube automatically on your schedule
Schedule: 6am content generation, 9am upload (configurable)

Requirements

YouTube requires the YouTube Data API v3 enabled in your Google Cloud Console. Contact support for setup help.

Twitter / X (Zeke)

Active

Zeke handles your Twitter/X presence — posting threads, replying to relevant conversations, and growing your audience on autopilot.

What Zeke can do

Draft and post tweets and threads
Schedule posts at optimal times
Monitor mentions and relevant keywords
Reply to targeted conversations
Track follower growth and engagement metrics

Twitter/X requires API keys (Twitter Developer account). Configure them through Mission Control or by messaging Zero via Telegram.

Gmail / Email (Zephyr)

Active

Zephyr manages email outreach and inbox monitoring via Gmail. It can draft cold outreach, follow-up sequences, and reply to inbound leads.

What Zephyr can do

Draft and send outreach emails
Manage follow-up sequences
Monitor inbox for replies from priority contacts
Route leads to Telegram for your review
Track open rates and reply rates

Gmail requires OAuth authorization. Connect it through Mission Control at mc.zoarkai.org.

Reddit (Zion)

Coming soon

Reddit automation is in development. Zion will monitor subreddits, participate in discussions, and post content on your behalf.

Credentials required: Reddit developer account. Available in a future update.

Instagram (Zayla)

Coming soon

Instagram automation is in development. Zayla will post content and manage engagement once the Facebook Business API connection is established.

Requirement: A Facebook Business account with an Instagram Business profile connected. Personal Instagram accounts are not supported by the API.