{"id":16302546,"url":"https://github.com/waptik/telegram-bot-boilerplate-now-serverless-api","last_synced_at":"2025-09-16T16:32:10.874Z","repository":{"id":98626501,"uuid":"263719457","full_name":"waptik/telegram-bot-boilerplate-now-serverless-api","owner":"waptik","description":"A template for building Telegram bots with Vercel's Serverless Functions","archived":false,"fork":false,"pushed_at":"2020-11-26T23:57:13.000Z","size":29,"stargazers_count":20,"open_issues_count":0,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-30T11:12:34.931Z","etag":null,"topics":["serverless-api","serverless-functions","telegraf","telegram-bot","vercel","vercel-now","vercel-serverless"],"latest_commit_sha":null,"homepage":"https://telegram-bot-boilerplate-now-serverless-api.now.sh","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waptik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-13T19:03:59.000Z","updated_at":"2024-11-04T17:48:46.000Z","dependencies_parsed_at":"2023-04-27T13:16:49.491Z","dependency_job_id":null,"html_url":"https://github.com/waptik/telegram-bot-boilerplate-now-serverless-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waptik%2Ftelegram-bot-boilerplate-now-serverless-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waptik%2Ftelegram-bot-boilerplate-now-serverless-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waptik%2Ftelegram-bot-boilerplate-now-serverless-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waptik%2Ftelegram-bot-boilerplate-now-serverless-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waptik","download_url":"https://codeload.github.com/waptik/telegram-bot-boilerplate-now-serverless-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233279918,"owners_count":18652242,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["serverless-api","serverless-functions","telegraf","telegram-bot","vercel","vercel-now","vercel-serverless"],"created_at":"2024-10-10T20:58:18.366Z","updated_at":"2025-09-16T16:32:05.592Z","avatar_url":"https://github.com/waptik.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Telegram Bot Boilerplate with Vercel's Serverless Functions\n======================\n\nThis template  is a fork of [Telegram Bot Boilerplate](https://github.com/yakovlevyuri/telegram-bot-boilerplate) framework to be used with [Vercel's Serverless Functions](https://vercel.com/docs/v2/serverless-functions/introduction). Easily deploy to [Vercel](https://vercel.com).\n\n## Deploy your own\n\nThe easiest way to get started is deploy using this template by clicking on the Deploy button below.\n\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/git/external?repository-url=https%3A%2F%2Fgithub.com%2Fwaptik%2Ftelegram-bot-boilerplate-now-serverless-api\u0026env=BOT_TOKEN,VERCEL_URL\u0026envDescription=Bot%20token%20and%20Vercel%20url\u0026envLink=https%3A%2F%2Fgithub.com%2Fwaptik%2Ftelegram-bot-boilerplate-now-serverless-api\u0026demo-title=Test%20Vercel's%20Serverless%20Functions\u0026demo-description=A%20telegram%20bot%20based%20on%20this%20source%20code\u0026demo-url=https%3A%2F%2Ft.me%2FVercelServerlessFunctionsBot\u0026project-name=telegram-bot-boilerplate-now-serverless-api\u0026repository-name=telegram-bot-boilerplate-now-serverless-api)\n\nAlternatively, if you want to make some changes before deploying it, you can fork this template and do the necessary changes you need. Then you when are done with your changes simply goto [vercel git import](https://vercel.com/import/git).\n\n## Notes\n\n- When importing a new project on vercel, you'll be asked to set the output directory. Set it to **dist** or the value inside [tsconfig.js](https://github.com/waptik/telegram-bot-boilerplate-now-serverless-api/blob/master/tsconfig.js#L4)\n- You also need to set Environment variables. Please note the wording in brackets mentioned below. Also here is a list of environment variables you need to set:\n - `BOT_TOKEN`: Its value should be the token you received from BitFather when creating your bot. (secret)\n - `VERCEL_URL`: set to the system populated value seen in the dropdown when you choose the system variables option. (system)\n\n\n##  Local development\n\n### Step 1. Clone the project locally\n\nYou can clone this template directly or the forked version you have.\n\n```bash\ngit clone https://github.com/waptik/telegram-bot-boilerplate-now-serverless-api.git\n\n# or\n\ngit clone https://github.com/\u003cYOUR_GITHUB_USERNAME\u003e/telegram-bot-boilerplate-now-serverless-api.git\n```\n\nNext, navigate to the cloned directory.\n```sh\ncd telegram-bot-boilerplate-now-serverless-api\n```\n\n### Step 2. Configuration\n\nCopy the `.env.example` file in this directory to `.env` (which will be ignored by Git):\n\n```bash\ncp .env.example .env\n```\n\nNext, copy your bot token you got from BotFather and and open `.env` to do the following changes.\n\n```bash\nBOT_TOKEN=\"\u003cYOUR_BOT_TOKEN\u003e\"\n```\n\n\u003e **Note:** We are not using `VERCEL_URL` here because we are in development mode as it's not needed.\n\n\n### Step 3. Run the bot in development mode\n\nMake sure you have [Vercel CLI](https://vercel.com/download) installed on your local machine.\n\n```bash\nnpm install\nnpm run dev\n\n# or\n\nyarn install\nyarn dev\n```\n\nYour app should be up and running! Send a message to your bot on telgram and you'll receive a reply instantly!\n\n### Step 4. Deploy on Vercel\nAfter you are done, simply do the the following.\nIf you cloned this template directly on your machine, you need set the origin. Read more on how to do that [Add a remote](https://github.com/git-guides/git-remote#common-git-remote-commands).\n\nAfter you are done or if you cloned the forked version, simply push to GitHub\n\n```bash\ngit push\n```\n\n\n## Demo\nYou can see a working version of the bot at  [@VercelServerlessFunctionsBot](https://t.me/VercelServerlessFunctionsBot)\n\n\n\nPull Requests are welcomed 😉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaptik%2Ftelegram-bot-boilerplate-now-serverless-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaptik%2Ftelegram-bot-boilerplate-now-serverless-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaptik%2Ftelegram-bot-boilerplate-now-serverless-api/lists"}