biliarchiverbot

Using Docker

docker run -d \
  --name biliarchiverbot \
  -p 5173:5173 \
  -e BILIARCHIVER_WEBAPP={THE_DEPLOYED_WEBAPP_URL}\
  -e BILIARCHIVER_USERNAME={THE_TELEGRAM_USERNAME_OF_BILIARCHIVER_BOT}\
  -e BILIARCHIVER_API={THE_API_URL_OF_BILIARCHIVER}\
  -e BILIARCHIVER_BOT={YOUR_BOT_TOKEN}\
  --restart always \
  ghcr.io/saveweb/biliarchiverbot:latest

If you have public IP, you can set the bot's webhook to your IP address.

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=<YOUR_IP_ADDRESS>:5173/bot/webhook

If you don't have public IP, you can use ngrok to expose your local server to the internet, or use any other tunneling service. Caddy and Nginx are also good choices.

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=<TUNNELING_URL>/bot/webhook

Deploy to Vercel

May have some issues with complicated bot commands, sometimes might not work as expected.

1. fork this repository

2. open vercel.com and create a new project

3. connect the project to your forked repository

4. set the environment variables.

   If you don't have a bot yet, you can create one by talking to @BotFather on Telegram.

   If you don't know the deployed URL, you can deploy the project first and then set the environment variables later.

    BILIARCHIVER_WEBAPP=<THE_DEPLOYED_WEBAPP_URL>
    BILIARCHIVER_USERNAME=<THE_TELEGRAM_USERNAME_OF_BILIARCHIVER_BOT>
    BILIARCHIVER_API=<THE_API_URL_OF_BILIARCHIVER>
    BILIARCHIVER_BOT=<YOUR_BOT_TOKEN>

5. deploy

6. set the bot's webhook to the deployed URL. You can copy the link below and replace your bot's token and the deployed URL.

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=<DEPLOY_URL>/bot/webhook

Local Development

1. clone this repository

2. install the dependencies

   pnpm install

3. create a .env file and set the environment variables.

    BILIARCHIVER_WEBAPP=<THE_DEPLOYED_WEBAPP_URL>
    BILIARCHIVER_USERNAME=<THE_TELEGRAM_USERNAME_OF_BILIARCHIVER_BOT>
    BILIARCHIVER_API=<THE_API_URL_OF_BILIARCHIVER>
    BILIARCHIVER_BOT=<YOUR_BOT_TOKEN>

4. start the development server

    pnpm dev

5. set the bot's webhook to the deployed URL.

   You may use ngrok to expose your local server to the internet, or open the port 5173 on your router or the VPS. Then you can copy the link below and replace your bot's token and the deployed URL.

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=<DEPLOY_URL>/bot/webhook