Class BusinessConnection

constructor

• new BusinessConnection(client, data): BusinessConnection

• Parameters

  • client: TelegramClient | BaseClient

    The client that instantiated this
  • data: BusinessConnection

    Data about the connection of the bot with a business account

  Returns BusinessConnection

createdUnixTime

enabled

id

replyed

user

userChatId

createdAt

• get createdAt(): Date

• Date the connection was established

  Returns Date

createdTimestamp

• get createdTimestamp(): number

• Return the timestamp connection was established, in milliseconds

  Returns number

saveInlineMessage

• saveInlineMessage(result, options?): Promise<PreparedInlineMessage>

• Stores a message that can be sent by a user of a Mini App.

  Parameters

  • result: InlineQueryResult

    An object describing the message to be sent.
  • Optionaloptions: Omit<{
        allowBotChats?: boolean;
        allowChannelChats?: boolean;
        allowGroupChats?: boolean;
        allowUserChats?: boolean;
        result: InlineQueryResult;
        userId: string | number;
    }, "userId" | "result">

    out parameters.

  Returns Promise<PreparedInlineMessage>

  Returns a PreparedInlineMessage object.

send

• send(text, options?): Promise<Message & {
      content: string;
  }>

• Use this method to send text messages.

  Parameters

  • text: string

    Text of the message to be sent, 1-4096 characters after entities parsing and media group options
  • Optionaloptions: Omit<{
        businessConnectionId?: string;
        chatId: string | number;
        disableNotification?: boolean;
        entities?: MessageEntity[];
        linkPreviewOptions?: LinkPreviewOptions;
        messageEffectId?: string;
        messageThreadId?: string | number;
        parseMode?: ParseMode;
        protectContent?: boolean;
        replyMarkup?:
            | InlineKeyboardMarkup
            | ForceReply
            | ReplyKeyboardMarkup
            | ReplyKeyboardRemove;
        replyParameters?: ReplyParameters;
        text: string;
    }, "text" | "chatId">

    out parameters

  Returns Promise<Message & {
      content: string;
  }>

  On success, the sent Message is returned.
• send(text): Promise<(
      | Message & {
          audio: Audio;
      }
      | Message & {
          document: Document;
      }
      | Message & {
          photo: Photo;
      }
      | Message & {
          video: Video;
      })[]>

• Parameters

  • text: Omit<{
        businessConnectionId?: string;
        chatId: string | number;
        disableNotification?: boolean;
        media: readonly (
            | InputMediaAudio
            | InputMediaDocument
            | InputMediaPhoto
            | InputMediaVideo)[];
        messageEffectId?: string;
        messageThreadId?: string | number;
        protectContent?: boolean;
        replyParameters?: ReplyParameters;
    }, "chatId">

  Returns Promise<(
      | Message & {
          audio: Audio;
      }
      | Message & {
          document: Document;
      }
      | Message & {
          photo: Photo;
      }
      | Message & {
          video: Video;
      })[]>

• send(text, options?): Promise<Message & {
      content: string;
  } | (
      | Message & {
          audio: Audio;
      }
      | Message & {
          document: Document;
      }
      | Message & {
          photo: Photo;
      }
      | Message & {
          video: Video;
      })[]>

• Parameters

  • text: string | Omit<{
        businessConnectionId?: string;
        chatId: string | number;
        disableNotification?: boolean;
        media: readonly (
            | InputMediaAudio
            | InputMediaDocument
            | InputMediaPhoto
            | InputMediaVideo)[];
        messageEffectId?: string;
        messageThreadId?: string | number;
        protectContent?: boolean;
        replyParameters?: ReplyParameters;
    }, "chatId">
  • Optionaloptions: Omit<{
        businessConnectionId?: string;
        chatId: string | number;
        disableNotification?: boolean;
        entities?: MessageEntity[];
        linkPreviewOptions?: LinkPreviewOptions;
        messageEffectId?: string;
        messageThreadId?: string | number;
        parseMode?: ParseMode;
        protectContent?: boolean;
        replyMarkup?:
            | InlineKeyboardMarkup
            | ForceReply
            | ReplyKeyboardMarkup
            | ReplyKeyboardRemove;
        replyParameters?: ReplyParameters;
        text: string;
    }, "text" | "chatId">

  Returns Promise<Message & {
      content: string;
  } | (
      | Message & {
          audio: Audio;
      }
      | Message & {
          document: Document;
      }
      | Message & {
          photo: Photo;
      }
      | Message & {
          video: Video;
      })[]>

sendGift

• sendGift(giftId, options?): Promise<true>

• Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user.

  Parameters

  • giftId: string

    Identifier of the gift.
  • Optionaloptions: Omit<{
        giftId: string;
        text?: string;
        textEntities?: MessageEntity[];
        textParseMode?: ParseMode;
        userId: string | number;
    }, "giftId" | "userId">

    out parameters.

  Returns Promise<true>

  Returns True on success.

setEmojiStatus

• setEmojiStatus(options?): Promise<true>

• Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess.

  Parameters

  • Optionaloptions: {
        emojiStatusCustomEmojiId?: string;
        emojiStatusExpirationDate?: number;
    }

    out parameters.

    • OptionalemojiStatusCustomEmojiId?: string

      Custom emoji identifier of the emoji status to set. Pass an empty string to remove the status.

    • OptionalemojiStatusExpirationDate?: number

      Expiration date of the emoji status, if any

  Returns Promise<true>

  Returns True on success.

setStarSubscription

• setStarSubscription(telegramPaymentChargeId, isCanceled): Promise<true>

• Allows the bot to cancel or re-enable extension of a subscription paid in Telegram Stars.

  Parameters

  • telegramPaymentChargeId: string

    Telegram payment identifier for the subscription.
  • isCanceled: boolean

    Pass True to cancel extension of the user subscription; the subscription must be active up to the end of the current subscription period. Pass False to allow the user to re-enable a subscription that was previously canceled by the bot.

  Returns Promise<true>

  Returns True on success.