Class BusinessConnection

constructor

• new BusinessConnection(
      client: TelegramClient | BaseClient,
      data: BusinessConnection,
  ): 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

removeVerification

• removeVerification(): Promise<true>

• Removes verification from a user who is currently verified on behalf of the organization represented by the bot.

  Returns Promise<true>

  Returns True on success.

saveInlineMessage

• saveInlineMessage(
      result: InlineQueryResult,
      options?: Omit<
          {
              allowBotChats?: boolean;
              allowChannelChats?: boolean;
              allowGroupChats?: boolean;
              allowUserChats?: boolean;
              result: InlineQueryResult;
              userId: string
              | number;
          },
          "userId"
          | "result",
      >,
  ): 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: string,
      options?: 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",
      >,
  ): 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: Omit<
          {
              businessConnectionId?: string;
              chatId: string
              | number;
              disableNotification?: boolean;
              media: readonly (
                  | InputMediaAudio
                  | InputMediaDocument
                  | InputMediaPhoto
                  | InputMediaVideo
              )[];
              messageEffectId?: string;
              messageThreadId?: string
              | number;
              protectContent?: boolean;
              replyParameters?: ReplyParameters;
          },
          "chatId",
      >,
  ): Promise<
      (
          | Message & { audio: Audio }
          | Message & { document: Document }
          | Message & { photo: Photo }
          | Message & { video: Video }
      )[],
  >

• Use this method to send text messages.

  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",
    >

    Text of the message to be sent, 1-4096 characters after entities parsing and media group options

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

  On success, the sent Message is returned.
• send(
      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",
          >,
      options?: 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",
      >,
  ): Promise<
      | Message & { content: string }
      | (
          | Message & { audio: Audio }
          | Message & { document: Document }
          | Message & { photo: Photo }
          | Message & { video: Video }
      )[],
  >

• Use this method to send text messages.

  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",
        >

    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 }
      | (
          | Message & { audio: Audio }
          | Message & { document: Document }
          | Message & { photo: Photo }
          | Message & { video: Video }
      )[],
  >

  On success, the sent Message is returned.

sendGift

• sendGift(
      giftId: string,
      options?: Omit<
          {
              giftId: string;
              pay_for_upgrade?: boolean;
              text?: string;
              textEntities?: MessageEntity[];
              textParseMode?: ParseMode;
              userId: string
              | number;
          },
          "giftId"
          | "userId",
      >,
  ): 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;
            pay_for_upgrade?: boolean;
            text?: string;
            textEntities?: MessageEntity[];
            textParseMode?: ParseMode;
            userId: string
            | number;
        },
        "giftId"
        | "userId",
    >

    out parameters.

  Returns Promise<true>

  Returns True on success.

setEmojiStatus

• setEmojiStatus(
      options?: {
          emojiStatusCustomEmojiId?: string;
          emojiStatusExpirationDate?: number;
      },
  ): 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: string,
      isCanceled: boolean,
  ): 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.

verify

• verify(description?: string): Promise<true>

• Verifies a user on behalf of the organization which is represented by the bot.

  Parameters

  • Optionaldescription: string

    Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description.

  Returns Promise<true>

  Returns True on success.