@darkwolf/telegram-bot NPM

Telegram Bot API

Install

npm i --save @darkwolf/telegram-bot

Using

import TelegramBot, {
  types,
  helper,
  errors,
  constants
} from '@darkwolf/telegram-bot'
const {
  InlineKeyboardMarkup,
  InlineKeyboardButton,
  InlineKeyboardPagination,
  InlineKeyboardCursorPagination,
  InputFile,
  InputMediaPhoto,
  MarkdownV2Text
} = types

const bot = new TelegramBot(token)
// Send message
// You can use both constructor and chain builder
const markup = new InlineKeyboardMarkup([
  [new InlineKeyboardButton('Ave', {callbackData: 'ave'})],
])
  .addButton(
    new InlineKeyboardButton()
      .setText('Darkwolf')
      .setCallbackData('darkwolf')
  )
  // Custom smart pagination
  .addPagination(
    new InlineKeyboardPagination({
      pageCount: dataConnection.pageInfo.pageCount, // 100
      pageNumber: dataConnection.pageInfo.pageNumber, // 69
      pageStep, // 1
      maxPageButtons: 7,
      onPageButtonCreate: (button, index, paginator, pagination) => button.setCallbackData(`data:page:${button.pageNumber}:step:${pagination.pageStep}`)
    })
    // ['• 1 •', '5', '10', '25']
    // ['«', '1...', '68', '• 69 •', '70', '...100', '»']
  )
  .addPagination(
    new InlineKeyboardPagination()
      .setMode('cursor')
      .setPageCount(dataConnection.pageInfo.pageCount)
      .setPageNumber(dataConnection.pageInfo.pageNumber)
      .setShowStepper(false)
      .onPageButtonCreate(button => button.setCallbackData(`data:page:${button.pageNumber}`))
    // ['« 1', '‹ 68', '• 69 •', '70 ›', '100 »']
  )
  // Cursor pagination
  .addPagination(
    new InlineKeyboardCursorPagination()
      .setHasPreviousPage(dataConnection.pageInfo.hasPreviousPage)
      .setHasNextPage(dataConnection.pageInfo.hasNextPage)
      .onPreviousPageButtonCreate(button => button.setCallbackData(`data:${dataConnection.pageInfo.startCursor}`))
      .onNextPageButtonCreate(button => button.setCallbackData(`data:${dataConnection.pageInfo.endCursor}`))
    // ['«', '»']
  )
const message = await bot.sendMessage(chatId, new MarkdownV2Text()
  .addTitle('Title')
  .addItem('ID', 1)
  .addItem('First Name', 'Pavel')
  .addItem('Last Name', 'Wolf')
  .addItem('Username', '@PavelWolfDark')
  .addText('Underscore line:')
  .addNewLine()
  .addUnderscoreLine()
  .addBoldText('Bold text')
  .addNewLine()
  .addItalicText('Italic text')
  .addNewLine()
  .addUnderlinedText('Underlined text')
  .addNewLine()
  .addUnderlinedItalicText('Underlined italic text')
  .addNewLine()
  .addStrikethroughText('Strikethrough text')
  .addNewLine()
  .addText(
    new MarkdownV2Text('Bold italic underlined strikethrough text')
      .makeBold()
      .makeUnderlineItalic()
      .makeStrikethrough()
  )
  .addNewLine()
  .addText('Dash line:')
  .addNewLine()
  .addDashLine()
  .addText('Inline code: ')
  .addInlineCode('Inline code')
  .addNewLine()
  .addCodeBlock('Code block')
  .addNewLine()
  .addCodeBlock('JavaScript code block', {language: 'javascript'})
  .addNewLine()
  .addText('Deep text link: ')
  .addTextLink('Pavel Wolf', 't.me/PavelWolfDark')
  .addNewLine()
  .addText('Escaped text: ')
  .addEscapedText('Ave, Darkwolf!')
  .addNewLine()
  .addText('Bullet line:')
  .addNewLine()
  .addBulletLine()
  .addText('List:')
  .addNewLine()
  .addList([
    'First',
    'Second',
    'Third',
    [
      'First',
      [
        'First'
      ]
    ]
  ])
  .addNewLine()
  .addText('Ordered list:')
  .addNewLine()
  .addOrderedList([
    'First',
    'Second',
    'Third',
    [
      'First',
      [
        'First'
      ]
    ]
  ]), {
  parseMode: constants.ParseMode.MARKDOWN_V2,
  replyMarkup: markup
})
// Send photo
const photo = new InputFile(fs.createReadStream('photo.jpeg'))
const message = await bot.sendPhoto(chatId, photo, {
  caption: 'Ave, Darkwolf!',
  parseMode: constants.ParseMode.MARKDOWN,
  replyMarkup: markup
})
// Upload photos
const messages = await bot.sendMediaGroup(chatId, [
  new InputMediaPhoto('attach://photo1'),
  new InputMediaPhoto()
    .setMedia('attach://photo2')
], {
  attachedFiles: [
    new InputFile(fs.createReadStream('photo1.jpeg'))
      .setAttachName('photo1'),
    new InputFile(fs.createReadStream('photo2.jpeg'))
      .setAttachName('photo2')
  ]
})
// You can also download uploaded photos from Telegram
const blobs = await Promise.all(
  messages.map(message => {
    const photo = message.photo[0]
    return photo.download()
  })
)