telegraf-docs

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #golang #android #rust #deep-learning #linux #windows #awesome #cli #pytorch #ios

(★ 341)

Documentation for Telegraf - the modern Bot API framework

파일 탐색기

최종 버전 다운로드 (.zip)

- settings.json
- logo.svg
- - google-cloud-function.ts
- - direct-link-mini-app.ts
  - inline-keyboard-button-mini-app.ts
  - inline-mode-mini-app.ts
  - keyboard-button-mini-app.ts
  - menu-button-mini-app.ts
  - README.md
- - echo-bot.ts
  - hello-bot.ts
- - scenes-with-custom-context-and-scene-session.ts
  - scenes-with-custom-context-and-session-and-scene-session.ts
  - scenes-with-custom-context-and-session.ts
  - scenes-with-custom-context.ts
  - scenes-with-custom-scene-session.ts
  - scenes.ts
- - express.ts
  - fastify.ts
  - koa.ts
  - webhook.ts
- - wizard-with-custom-context-and-scene-session.ts
  - wizard-with-custom-context-and-session-and-scene-session.ts
  - wizard-with-custom-context-and-session.ts
  - wizard-with-custom-context.ts
  - wizard-with-custom-scene-session.ts
  - wizard.ts
- custom-context-bot.ts
- deeplink-bot.ts
- download-bot.ts
- echo-bot.ts
- example-bot.ts
- game-bot.ts
- inline-bot.ts
- keyboard-bot.ts
- live-location-bot.ts
- login-bot.ts
- media-bot.ts
- poll-bot.ts
- proxy-bot.ts
- session-bot.ts
- shop-bot.ts
- - fmt.jpg
- 000-introduction.md
- 001-your-first-bot.md
- 002-listen-and-respond.md
- broadcasting.md
- context-shapes-overview.md
- formatting.md
- session.md
.gitignore
.prettierrc
global.d.ts
LICENSE
package.json
pnpm-lock.yaml
README.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Telegraf docs

This repo will house the future of Telegraf's documentation. For now, it houses bot examples.

### [![New](https://img.shields.io/badge/new%20✨-8A2BE2?style=flat-square) Build Telegram Mini Apps with Telegraf](https://raw.githubusercontent.com/feathers-studio/telegraf-docs/master/examples/mini-apps/README.md)

## How to use these examples:

In the interest of brevity, the examples in the repo don't explain certain good-to-haves.

### Graceful stop

On NodeJS, to make sure connections are gracefully closed before process is killed, you can use the `process.once` hooks. This is safe to add to the end of your bot's entry file.

```TS
process.once("SIGINT", () => bot.stop("SIGINT"));
process.once("SIGTERM", () => bot.stop("SIGTERM"));
```

### Secrets

This section talks about how to pass variables like token, port, webhook domain to the bot.

The recommendation is to pass them via environment variables and not directly include them in code. This is especially true for sensitive secrets such as token. This should probably be added before calling `new Telegraf()`.

```TS
// default to port 3000 if PORT is not set
const port = Number(process.env.PORT) || 3000;

// assert and refuse to start bot if token or webhookDomain is not passed
if (!process.env.BOT_TOKEN) throw new Error('"BOT_TOKEN" env var is required!');
if (!process.env.WEBHOOK_DOMAIN) throw new Error('"WEBHOOK_DOMAIN" env var is required!');
```

> **Important note**: Only use the vars needed for your bot. If you don't use webhooks, you don't need WEBHOOK_DOMAIN or the corresponding assertion.

Different deployment methods may have their own ways to pass environment variables. If you deploy to a Function-as-a-Service host such as Heroku, Netlify, AWS Lambda, GCP Functions, use the platform-specific way to set the correct environment variables.

If you use a conventional server, you can use the npm package `"dotenv"` to load vars from an `.env` file. Place this file in root and <u><b>DO NOT FORGET</b></u> to add this file to `.gitignore` (or you may leak credentials on the internet):

```yaml
# .env
PORT=3000
WEBHOOK_DOMAIN=bot.example.com
BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
```

telegraf-docs

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

telegraf-docs

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README