Skip to content

Commit 28c781d

Browse files
advaith1advaith1
authored
Clarify defer followup backwards compatibility (#7091)
1 parent 76fc733 commit 28c781d

File tree

2 files changed

+18
-18
lines changed

2 files changed

+18
-18
lines changed

‎docs/interactions/Receiving_and_Responding.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -404,9 +404,9 @@ Deletes the initial Interaction response. Returns `204 No Content` on success.
404404
> info
405405
> Apps are limited to 5 followup messages per interaction if it was initiated from a user-installed app and isn't installed in the server (meaning the [authorizing integration owners object](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/interaction-object-authorizing-integration-owners-object) only contains `USER_INSTALL`)
406406
407-
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.
407+
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.
408408

409-
`flags` can be set to `64` to mark the message as ephemeral, except when it is the first followup message to a deferred Interactions Response. In that case, the `flags` field will be ignored, and the ephemerality of the message will be determined by the `flags` value in your original ACK.
409+
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.
410410

411411
## Get Followup Message % GET /webhooks/\{application.id#DOCS_RESOURCES_APPLICATION/application-object\}/\{interaction.token#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/interaction-object\}/messages/\{message.id#DOCS_RESOURCES_CHANNEL/message-object\}
412412

‎docs/resources/Webhook.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -193,22 +193,22 @@ Refer to [Uploading Files](#DOCS_REFERENCE/uploading-files) for details on attac
193193

194194
###### JSON/Form Params
195195

196-
| Field | Type | Description | Required |
197-
|-------------------|--------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
198-
| content | string | the message contents (up to 2000 characters) | one of content, file, embeds, poll |
199-
| username | string | override the default username of the webhook | false |
200-
| avatar_url | string | override the default avatar of the webhook | false |
201-
| tts | boolean | true if this is a TTS message | false |
202-
| embeds | array of up to 10 [embed](#DOCS_RESOURCES_MESSAGE/embed-object) objects | embedded `rich` content | one of content, file, embeds, poll |
203-
| allowed_mentions | [allowed mention object](#DOCS_RESOURCES_MESSAGE/allowed-mentions-object) | allowed mentions for the message | false |
204-
| components \* | array of [message component](#DOCS_INTERACTIONS_MESSAGE_COMPONENTS/component-object) | the components to include with the message | false |
205-
| files[n] \*\* | file contents | the contents of the file being sent | one of content, file, embeds, poll |
206-
| payload_json \*\* | string | JSON encoded body of non-file params | `multipart/form-data` only |
207-
| attachments \*\* | array of partial [attachment](#DOCS_RESOURCES_MESSAGE/attachment-object) objects | attachment objects with filename and description | false |
208-
| flags | integer | [message flags](#DOCS_RESOURCES_MESSAGE/message-object-message-flags) combined as a [bitfield](https://en.wikipedia.org/wiki/Bit_field) (only `SUPPRESS_EMBEDS` and `SUPPRESS_NOTIFICATIONS` can be set can be set) | false |
209-
| thread_name | string | name of thread to create (requires the webhook channel to be a forum or media channel) | false |
210-
| applied_tags | array of snowflakes | array of tag ids to apply to the thread (requires the webhook channel to be a forum or media channel) | false |
211-
| poll | [poll](#DOCS_RESOURCES_POLL/poll-create-request-object) request object | A poll! | one of content, file, embeds, poll |
196+
| Field | Type | Description | Required |
197+
|-------------------|--------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
198+
| content | string | the message contents (up to 2000 characters) | one of content, file, embeds, poll |
199+
| username | string | override the default username of the webhook | false |
200+
| avatar_url | string | override the default avatar of the webhook | false |
201+
| tts | boolean | true if this is a TTS message | false |
202+
| embeds | array of up to 10 [embed](#DOCS_RESOURCES_MESSAGE/embed-object) objects | embedded `rich` content | one of content, file, embeds, poll |
203+
| allowed_mentions | [allowed mention object](#DOCS_RESOURCES_MESSAGE/allowed-mentions-object) | allowed mentions for the message | false |
204+
| components \* | array of [message component](#DOCS_INTERACTIONS_MESSAGE_COMPONENTS/component-object) | the components to include with the message | false |
205+
| files[n] \*\* | file contents | the contents of the file being sent | one of content, file, embeds, poll |
206+
| payload_json \*\* | string | JSON encoded body of non-file params | `multipart/form-data` only |
207+
| attachments \*\* | array of partial [attachment](#DOCS_RESOURCES_MESSAGE/attachment-object) objects | attachment objects with filename and description | false |
208+
| flags | integer | [message flags](#DOCS_RESOURCES_MESSAGE/message-object-message-flags) combined as a [bitfield](https://en.wikipedia.org/wiki/Bit_field) (only `SUPPRESS_EMBEDS` and `SUPPRESS_NOTIFICATIONS` can be set) | false |
209+
| thread_name | string | name of thread to create (requires the webhook channel to be a forum or media channel) | false |
210+
| applied_tags | array of snowflakes | array of tag ids to apply to the thread (requires the webhook channel to be a forum or media channel) | false |
211+
| poll | [poll](#DOCS_RESOURCES_POLL/poll-create-request-object) request object | A poll! | one of content, file, embeds, poll |
212212

213213

214214
\* Requires an application-owned webhook.

0 commit comments

Comments
 (0)