Quick Start

1 — Create a bot

Open Telegram, message @BotFather, and run /newbot. Choose a bot name and username, then copy the bot token BotFather returns.

2 — Connect it to NxCreator

Open your NxCreator dashboard, choose Add Bot, and paste the token. This creates the project and connects the managed runtime to your Telegram bot.

3 — Write your first handler

bot.command('start', (ctx) => {
  ctx.reply('Hello ' + ctx.from.first_name + '! Welcome to NxCreator.');
});

bot.on('message', (ctx) => {
  ctx.reply('You said: ' + ctx.message.text);
});

4 — Test it

Save the code, open the bot chat in Telegram, and send /start. Then send a regular message to confirm your general message handler is working too.

If /start 12345 style parameters matter for your flow, split the incoming message and read the extra arguments from ctx.message.text.

bot.command('start', async (ctx) => {
  const args = ctx.message.text.split(' ').slice(1);

  if (args.length > 0) {
    await ctx.reply('Referral ID: ' + args[0]);
    return;
  }

  await ctx.reply('Welcome! No referral ID provided.');
});

How did this page feel?

Quick feedback helps improve the docs.