Skip to content

GramIO API Reference / @gramio/contexts/dist / ChatControlMixin

Class: ChatControlMixin<Bot>

Defined in: contexts/index.d.ts:5094

This object represents a mixin that is responsible for all the chat management methods

Extends

Extended by

Type Parameters

Type Parameter
Bot extends BotLike

Constructors

Constructor

new ChatControlMixin<Bot>(): ChatControlMixin<Bot>

Returns

ChatControlMixin<Bot>

Inherited from

Context.constructor

Properties

PropertyModifierTypeInherited fromDefined in
botpublicBotContext.botcontexts/index.d.ts:4726
isTopicMessagepublic() => booleanNodeMixin.isTopicMessagecontexts/index.d.ts:4863
payloadpublicRecord<string, any>TargetMixin.payloadcontexts/index.d.ts:4740
update?publicTelegramUpdateContext.updatecontexts/index.d.ts:4728
updateId?publicnumberContext.updateIdcontexts/index.d.ts:4727
updateTypeprotectedUpdateNameContext.updateTypecontexts/index.d.ts:4729

Accessors

[toStringTag]

Get Signature

get [toStringTag](): string

Defined in: contexts/index.d.ts:4732

MDN

Returns

string

Inherited from

Context.[toStringTag]


businessConnectionId

Get Signature

get businessConnectionId(): string

Defined in: contexts/index.d.ts:4765

Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier.

Returns

string

Inherited from

TargetMixin.businessConnectionId


chat

Get Signature

get chat(): Chat

Defined in: contexts/index.d.ts:4759

Conversation the message belongs to

Returns

Chat

Inherited from

TargetMixin.chat


chatId

Get Signature

get chatId(): number

Defined in: contexts/index.d.ts:4763

Chat ID

Returns

number

Inherited from

TargetMixin.chatId


chatType

Get Signature

get chatType(): TelegramChatType

Defined in: contexts/index.d.ts:4767

Chat type

Returns

TelegramChatType

Inherited from

TargetMixin.chatType


from

Get Signature

get from(): User

Defined in: contexts/index.d.ts:4744

Sender, empty for messages sent to channels

Returns

User

Inherited from

TargetMixin.from


id

Get Signature

get id(): number

Defined in: contexts/index.d.ts:4944

Returns

number

Inherited from

NodeMixin.id


senderBoostCount

Get Signature

get senderBoostCount(): number

Defined in: contexts/index.d.ts:4757

Optional. If the sender of the message boosted the chat, the number of boosts added by the user

Returns

number

Inherited from

TargetMixin.senderBoostCount


senderChat

Get Signature

get senderChat(): Chat

Defined in: contexts/index.d.ts:4753

Sender of the message, sent on behalf of a chat. The channel itself for channel messages. The supergroup itself for messages from anonymous group administrators. The linked channel for messages automatically forwarded to the discussion group

Returns

Chat

Inherited from

TargetMixin.senderChat


senderId

Get Signature

get senderId(): number

Defined in: contexts/index.d.ts:4761

Sender's ID

Returns

number

Inherited from

TargetMixin.senderId


threadId

Get Signature

get threadId(): number

Defined in: contexts/index.d.ts:4862

Returns

number

Inherited from

NodeMixin.threadId

Methods

clearReactions()

clearReactions(params?): Promise<true>

Defined in: contexts/index.d.ts:5088

Clears reactions from the message

Parameters

ParameterType
params?Optional<SetMessageReactionParams, "chat_id" | "message_id">

Returns

Promise<true>

Inherited from

NodeMixin.clearReactions


copy()

copy(params?): Promise<MessageId>

Defined in: contexts/index.d.ts:5074

Copies current message [into other chat if chatId is provided]

Parameters

ParameterType
params?Optional<CopyMessageParams, "chat_id" | "message_id" | "from_chat_id">

Returns

Promise<MessageId>

Inherited from

NodeMixin.copy


copyMessages()

copyMessages(chatId, ids, params?): Promise<MessageId[]>

