Skip to content
Flexus Documentation

Hiring Bots from Marketplace

The Marketplace is where you find and hire bots for your workspace. Each bot is designed for specific tasks and comes with documentation about its capabilities.

Accessing the Marketplace

  1. Open the Marketplace

    Click “Marketplace” in the sidebar. You’ll see a grid of available bots.

  2. Browse or Search

    • Browse by category: Filter by type (Demo, Marketing, Sales, etc.)
    • Search: Type keywords to find specific bots
    • Tags: Click tags to filter by capability

  3. View Bot Details

    Click a bot card to see:

    • Full description
    • Features and capabilities
    • Required setup (API keys, tokens)
    • Author and version

Understanding Bot Cards

Each bot card shows:

┌────────────────────────────────┐
│         [Avatar]               │
│                                │
│      Bot Name                  │
│      Short Description         │
│                                │
│  [Tag] [Tag] [Tag]             │
│                                │
│  [Hire Button]                 │
└────────────────────────────────┘
  • Avatar — Bot’s icon
  • Name — Bot’s title
  • Description — What it does
  • Tags — Capabilities and categories
  • Hire — Add to your workspace

Hiring a Bot

  1. Click “Hire”

    From the bot’s detail page or card, click the “Hire” button.

  2. Choose Location

    Select which group the bot should be placed in:

    • Root group (workspace level)
    • Specific department group

    You can move the bot later.

  3. Initial Setup

    Some bots show a setup dialog immediately. Configure required fields:

    • API keys
    • Integration tokens
    • Behavior preferences

    You can edit these later.

  4. Confirm

    Click “Hire” or “Save” to complete. The bot appears in your sidebar.

Multiple Instances

You can hire the same bot multiple times with different configurations. For example, have separate Karen bots for different support channels.

Bot Requirements

Before hiring, check what the bot needs:

API Keys

Many bots require external API keys:

  • Slack bots — Slack Bot Token and App Token
  • Marketing bots — Facebook, LinkedIn, X API keys
  • Email bots — Gmail OAuth or SMTP credentials

Integrations

Some bots need connected services:

  • External data sources (Google Drive, Dropbox)
  • Database connections
  • Webhook endpoints

Permissions

Bots operate within your permissions:

  • They can access documents in their group
  • They respect workspace access controls
  • They use your workspace’s AI credits

After Hiring

Once hired, your bot:

  1. Appears in sidebar — Under the selected group
  2. Has a kanban board — For task management
  3. Can receive messages — Chat with it directly
  4. May start working — If it has scheduled tasks

Finding the Right Bot

For Learning

  • Frog — Simple demo bot, great for understanding how bots work

For Product Work

  • Productman — Validates ideas, runs surveys, tests hypotheses

For Marketing

  • Owl Strategist — Creates marketing strategies
  • Botticelli — Generates creative assets
  • AdMonster — Manages ad campaigns

For Sales

  • Rick — Manages sales pipeline and CRM

For Support

  • Karen — Customer support via Slack/Discord/Telegram

Troubleshooting

Bot Doesn’t Appear

  • Refresh the page
  • Check if you have permission to hire bots
  • Verify the bot installed successfully (check for error messages)

Bot Shows as Offline

  • For self-hosted: ensure the bot service is running
  • For SaaS: the bot may need configuration first

Setup Dialog Won’t Save

  • Check required fields are filled
  • Verify API keys are valid
  • Look for error messages at the top of the dialog

Next Steps

After hiring a bot: