diff --git a/docs/components/reference.mdx b/docs/components/reference.mdx index c62fb32461..3aecc06bb2 100644 --- a/docs/components/reference.mdx +++ b/docs/components/reference.mdx @@ -432,9 +432,9 @@ String Selects are available in messages and modals. They must be placed inside ``` - + - When a user submits a modal that contains a StringSelect, this is the basic form of the interaction data payload you will receive. The full payload + When a user submits a modal that contains a String Select, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -646,9 +646,9 @@ User Selects are available in messages and modals. They must be placed inside an ``` - + - When a user interacts with a UserSelect in a message, this is the basic form of the interaction data payload you will receive. The full payload + When a user interacts with a User Select in a message, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. :::info @@ -681,7 +681,7 @@ User Selects are available in messages and modals. They must be placed inside an "permissions": "2248473465835073", "premium_since": null, "roles": [ - "2222222222222222222" + "2222222222222222222" ], "unusual_dm_activity_until": null } @@ -737,9 +737,9 @@ User Selects are available in messages and modals. They must be placed inside an ``` - + - When a user submits a modal that contains a UserSelect, this is the basic form of the interaction data payload you will receive. The full payload + When a user submits a modal that contains a User Select, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -886,9 +886,9 @@ Role Selects are available in messages and modals. They must be placed inside an ``` - + - When a user interacts with a RoleSelect in a message, this is the basic form of the interaction data payload you will receive. The full payload + When a user interacts with a Role Select in a message, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -960,9 +960,9 @@ Role Selects are available in messages and modals. They must be placed inside an ``` - + - When a user submits a modal that contains a RoleSelect, this is the basic form of the interaction data payload you will receive. The full payload + When a user submits a modal that contains a Role Select, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -1101,9 +1101,9 @@ Mentionable Selects are available in messages and modals. They must be placed in ``` - + - When a user interacts with a MentionableSelect in a message, this is the basic form of the interaction data payload you will receive. The full payload + When a user interacts with a Mentionable Select in a message, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. :::info @@ -1137,7 +1137,7 @@ Mentionable Selects are available in messages and modals. They must be placed in "permissions": "2248473465835073", "premium_since": null, "roles": [ - "2222222222222222222" + "2222222222222222222" ], "unusual_dm_activity_until": null } @@ -1213,9 +1213,9 @@ Mentionable Selects are available in messages and modals. They must be placed in ``` - + - When a user submits a modal that contains a MentionableSelect, this is the basic form of the interaction data payload you will receive. The full payload + When a user submits a modal that contains a Mentionable Select, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -1336,9 +1336,9 @@ Channel Selects are available in messages and modals. They must be placed inside ``` - + - When a user interacts with a ChannelSelect in a message, this is the basic form of the interaction data payload you will receive. The full payload + When a user interacts with a Channel Select in a message, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -1404,9 +1404,9 @@ Channel Selects are available in messages and modals. They must be placed inside ``` - + - When a user submits a modal that contains a ChannelSelect, this is the basic form of the interaction data payload you will receive. The full payload + When a user submits a modal that contains a Channel Select, this is the basic form of the interaction data payload you will receive. The full payload is available in the [interaction](/docs/interactions/receiving-and-responding#interaction-object-interaction-structure) reference. ```json @@ -1562,7 +1562,7 @@ To use this component in messages you must send the [message flag](/docs/resourc ###### Examples - + ![Example of a Text Display with markdown](images/components/text-display.webp) @@ -1975,7 +1975,7 @@ To use this component in messages you must send the [message flag](/docs/resourc A Label is a top-level layout component. Labels wrap modal components with text as a label and optional description. :::info -The `description` may display above or below the `component` depending on platform. +The `description` may display above or below the `component` depending on the platform. ::: ###### Label Structure @@ -2005,7 +2005,7 @@ The `description` may display above or below the `component` depending on platfo |-----------|----------------------------------------------------------------------------------------------------------------------------|-------------------------------------| | type | integer | `18` for a Label | | id | integer | Unique identifier for the component | -| component | [interaction response label child component](/docs/components/reference#label-label-interaction-response-child-components) | The component within the label | +| component | [label interaction response child component](/docs/components/reference#label-label-interaction-response-child-components) | The component within the label | ###### Label Interaction Response Child Components diff --git a/docs/interactions/receiving-and-responding.mdx b/docs/interactions/receiving-and-responding.mdx index 07b20a04b3..42dab8c8c6 100644 --- a/docs/interactions/receiving-and-responding.mdx +++ b/docs/interactions/receiving-and-responding.mdx @@ -163,7 +163,7 @@ If data for a Member is included, data for its corresponding User will also be i \* Partial `Member` objects are missing `user`, `deaf` and `mute` fields -\*\* Partial `Channel` objects only have `id`, `name`, `type` and `permissions` fields. Threads will also have `thread_metadata` and `parent_id` fields. +\*\* Partial `Channel` objects only have `id`, `name`, `type`, `permissions`, `last_message_id`, `last_pin_timestamp`, `nsfw`, `parent_id`, `guild_id`, `flags`, `rate_limit_per_user`, `topic` and `position` fields. Threads will also have the `thread_metadata` field. ###### Application Command Interaction Data Option Structure @@ -277,7 +277,7 @@ Not all message fields are currently supported. | attachments? \*\* | array of partial [attachment](/docs/resources/message#attachment-object) objects | Attachment objects with filename and description | | poll? | [poll](/docs/resources/poll#poll-create-request-object) request object | Details about the poll | -\* If you create a callback with the [type](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type) `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE` the only valid [message flag](/docs/resources/message#message-object-message-flags) you may use is `EPHEMERAL`. If you'd like to create a component based message with `IS_COMPONENTS_V2` you must do that with the [followup](/docs/interactions/receiving-and-responding#followup-messages) message, not this one. +\* If you create a callback with the [type](/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type) `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE` the only valid [message flag](/docs/resources/message#message-object-message-flags) you may use is `EPHEMERAL`. If you'd like to create a component based message with `IS_COMPONENTS_V2` you must do that with the [edit original response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) endpoint, not this one. \*\* See [Uploading Files](/docs/reference#uploading-files) for details. @@ -364,8 +364,8 @@ Interaction `tokens` are valid for **15 minutes** and can be used to send follow | type | integer | [Interaction type](/docs/interactions/receiving-and-responding#interaction-object-interaction-type) | | activity_instance_id? | string | Instance ID of the Activity if one was launched or joined | | response_message_id? | snowflake | ID of the message that was created by the interaction | -| response_message_loading? | boolean | Whether or not the message is in a loading state | -| response_message_ephemeral? | boolean | Whether or not the response message was ephemeral | +| response_message_loading? | boolean | Whether the message is in a loading state | +| response_message_ephemeral? | boolean | Whether the response message is ephemeral | ###### Interaction Callback Resource Object @@ -388,7 +388,7 @@ Interaction `tokens` are valid for **15 minutes** and can be used to send follow ## Followup Messages -Sometimes, your bot will want to send followup messages to a user after responding to an interaction. Or, you may want to edit your original response. Whether you receive Interactions over the gateway or by outgoing webhook, you can use the following endpoints to edit your initial response or send followup messages: +Sometimes, you want to send followup messages to a user after responding to an interaction. Or, you may want to edit your original response. Whether you receive Interactions over the gateway or by outgoing webhook, you can use the following endpoints to edit your initial response or send followup messages: - [`PATCH /webhooks///messages/@original`](/docs/interactions/receiving-and-responding#edit-original-interaction-response) to edit your initial response to an Interaction - [`DELETE /webhooks///messages/@original`](/docs/interactions/receiving-and-responding#delete-original-interaction-response) to delete your initial response to an Interaction @@ -445,7 +445,7 @@ Apps are limited to 5 followup messages per interaction if it was initiated from Create a followup message for an Interaction. Functions the same as [Execute Webhook](/docs/resources/webhook#execute-webhook), but `wait` is always true. The `thread_id`, `avatar_url`, and `username` parameters are not supported when using this endpoint for interaction followups. You can use the `EPHEMERAL` [message flag](/docs/resources/message#message-object-message-flags) `1 << 6` (64) to send a message that only the user can see. You can also use the `IS_COMPONENTS_V2` [message flag](/docs/resources/message#message-object-message-flags) `1 << 15` (32768) to send a [component](/docs/components/reference)-based message. -When using this endpoint directly after responding to an interaction with `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE`, this endpoint will function as [Edit Original Interaction Response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) for backwards compatibility. In this case, no new message will be created, and the loading message will be edited instead. The ephemeral flag will be ignored, and the value you provided in the initial defer response will be preserved, as an existing message's ephemeral state cannot be changed. This behavior is deprecated, and you should use the Edit Original Interaction Response endpoint in this case instead. +When using this endpoint directly after responding to an interaction with `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE`, this endpoint will function as [Edit Original Interaction Response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) for backwards compatibility. In this case, no new message will be created, and the loading message will be edited instead. The ephemeral flag will be ignored, and the value you provided in the initial defer response will be preserved, as an existing message's ephemeral state cannot be changed. This behavior is deprecated, and you should use the [Edit Original Interaction Response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) endpoint in this case instead. ## Get Followup Message /webhooks/[\{application.id\}](/docs/resources/application#application-object)/[\{interaction.token\}](/docs/interactions/receiving-and-responding#interaction-object)/messages/[\{message.id\}](/docs/resources/message#message-object)