Defined in: contexts/index.d.ts:5076

Copies messages from current chat and sends to another

Parameters

ParameterType
chatIdstring | number
idsnumber[]
params?Optional<CopyMessagesParams, "chat_id" | "message_ids" | "from_chat_id">

Returns

Promise<MessageId[]>

Inherited from

NodeMixin.copyMessages


delete()

delete(params?): Promise<true>

Defined in: contexts/index.d.ts:5045

Deletes current message

Parameters

ParameterType
params?Optional<DeleteMessageParams, "chat_id" | "message_id">

Returns

Promise<true>

Inherited from

NodeMixin.delete


deleteChatStickerSet()

deleteChatStickerSet(params?): Promise<true>

Defined in: contexts/index.d.ts:5110

Deletes group stickerset

Parameters

ParameterType
params?Optional<DeleteChatStickerSetParams, "chat_id">

Returns

Promise<true>


deleteMessages()

deleteMessages(ids): Promise<true>

Defined in: contexts/index.d.ts:5047

Deletes messages in current chat

Parameters

ParameterType
idsnumber[]

Returns

Promise<true>

Inherited from

NodeMixin.deleteMessages


editCaption()

editCaption(caption, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5063

Edits current message caption. An alias for editMessageCaption

Parameters

ParameterType
captionNonNullable<string | { toString: string; }>
params?Partial<EditMessageCaptionParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editCaption


editChecklist()

editChecklist(checklist, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5064

Parameters

ParameterType
checklistTelegramInputChecklist
params?Partial<EditMessageChecklistParams>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.editChecklist


editLiveLocation()

editLiveLocation(params): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5051

Edits current message live location. An alias for editMessageLiveLocation

Parameters

ParameterType
paramsEditMessageLiveLocationParams

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editLiveLocation


editMedia()

editMedia(media, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5068

Edits current message media. An alias for editMessageMedia

Parameters

ParameterType
mediaTelegramInputMedia
params?Partial<EditMessageMediaParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMedia


editMessageCaption()

editMessageCaption(caption, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5061

Edits current message caption

Parameters

ParameterType
captionNonNullable<string | { toString: string; }>
params?Partial<EditMessageCaptionParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMessageCaption


editMessageLiveLocation()

editMessageLiveLocation(params): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5049

Edits current message live location

Parameters

ParameterType
paramsEditMessageLiveLocationParams

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMessageLiveLocation


editMessageMedia()

editMessageMedia(media, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5066

Edits current message media

Parameters

ParameterType
mediaTelegramInputMedia
params?Partial<EditMessageMediaParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMessageMedia


editMessageReplyMarkup()

editMessageReplyMarkup(replyMarkup, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5070

Edits current message reply markup

Parameters

ParameterType
replyMarkupTelegramInlineKeyboardMarkup | { toJSON: TelegramInlineKeyboardMarkup; }
params?Partial<EditMessageReplyMarkupParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMessageReplyMarkup


editMessageText()

editMessageText(text, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5057

Edits current message text

Parameters

ParameterType
textstring | { toString: string; }
params?Partial<EditMessageTextParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editMessageText


editReplyMarkup()

editReplyMarkup(replyMarkup, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5072

Edits current message reply markup. An alias for editMessageReplyMarkup

Parameters

ParameterType
replyMarkupTelegramInlineKeyboardMarkup | { toJSON: TelegramInlineKeyboardMarkup; }
params?Partial<EditMessageReplyMarkupParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editReplyMarkup


editText()

editText(text, params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5059

Edits current message text. An alias for editMessageText

Parameters

ParameterType
textstring | { toString: string; }
params?Partial<EditMessageTextParams>

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.editText


forward()

forward(params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5078

Forwards current message [into other chat if chatId is provided]

Parameters

ParameterType
params?Optional<ForwardMessageParams, "chat_id" | "message_id" | "from_chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.forward


forwardMessages()

forwardMessages(chatId, ids, params?): Promise<MessageId[]>

Defined in: contexts/index.d.ts:5080

Forwards messages from current chat to another

Parameters

ParameterType
chatIdstring | number
idsnumber[]
params?Optional<ForwardMessagesParams, "chat_id" | "message_ids" | "from_chat_id">

Returns

Promise<MessageId[]>

Inherited from

NodeMixin.forwardMessages


getChatBoosts()

getChatBoosts(userId): Promise<TelegramUserChatBoosts>

Defined in: contexts/index.d.ts:4938

Returns chat boosts by the user

Parameters

ParameterType
userIdnumber

Returns

Promise<TelegramUserChatBoosts>

Inherited from

NodeMixin.getChatBoosts


hasFrom()

hasFrom(): this is Require<ChatControlMixin<Bot>, "from" | "senderId">

Defined in: contexts/index.d.ts:4742

Checks if the instance has from and senderId properties

Returns

this is Require<ChatControlMixin<Bot>, "from" | "senderId">

Inherited from

TargetMixin.hasFrom


hasSenderChat()

hasSenderChat(): this is Require<ChatControlMixin<Bot>, "senderChat">

Defined in: contexts/index.d.ts:4746

Checks if the instance has senderChat property

Returns

this is Require<ChatControlMixin<Bot>, "senderChat">

Inherited from

TargetMixin.hasSenderChat


is()

is<T>(rawTypes): this is InstanceType<ContextsMapping<Bot>[T]> & Bot["__Derives"]["global"] & Bot["__Derives"][T] & (Bot["__Derives"] extends {} ? Bot["__Derives"]["global"] & Bot["__Derives"][T] : {})

Defined in: contexts/index.d.ts:4735

Type Parameters

Type Parameter
T extends UpdateName

Parameters

ParameterType
rawTypesMaybeArray<SoftString<T>>

Returns

this is InstanceType<ContextsMapping<Bot>[T]> & Bot["__Derives"]["global"] & Bot["__Derives"][T] & (Bot["__Derives"] extends {} ? Bot["__Derives"]["global"] & Bot["__Derives"][T] : {})

Inherited from

Context.is


isChannel()

isChannel(): this is RequireValue<ChatControlMixin<Bot>, "chatType", Channel>

Defined in: contexts/index.d.ts:4775

Is this chat a channel?

Returns

this is RequireValue<ChatControlMixin<Bot>, "chatType", Channel>

Inherited from

TargetMixin.isChannel


isGroup()

isGroup(): this is RequireValue<ChatControlMixin<Bot>, "chatType", Group>

Defined in: contexts/index.d.ts:4771

Is this chat a group?

Returns

this is RequireValue<ChatControlMixin<Bot>, "chatType", Group>

Inherited from

TargetMixin.isGroup


isPM()

isPM(): this is RequireValue<ChatControlMixin<Bot>, "chatType", Private>

Defined in: contexts/index.d.ts:4769

Is this chat a private one?

Returns

this is RequireValue<ChatControlMixin<Bot>, "chatType", Private>

Inherited from

TargetMixin.isPM


isSupergroup()

isSupergroup(): this is RequireValue<ChatControlMixin<Bot>, "chatType", Supergroup>

Defined in: contexts/index.d.ts:4773

Is this chat a supergroup?

Returns

this is RequireValue<ChatControlMixin<Bot>, "chatType", Supergroup>

Inherited from

TargetMixin.isSupergroup


quoteWithAnimation()

quoteWithAnimation(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5008

Replies to current message with a quote and an animation

Parameters

ParameterType
paramsobject & object & Pick<SendAnimationParams, "caption" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "show_caption_above_media" | "has_spoiler" | "thumbnail" | "duration" | "width" | "height"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithAnimation


quoteWithAudio()

quoteWithAudio(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5000

Replies to current message with a quote and an audio

Parameters

ParameterType
paramsobject & object & Pick<SendAudioParams, "caption" | "title" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "thumbnail" | "duration" | "performer"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithAudio


quoteWithContact()

quoteWithContact(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5033

Replies to current message with a quote and a contact

Parameters

ParameterType
paramsobject & Pick<SendContactParams, "phone_number" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "first_name" | "last_name" | "vcard"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithContact


quoteWithDice()

quoteWithDice(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5041

Replies to current message with a quote and a dice

Parameters

ParameterType
paramsobject & object & Partial<SendDiceParams> & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithDice


quoteWithDocument()

quoteWithDocument(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4996

Replies to current message with a quote and a document

Parameters

ParameterType
paramsobject & object & Pick<SendDocumentParams, "caption" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "thumbnail" | "disable_content_type_detection"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithDocument


quoteWithInvoice()

quoteWithInvoice(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5029

Replies to current message with a quote and an invoice

Parameters

ParameterType
paramsobject & Pick<SendInvoiceParams, "payload" | "currency" | "title" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "description" | "provider_token" | "prices" | "max_tip_amount" | "suggested_tip_amounts" | "start_parameter" | "provider_data" | "photo_url" | "photo_size" | "photo_width" | "photo_height" | "need_name" | "need_phone_number" | "need_email" | "need_shipping_address" | "send_phone_number_to_provider" | "send_email_to_provider" | "is_flexible"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithInvoice


quoteWithLocation()

quoteWithLocation(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5024

Replies to current message with a quote and a location

Parameters

ParameterType
paramsobject & object & Pick<SendLocationParams, "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "horizontal_accuracy" | "live_period" | "heading" | "proximity_alert_radius"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithLocation


quoteWithMediaGroup()

quoteWithMediaGroup(params): Promise<MessageContext<Bot>[]>

Defined in: contexts/index.d.ts:5020

Replies to current message with a quote and a media group

Parameters

ParameterType
paramsobject & object & Pick<SendMediaGroupParams, "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "reply_parameters"> & object & object

Returns

Promise<MessageContext<Bot>[]>

Inherited from

NodeMixin.quoteWithMediaGroup


quoteWithPhoto()

quoteWithPhoto(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4992

Replies to current message with a quote and a photo

Parameters

ParameterType
paramsobject & object & Pick<SendPhotoParams, "caption" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "show_caption_above_media" | "has_spoiler"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithPhoto


quoteWithPoll()

quoteWithPoll(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5035

Replies to current message with a quote and a poll

Parameters

ParameterType
paramsobject & Pick<SendPollParams, "question" | "options" | "type" | "explanation" | "business_connection_id" | "message_thread_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "reply_parameters" | "reply_markup" | "question_parse_mode" | "question_entities" | "is_anonymous" | "allows_multiple_answers" | "correct_option_id" | "explanation_parse_mode" | "explanation_entities" | "open_period" | "close_date" | "is_closed"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithPoll


quoteWithSticker()

quoteWithSticker(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5037

Replies to current message with a quote and a sticker

Parameters

ParameterType
paramsobject & object & Pick<SendStickerParams, "emoji" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithSticker


quoteWithVenue()

quoteWithVenue(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5031

Replies to current message with a quote and a venue

Parameters

ParameterType
paramsobject & Pick<SendVenueParams, "title" | "address" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "latitude" | "longitude" | "foursquare_id" | "foursquare_type" | "google_place_id" | "google_place_type"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithVenue


quoteWithVideo()

quoteWithVideo(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5004

Replies to current message with a quote and a video

Parameters

ParameterType
paramsobject & object & Pick<SendVideoParams, "caption" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "show_caption_above_media" | "has_spoiler" | "thumbnail" | "duration" | "width" | "height" | "cover" | "start_timestamp" | "supports_streaming"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithVideo


quoteWithVideoNote()

quoteWithVideoNote(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5012

Replies to current message with a quote and a video note

Parameters

ParameterType
paramsobject & object & Pick<SendVideoNoteParams, "length" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "thumbnail" | "duration"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithVideoNote


quoteWithVoice()

quoteWithVoice(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:5016

Replies to current message with a quote and a voice

Parameters

ParameterType
paramsobject & object & Pick<SendVoiceParams, "caption" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup" | "caption_entities" | "duration"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.quoteWithVoice


react()

react(rawReactions, params?): Promise<true>

Defined in: contexts/index.d.ts:5086

Reacts to a message

Parameters

ParameterType
rawReactionsMaybeArray<TelegramReactionTypeEmojiEmoji | TelegramReactionType>
params?Optional<SetMessageReactionParams, "chat_id" | "message_id">

Returns

Promise<true>

Inherited from

NodeMixin.react


removeChatPhoto()

removeChatPhoto(params?): Promise<true>

Defined in: contexts/index.d.ts:5102

Deletes a chat photo

Parameters

ParameterType
params?Optional<DeleteChatPhotoParams, "chat_id">

Returns

Promise<true>


reply()

reply(text, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4956

Replies to current message

Parameters

ParameterType
textstring | { toString: string; }
params?WithPartialReplyParameters<Optional<SendMessageParams, "text" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.reply


replyWithAnimation()

replyWithAnimation(animation, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4966

Replies to current message with animation

Parameters

ParameterType
animationstring | Blob
params?WithPartialReplyParameters<Optional<SendAnimationParams, "animation" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithAnimation


replyWithAudio()

replyWithAudio(audio, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4962

Replies to current message with audio

Parameters

ParameterType
audiostring | Blob
params?WithPartialReplyParameters<Optional<SendAudioParams, "audio" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithAudio


replyWithContact()

replyWithContact(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4980

Replies to current message with contact

Parameters

ParameterType
paramsWithPartialReplyParameters<Optional<SendContactParams, "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithContact


replyWithDice()

replyWithDice(emoji, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4986

Replies to current message with a dice

Parameters

ParameterType
emojiSendDiceEmoji
params?WithPartialReplyParameters<Partial<SendDiceParams>>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithDice


replyWithDocument()

replyWithDocument(document, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4960

Replies to current message with document

Parameters

ParameterType
documentstring | Blob
params?WithPartialReplyParameters<Optional<SendDocumentParams, "document" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithDocument


replyWithInvoice()

replyWithInvoice(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4976

Replies to current message with invoice

Parameters

ParameterType
paramsWithPartialReplyParameters<Optional<SendInvoiceParams, "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithInvoice


replyWithLocation()

replyWithLocation(latitude, longitude, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4974

Replies to current message with location

Parameters

ParameterType
latitudenumber
longitudenumber
params?WithPartialReplyParameters<Optional<SendLocationParams, "chat_id" | "latitude" | "longitude">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithLocation


replyWithMediaGroup()

replyWithMediaGroup(mediaGroup, params?): Promise<MessageContext<Bot>[]>

Defined in: contexts/index.d.ts:4972

Replies to current message with media group

Parameters

ParameterType
mediaGroup(TelegramInputMediaAudio | TelegramInputMediaDocument | TelegramInputMediaPhoto | TelegramInputMediaVideo)[]
params?WithPartialReplyParameters<Optional<SendMediaGroupParams, "chat_id" | "media">>

Returns

Promise<MessageContext<Bot>[]>

Inherited from

NodeMixin.replyWithMediaGroup


replyWithPhoto()

replyWithPhoto(photo, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4958

Replies to current message with photo

Parameters

ParameterType
photostring | Blob
params?WithPartialReplyParameters<Optional<SendPhotoParams, "photo" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithPhoto


replyWithPoll()

replyWithPoll(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4982

Replies to current message with poll

Parameters

ParameterType
paramsWithPartialReplyParameters<Optional<SendPollParams, "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithPoll


replyWithQuote()

replyWithQuote(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4988

Replies to current message with a quote

Parameters

ParameterType
paramsobject & object & Pick<SendMessageParams, "entities" | "business_connection_id" | "message_thread_id" | "direct_messages_topic_id" | "parse_mode" | "link_preview_options" | "disable_notification" | "protect_content" | "allow_paid_broadcast" | "message_effect_id" | "suggested_post_parameters" | "reply_parameters" | "reply_markup"> & object & object

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithQuote


replyWithSticker()

replyWithSticker(sticker, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4984

Replies to current message with sticker

Parameters

ParameterType
stickerstring | Blob
params?WithPartialReplyParameters<Optional<SendStickerParams, "sticker" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithSticker


replyWithVenue()

replyWithVenue(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4978

Replies to current message with venue

Parameters

ParameterType
paramsWithPartialReplyParameters<Optional<SendVenueParams, "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithVenue


replyWithVideo()

replyWithVideo(video, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4964

Replies to current message with video

Parameters

ParameterType
videostring | Blob
params?WithPartialReplyParameters<Optional<SendVideoParams, "video" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithVideo


replyWithVideoNote()

replyWithVideoNote(videoNote, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4968

Replies to current message with video note

Parameters

ParameterType
videoNotestring | Blob
params?WithPartialReplyParameters<Optional<SendVideoNoteParams, "video_note" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithVideoNote


replyWithVoice()

replyWithVoice(voice, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4970

Replies to current message with voice

Parameters

ParameterType
voicestring | Blob
params?WithPartialReplyParameters<Optional<SendVoiceParams, "voice" | "chat_id">>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.replyWithVoice


send()

send(text, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4868

Sends message to current chat

Parameters

ParameterType
textstring | { toString: string; }
params?Optional<SendMessageParams, "text" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.send


sendAnimation()

sendAnimation(animation, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4878

Sends animation to current chat

Parameters

ParameterType
animationstring | Blob
params?Optional<SendAnimationParams, "animation" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendAnimation


sendAudio()

sendAudio(audio, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4874

Sends audio to current chat

Parameters

ParameterType
audiostring | Blob
params?Optional<SendAudioParams, "audio" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendAudio


sendChatAction()

sendChatAction(action, params?): Promise<true>

Defined in: contexts/index.d.ts:4902

Sends chat action to current chat

Parameters

ParameterType
actionSendChatActionAction
params?Optional<SendChatActionParams, "chat_id" | "action">

Returns

Promise<true>

Inherited from

NodeMixin.sendChatAction


sendChecklist()

sendChecklist(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4894

Sends checklist to current chat

Parameters

ParameterType
paramsOptional<SendChecklistParams, "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendChecklist


sendContact()

sendContact(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4890

Sends contact to current chat

Parameters

ParameterType
paramsOptional<SendContactParams, "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendContact


sendDice()

sendDice(emoji, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4904

Sends dice

Parameters

ParameterType
emojiSendDiceEmoji
params?Partial<SendDiceParams>

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendDice


sendDocument()

sendDocument(document, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4872

Sends document to current chat

Parameters

ParameterType
documentstring | Blob
params?Optional<SendDocumentParams, "document" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendDocument


sendInvoice()

sendInvoice(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4886

Sends invoice to current user

Parameters

ParameterType
paramsOptional<SendInvoiceParams, "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendInvoice


sendLocation()

sendLocation(latitude, longitude, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4884

Sends location to current chat

Parameters

ParameterType
latitudenumber
longitudenumber
params?Optional<SendLocationParams, "chat_id" | "latitude" | "longitude">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendLocation


sendMedia()

sendMedia<T>(query): ReturnType<T extends "animation" ? (animation, params?) => Promise<MessageContext<Bot>> : T extends "audio" ? (audio, params?) => Promise<MessageContext<Bot>> : T extends "document" ? (document, params?) => Promise<MessageContext<Bot>> : T extends "photo" ? (photo, params?) => Promise<MessageContext<Bot>> : T extends "sticker" ? (sticker, params?) => Promise<MessageContext<Bot>> : T extends "video_note" ? (videoNote, params?) => Promise<MessageContext<Bot>> : T extends "video" ? (video, params?) => Promise<MessageContext<...>> : T extends "voice" ? (voice, params?) => Promise<...> : () => never>

Defined in: contexts/index.d.ts:4921

Automatically uses correct media method to send media

Type Parameters

Type Parameter
T extends string

Parameters

ParameterType
queryobject & tSendMethods

Returns

ReturnType<T extends "animation" ? (animation, params?) => Promise<MessageContext<Bot>> : T extends "audio" ? (audio, params?) => Promise<MessageContext<Bot>> : T extends "document" ? (document, params?) => Promise<MessageContext<Bot>> : T extends "photo" ? (photo, params?) => Promise<MessageContext<Bot>> : T extends "sticker" ? (sticker, params?) => Promise<MessageContext<Bot>> : T extends "video_note" ? (videoNote, params?) => Promise<MessageContext<Bot>> : T extends "video" ? (video, params?) => Promise<MessageContext<...>> : T extends "voice" ? (voice, params?) => Promise<...> : () => never>

Example

js
context.sendMedia({
  type: 'photo',
  photo: MediaUpload.path('./image.png'),
  caption: 'good image yes yes'
})

Inherited from

NodeMixin.sendMedia


sendMediaGroup()

sendMediaGroup(mediaGroup, params?): Promise<MessageContext<Bot>[]>

Defined in: contexts/index.d.ts:4908

Sends media group to current chat

Parameters

ParameterType
mediaGroup(TelegramInputMediaAudio | TelegramInputMediaDocument | TelegramInputMediaPhoto | TelegramInputMediaVideo)[]
params?Optional<SendMediaGroupParams, "chat_id" | "media">

Returns

Promise<MessageContext<Bot>[]>

Inherited from

NodeMixin.sendMediaGroup


sendMessageDraft()

sendMessageDraft(params): Promise<true>

Defined in: contexts/index.d.ts:4900

Sends a message draft to the current private chat

Parameters

ParameterType
paramsOptional<SendMessageDraftParams, "chat_id">

Returns

Promise<true>

Inherited from

NodeMixin.sendMessageDraft


sendPaidMedia()

sendPaidMedia(paidMedia, starCount, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4906

Sends paid media to current chat

Parameters

ParameterType
paidMediaTelegramInputPaidMedia[]
starCountnumber
params?Optional<SendPaidMediaParams, "chat_id" | "media" | "star_count">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendPaidMedia


sendPhoto()

sendPhoto(photo, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4870

Sends photo to current chat

Parameters

ParameterType
photostring | Blob
params?Optional<SendPhotoParams, "photo" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendPhoto


sendPoll()

sendPoll(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4892

Sends poll to current chat

Parameters

ParameterType
paramsOptional<SendPollParams, "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendPoll


sendSticker()

sendSticker(sticker, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4896

Sends sticker

Parameters

ParameterType
stickerstring | Blob
params?Optional<SendStickerParams, "sticker" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendSticker


sendVenue()

sendVenue(params): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4888

Sends venue to current chat

Parameters

ParameterType
paramsOptional<SendVenueParams, "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendVenue


sendVideo()

sendVideo(video, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4876

Sends video to current chat

Parameters

ParameterType
videostring | Blob
params?Optional<SendVideoParams, "video" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendVideo


sendVideoNote()

sendVideoNote(videoNote, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4880

Sends video note to current chat

Parameters

ParameterType
videoNotestring | Blob
params?Optional<SendVideoNoteParams, "video_note" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendVideoNote


sendVoice()

sendVoice(voice, params?): Promise<MessageContext<Bot>>

Defined in: contexts/index.d.ts:4882

Sends voice to current chat

Parameters

ParameterType
voicestring | Blob
params?Optional<SendVoiceParams, "voice" | "chat_id">

Returns

Promise<MessageContext<Bot>>

Inherited from

NodeMixin.sendVoice


setChatDefaultPermissions()

setChatDefaultPermissions(permissions, params?): Promise<true>

Defined in: contexts/index.d.ts:5098

Sets default chat permissions

Parameters

ParameterType
permissionsTelegramChatPermissions
params?Optional<SetChatPermissionsParams, "chat_id" | "permissions">

Returns

Promise<true>


setChatDescription()

setChatDescription(description, params?): Promise<true>

Defined in: contexts/index.d.ts:5106

Changes chat description

Parameters

ParameterType
descriptionstring
params?Optional<SetChatDescriptionParams, "chat_id" | "description">

Returns

Promise<true>


setChatPhoto()

setChatPhoto(photo, params?): Promise<true>

Defined in: contexts/index.d.ts:5100

Sets a new profile photo for the chat

Parameters

ParameterType
photoBlob
params?Optional<SetChatPhotoParams, "photo" | "chat_id">

Returns

Promise<true>


setChatStickerSet()

setChatStickerSet(name, params?): Promise<true>

Defined in: contexts/index.d.ts:5108

Sets new group stickerset

Parameters

ParameterType
namestring
params?Optional<SetChatStickerSetParams, "chat_id" | "sticker_set_name">

Returns

Promise<true>


setChatTitle()

setChatTitle(title, params?): Promise<true>

Defined in: contexts/index.d.ts:5104

Changes chat title

Parameters

ParameterType
titlestring
params?Optional<SetChatTitleParams, "title" | "chat_id">

Returns

Promise<true>


setCustomTitle()

setCustomTitle(title, params?): Promise<true>

Defined in: contexts/index.d.ts:5096

Sets a custom title

Parameters

ParameterType
titlestring
params?Optional<SetChatAdministratorCustomTitleParams, "chat_id" | "user_id">

Returns

Promise<true>


setReaction()

setReaction(reaction, params?): Promise<true>

Defined in: contexts/index.d.ts:5082

Sets a reaction on a message

Parameters

ParameterType
reactionTelegramReactionTypeEmojiEmoji | TelegramReactionType
params?Optional<SetMessageReactionParams, "chat_id" | "message_id">

Returns

Promise<true>

Inherited from

NodeMixin.setReaction


setReactions()

setReactions(rawReactions, params?): Promise<true>

Defined in: contexts/index.d.ts:5084

Sets multiple amount of reactions on a message

Parameters

ParameterType
rawReactions(TelegramReactionTypeEmojiEmoji | TelegramReactionType)[]
params?Optional<SetMessageReactionParams, "chat_id" | "message_id">

Returns

Promise<true>

Inherited from

NodeMixin.setReactions


stopLiveLocation()

stopLiveLocation(params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5055

Stops current message live location. An alias for stopMessageLiveLocation

Parameters

ParameterType
params?StopMessageLiveLocationParams

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.stopLiveLocation


stopMessageLiveLocation()

stopMessageLiveLocation(params?): Promise<true | MessageContext<Bot>>

Defined in: contexts/index.d.ts:5053

Stops current message live location

Parameters

ParameterType
params?StopMessageLiveLocationParams

Returns

Promise<true | MessageContext<Bot>>

Inherited from

NodeMixin.stopMessageLiveLocation


stopPoll()

stopPoll(messageId, params?): Promise<Poll>

Defined in: contexts/index.d.ts:4898

Stops poll in current chat

Parameters

ParameterType
messageIdnumber
params?Partial<StopPollParams>

Returns

Promise<Poll>

Inherited from

NodeMixin.stopPoll


streamMessage()

streamMessage(stream, options?): Promise<MessageContext<Bot>[]>

Defined in: contexts/index.d.ts:4936

Streams message drafts to the current chat, finalizing each completed draft as a sent message.

Accepts an Iterable or AsyncIterable of MessageDraftPiece (strings or objects with text+entities). Uses sendMessageDraft for live typing previews and sendMessage to finalize each 4096-char segment. Returns an array of sent MessageContext objects.

Parameters

ParameterType
streamIterable<MessageDraftPiece, any, any> | AsyncIterable<MessageDraftPiece, any, any>
options?StreamMessageOptions

Returns

Promise<MessageContext<Bot>[]>

Example

ts
// Stream from an async generator (e.g., LLM output)
const messages = await context.streamMessage(llmStream);

Inherited from

NodeMixin.streamMessage