Quick Start

// Send an image with caption
bot.command("image", async (ctx) => {
  await ctx.replyWithImage("https://example.com/image.jpg", {
    caption: "Here's your image!"
  });
});

// Send a video
bot.command("video", async (ctx) => {
  await ctx.replyWithVideo("https://example.com/video.mp4", {
    caption: "Check out this video"
  });
});

// Send an audio file
bot.command("audio", async (ctx) => {
  await ctx.replyWithAudio("https://example.com/audio.mp3");
});

bot.command("tiktok", async (ctx) => {
  const links = ctx.links.filter((v) => 
    /https?:\/\/(www|vt|vm|t)?\.?tiktok\.com\/\S+/.test(v)
  );
  
  if (!links.length) {
    await ctx.reply("> No valid TikTok link was detected in the message.");
    return;
  }
  
  await ctx.reply(`> Processing ${links.length} TikTok links.`);
  
  for (const link of links) {
    const response = await fetch(`https://www.tikwm.com/api?url=${link}`);
    const { data } = await response.json();
    
    if (!data.play && !data.images?.length) {
      await ctx.reply(`> Could not retrieve link information '${link}'`);
      continue;
    }
    
    if (data.images?.length) {
      for (let index = 0; index < data.images.length; index++) {
        const imageUrl = data.images[index];
        if (!index) {
          await ctx.replyWithImage(imageUrl, { 
            caption: `> *Title:* ${data.title}` 
          });
        } else {
          await ctx.replyWithImage(imageUrl);
        }
      }
    } else {
      await ctx.replyWithVideo(data.play, { 
        caption: `> *Title:* ${data.title}` 
      });
    }
  }
});

// Log all messages
bot.use(async (ctx, next) => {
  bot.logger.info(`Message from ${ctx.from.name}`);
  await next(); // Continue to next middleware/command
});

// Only allow messages from groups
bot.use(async (ctx, next) => {
  if (ctx.chat.type !== "group") {
    await ctx.reply("This bot only works in groups!");
    return; // Stop execution
  }
  await next();
});

// Add a custom property to context
bot.use(async (ctx, next) => {
  ctx.timestamp = Date.now();
  await next();
});

ctx.text          // Message text content
ctx.args          // Command arguments as array
ctx.links         // Extracted URLs from message
ctx.hasMedia      // Boolean - message has media
ctx.hasQuoted     // Boolean - message quotes another
ctx.isGroup       // Boolean - message is from group

ctx.from.name     // Sender's name
ctx.from.pn       // Sender's phone number
ctx.from.jid      // Sender's JID

ctx.chat.name     // Chat name (contact or group)
ctx.chat.type     // "private" or "group"
ctx.chat.jid      // Chat JID

await ctx.reply("text")                          // Send text
await ctx.replyWithImage(url, { caption })      // Send image
await ctx.replyWithVideo(url, { caption })      // Send video
await ctx.replyWithAudio(url)                    // Send audio

bot.on("qr", async (qr) => {
  // Handle QR code for authentication
});

bot.on("otp", (otp) => {
  // Handle OTP code for authentication
});

bot.on("open", (account) => {
  // Bot successfully connected
  console.log(`Logged in as ${account.name}`);
});

bot.on("close", (reason) => {
  // Bot disconnected
  console.log(`Disconnected: ${reason}`);
});

bot.on("error", (err) => {
  // Handle errors
  console.error("Bot error:", err);
});