Context

discord_http.context module

class discord_http.context.Context(bot: Client, data: dict)[source]

Bases: object

property channel: BaseChannel | PartialChannel | None

Returns the channel the interaction was made in

Type:

BaseChannel | PartialChannel

property channel_type: ChannelType

ChannelType Returns the type of the channel

property cooldown: Cooldown | None

Optional[Cooldown] Returns the context cooldown

async create_followup_response(content: str | None = <MISSING>, *, embed: ~discord_http.embeds.Embed | None = <MISSING>, embeds: list[~discord_http.embeds.Embed] | None = <MISSING>, file: ~discord_http.file.File | None = <MISSING>, files: list[~discord_http.file.File] | None = <MISSING>, ephemeral: bool | None = False, view: ~discord_http.view.View | None = <MISSING>, tts: bool | None = False, type: ~discord_http.enums.ResponseType | int = 4, allowed_mentions: ~discord_http.mentions.AllowedMentions | None = <MISSING>, poll: ~discord_http.message.Poll | None = <MISSING>, flags: ~discord_http.flags.MessageFlags | None = <MISSING>, delete_after: float | None = None) → WebhookMessage[source]

Creates a new followup response to the interaction

Do not use this to create a followup response when defer was called before. Use edit_original_response instead.

Parameters:

  • content (Optional[str]) – Content of the message

  • embed (Optional[Embed]) – Embed of the message

  • embeds (Optional[list[Embed]]) – Embeds of the message

  • file (Optional[File]) – File of the message

  • files (Optional[Union[list[File], File]]) – Files of the message

  • ephemeral (bool) – Whether the message should be sent as ephemeral

  • view (Optional[View]) – Components of the message

  • type (Optional[ResponseType]) – Which type of response should be sent

  • allowed_mentions (Optional[AllowedMentions]) – Allowed mentions of the message

  • wait (bool) – Whether to wait for the message to be sent

  • thread_id (Optional[int]) – Thread ID to send the message to

  • poll (Optional[Poll]) – Poll to send with the message

  • flags (Optional[MessageFlags]) – Flags of the message

  • delete_after (Optional[float]) – How long to wait before deleting the message

Returns:

Returns the message that was sent

Return type:

Message

property created_at: datetime

datetime Returns the time the interaction was created

async delete_original_response() → None[source]

Delete the original response to the interaction

async edit_original_response(*, content: str | None = <MISSING>, embed: ~discord_http.embeds.Embed | None = <MISSING>, embeds: list[~discord_http.embeds.Embed] | None = <MISSING>, view: ~discord_http.view.View | None = <MISSING>, attachment: ~discord_http.file.File | None = <MISSING>, attachments: list[~discord_http.file.File] | None = <MISSING>, allowed_mentions: ~discord_http.mentions.AllowedMentions | None = <MISSING>) → WebhookMessage[source]

Message Edit the original response to the interaction

property expires_at: datetime

datetime Returns the time the interaction expires

property guild: Guild | PartialGuild | None

Returns the guild the interaction was made in If you are using gateway cache, it can return full object too

Type:

Guild | PartialGuild | None

is_expired() → bool[source]

bool Returns whether the interaction is expired

async original_response() → WebhookMessage[source]

Message Fetch the original response to the interaction

property response: InteractionResponse

InteractionResponse Returns the response to the interaction

async send(content: str | None = <MISSING>, *, embed: ~discord_http.embeds.Embed | None = <MISSING>, embeds: list[~discord_http.embeds.Embed] | None = <MISSING>, file: ~discord_http.file.File | None = <MISSING>, files: list[~discord_http.file.File] | None = <MISSING>, ephemeral: bool | None = False, view: ~discord_http.view.View | None = <MISSING>, tts: bool | None = False, type: ~discord_http.enums.ResponseType | int = 4, allowed_mentions: ~discord_http.mentions.AllowedMentions | None = <MISSING>, poll: ~discord_http.message.Poll | None = <MISSING>, flags: ~discord_http.flags.MessageFlags | None = <MISSING>, delete_after: float | None = None) → WebhookMessage[source]

Send a message after responding with an empty response in the initial interaction

Parameters:

  • content (Optional[str]) – Content of the message

  • embed (Optional[Embed]) – Embed of the message

  • embeds (Optional[list[Embed]]) – Embeds of the message

  • file (Optional[File]) – File of the message

  • files (Optional[Union[list[File], File]]) – Files of the message

  • ephemeral (bool) – Whether the message should be sent as ephemeral

  • view (Optional[View]) – Components of the message

  • type (Optional[ResponseType]) – Which type of response should be sent

  • allowed_mentions (Optional[AllowedMentions]) – Allowed mentions of the message

  • wait (bool) – Whether to wait for the message to be sent

  • thread_id (Optional[int]) – Thread ID to send the message to

  • poll (Optional[Poll]) – Poll to send with the message

  • flags (Optional[MessageFlags]) – Flags of the message

  • delete_after (Optional[float]) – How long to wait before deleting the message

Returns:

Returns the message that was sent

Return type:

Message

