Build powerful bots

# 1. Go to https://collaborix.com/developers/apps
# 2. Click "Create New Application" → Select "Bot"
# 3. Give it a name, description, and avatar
# 4. Copy your Bot Token (keep it secret!)

# Your bot token looks like this:
# clx_bot_a1b2c3d4e5f6g7h8i9j0.AbCdEfGhIjKlMnOpQrStUvWxYz

# ⚠️ Never share your token or commit it to version control!
# Use environment variables instead.

# JavaScript / TypeScript
npm install @collaborix/sdk

# Python
pip install collaborix

# Go
go get github.com/collaborix/go-sdk

# Java (Gradle)
implementation 'com.collaborix:sdk:1.0.0'

# C# / .NET
dotnet add package Collaborix.SDK

# Rust
cargo add collaborix-sdk

import { CollaborixBot } from '@collaborix/sdk';

const bot = new CollaborixBot({
  token: process.env.BOT_TOKEN,
  intents: ['messages'],
});

// Register a slash command
bot.command('/hello', async (ctx) => {
  await ctx.reply({
    text: `👋 Hello, ${ctx.user.name}! I'm alive!`,
    ephemeral: true, // Only visible to the user who ran the command
  });
});

bot.start();
console.log('🤖 Bot is online!');

// Listen for new messages
bot.on('message.created', async (event) => {
  const { message, channel, author } = event;

  // Ignore messages from bots (including ourselves)
  if (author.bot) return;

  // Auto-respond to keywords
  if (message.content.toLowerCase().includes('help')) {
    await channel.send({
      text: '📚 Here are some things I can do:',
      embeds: [{
        title: 'Available Commands',
        description: [
          '`/hello` — Say hello',
          '`/poll` — Create a poll',
          '`/remind` — Set a reminder',
          '`/stats` — Channel statistics',
        ].join('\n'),
        color: '#7C3AED',
      }],
    });
  }
});

// Listen for reactions
bot.on('reaction.added', async (event) => {
  if (event.emoji === '⭐' && event.count >= 3) {
    // Pin messages with 3+ star reactions
    await event.message.pin();
  }
});

// Listen for new members
bot.on('member.joined', async (event) => {
  const welcomeChannel = await bot.channels.find(
    event.workspace.id,
    { name: 'welcome' }
  );

  if (welcomeChannel) {
    await welcomeChannel.send({
      text: `🎉 Welcome to the team, ${event.user.name}!`,
    });
  }
});

// Send a message with buttons
bot.command('/ticket', async (ctx) => {
  await ctx.reply({
    text: 'Create a support ticket:',
    components: [
      {
        type: 'action_row',
        components: [
          {
            type: 'select',
            custom_id: 'ticket_category',
            placeholder: 'Select category...',
            options: [
              { label: 'Bug Report', value: 'bug', emoji: '🐛' },
              { label: 'Feature Request', value: 'feature', emoji: '💡' },
              { label: 'Question', value: 'question', emoji: '❓' },
              { label: 'Other', value: 'other', emoji: '📝' },
            ],
          },
        ],
      },
      {
        type: 'action_row',
        components: [
          { type: 'button', label: 'Submit', style: 'primary', custom_id: 'ticket_submit' },
          { type: 'button', label: 'Cancel', style: 'secondary', custom_id: 'ticket_cancel' },
        ],
      },
    ],
  });
});

// Handle button click → open a modal
bot.action('ticket_submit', async (ctx) => {
  await ctx.openModal({
    title: 'New Support Ticket',
    custom_id: 'ticket_modal',
    fields: [
      {
        type: 'text',
        name: 'title',
        label: 'Ticket Title',
        placeholder: 'Brief description of the issue',
        required: true,
      },
      {
        type: 'textarea',
        name: 'description',
        label: 'Details',
        placeholder: 'Provide as much detail as possible...',
        required: true,
        max_length: 2000,
      },
      {
        type: 'select',
        name: 'priority',
        label: 'Priority',
        options: ['Low', 'Medium', 'High', 'Critical'],
      },
    ],
  });
});

// Handle modal submission
bot.modal('ticket_modal', async (ctx) => {
  const { title, description, priority } = ctx.fields;

  // Create a ticket channel
  const ticketChannel = await bot.channels.create(ctx.workspace.id, {
    name: `ticket-${Date.now()}`,
    type: 'text',
    private: true,
  });

  await ticketChannel.send({
    embeds: [{
      title: `🎫 ${title}`,
      description,
      color: priority === 'Critical' ? '#EF4444' : '#7C3AED',
      fields: [
        { name: 'Priority', value: priority, inline: true },
        { name: 'Reporter', value: ctx.user.name, inline: true },
        { name: 'Status', value: 'Open', inline: true },
      ],
    }],
  });

  await ctx.reply({
    text: `✅ Ticket created in #${ticketChannel.name}`,
    ephemeral: true,
  });
});

# Deploy options:
# 1. Any Node.js hosting (Railway, Render, Fly.io, AWS, etc.)
# 2. Docker container
# 3. Serverless (AWS Lambda, Cloudflare Workers)

# Example Dockerfile
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
CMD ["node", "bot.js"]

# Environment variables needed:
# BOT_TOKEN=clx_bot_your_token_here

# To publish to the Marketplace:
# 1. Go to Developer Portal → Your App → Settings
# 2. Add description, screenshots, and category
# 3. Click "Submit for Review"
# 4. Review takes 1-3 business days
# 5. Once approved, your bot is live! 🎉