Skip to content

A NestJS Telegram module for using the Telegram Bot API

License

Notifications You must be signed in to change notification settings

xaosaki/nestjs-telegram

 
 

Repository files navigation

Nest Logoplus Telegram Logo

A NestJS service wrapper for Telegram bots!

Description

Telegram API wrapper for the Telegram Bots API made to work with the Nest framework.

Installation

$ npm install nestjs-telegram

Using the Module

// Inside of your module imports
@Module({
  imports: [TelegramModule.forRoot({
    botKey: 'YourBotApiToken'
  })]
})

// Or async
@Module({
  imports: [
    TelegramModule.forRootAsync({
      useFactory: async (configService: ConfigService) => {
        return { 
          botKey: configService.get('Telegram_API_Key')
        };
      inject: [ConfigService]
    })
  ],
})

In your service class you can inject the service like so and then use it in any function as you would any other service

@Injectable()
export class MyService {

  constructor(private readonly telegram: TelegramService) {}

  testBot(): Observable<Telegram.User> {
    return this.telegram.getMe();
  }
}

Currently, the service only returns Observables as the HttpModule does. If you want to use Promises just call .toPromise() on the function.

Support

If any bugs are found in the API wrapper, please open an issue on GitHub, or a Pull Request if you want to fix it yourself! Please be as explicit as possible and provide a minimum reproducing repository if at all possible, as it helps track down what went wrong.

Documentation

All documentation for this wrapper comes from the Telegram Bot API documentation, if there are any typos, please let me know or open a PR to fix it.

Todo

  • Implement Telegram Passport methods
  • Implement Telegram Inline mode options

Stay in touch

License

Nestjs-telegram is MIT licensed.

About

A NestJS Telegram module for using the Telegram Bot API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.5%
  • Other 0.5%