class discord_http.context.InteractionResponse(parent: Context)[source]

Bases: object

defer(ephemeral: bool = False, thinking: bool = False, flags: ~discord_http.flags.MessageFlags | None = <MISSING>, call_after: ~typing.Callable | None = None) → DeferResponse[source]

Defer the response to the interaction

Parameters:

  • ephemeral (bool) – If the response should be ephemeral (show only to the user)

  • thinking (bool) – If the response should show the “thinking” status

  • flags (Optional[int]) – The flags of the message (overrides ephemeral)

  • call_after (Optional[Callable]) – A coroutine to run after the response is sent

Returns:

The response to the interaction

Return type:

DeferResponse

Raises:

TypeError – If call_after is not a coroutine

edit_message(*, content: str | None = <MISSING>, embed: ~discord_http.embeds.Embed | None = <MISSING>, embeds: list[~discord_http.embeds.Embed] | None = <MISSING>, view: ~discord_http.view.View | None = <MISSING>, attachment: ~discord_http.file.File | None = <MISSING>, attachments: list[~discord_http.file.File] | None = <MISSING>, allowed_mentions: ~discord_http.mentions.AllowedMentions | None = <MISSING>, flags: ~discord_http.flags.MessageFlags | None = <MISSING>, call_after: ~typing.Callable | None = None) → MessageResponse[source]

Edit the original message of the interaction

Parameters:

  • content (Optional[str]) – Content of the message

  • embed (Optional[Embed]) – Embed to edit the message with

  • embeds (Optional[list[Embed]]) – Multiple embeds to edit the message with

  • view (Optional[View]) – Components to include in the message

  • attachment (Optional[File]) – New file to edit the message with

  • attachments (Optional[Union[list[File], File]]) – Multiple new files to edit the message with

  • allowed_mentions (Optional[AllowedMentions]) – Allowed mentions for the message

  • flags (Optional[int]) – The flags of the message

  • call_after (Optional[Callable]) – A coroutine to run after the response is sent

Returns:

The response to the interaction

Return type:

MessageResponse

Raises:

  • ValueError –

    • If both embed and embeds are passed - If both attachment and attachments are passed

  • TypeError – If call_after is not a coroutine

pong() → dict[source]

Only used to acknowledge a ping from Discord Developer portal Interaction URL

send_autocomplete(choices: dict[Any, str]) → AutocompleteResponse[source]

Send an autocomplete response to the interaction

Parameters:

choices (dict[Union[str, int, float], str]) – The choices to send

Returns:

The response to the interaction

Return type:

AutocompleteResponse

Raises:

TypeError –

  • If choices is not a dict - If choices is not a dict[Union[str, int, float], str]

send_empty(*, call_after: Callable | None = None) → EmptyResponse[source]

Send an empty response to the interaction

Parameters:

call_after (Optional[Callable]) – A coroutine to run after the response is sent

Returns:

The response to the interaction

Return type:

EmptyResponse

send_message(content: str | None = <MISSING>, *, embed: ~discord_http.embeds.Embed | None = <MISSING>, embeds: list[~discord_http.embeds.Embed] | None = <MISSING>, file: ~discord_http.file.File | None = <MISSING>, files: list[~discord_http.file.File] | None = <MISSING>, ephemeral: bool | None = False, view: ~discord_http.view.View | None = <MISSING>, tts: bool | None = False, type: ~discord_http.enums.ResponseType | int = 4, allowed_mentions: ~discord_http.mentions.AllowedMentions | None = <MISSING>, poll: ~discord_http.message.Poll | None = <MISSING>, flags: ~discord_http.flags.MessageFlags | None = <MISSING>, call_after: ~typing.Callable | None = None) → MessageResponse[source]

Send a message to the interaction

Parameters:

  • content (Optional[str]) – Content of the message

  • embed (Optional[Embed]) – The embed to send

  • embeds (Optional[list[Embed]]) – Multiple embeds to send

  • file (Optional[File]) – A file to send

  • files (Optional[Union[list[File], File]]) – Multiple files to send

  • ephemeral (bool) – If the message should be ephemeral (show only to the user)

  • view (Optional[View]) – Components to include in the message

  • tts (bool) – Whether the message should be sent using text-to-speech

  • type (Optional[ResponseType]) – The type of response to send

  • allowed_mentions (Optional[AllowedMentions]) – Allowed mentions for the message

  • flags (Optional[int]) – The flags of the message (overrides ephemeral)

  • call_after (Optional[Callable]) – A coroutine to run after the response is sent

Returns:

The response to the interaction

Return type:

MessageResponse

Raises:

  • ValueError –

    • If both embed and embeds are passed - If both file and files are passed

  • TypeError – If call_after is not a coroutine

send_modal(modal: Modal, *, call_after: Callable | None = None) → ModalResponse[source]

Send a modal to the interaction

Parameters:

  • modal (Modal) – The modal to send

  • call_after (Optional[Callable]) – A coroutine to run after the response is sent

Returns:

The response to the interaction

Return type:

ModalResponse

Raises:

TypeError –

  • If modal is not a Modal instance - If call_after is not a coroutine