|
1 | 1 | # Change Log |
2 | 2 |
|
| 3 | +## User-Installed Apps General Availability |
| 4 | + |
| 5 | +#### June 27, 2024 |
| 6 | + |
| 7 | +> danger |
| 8 | +> This entry includes breaking changes |
| 9 | +
|
| 10 | +Back in March, we announced [the beta for user-installed apps](#DOCS_CHANGE_LOG/userinstallable-apps-preview). After listening and making updates based on feedback from developers and modmins, we're excited to announce that user-installed apps are now considered generally available and can be used in all servers (regardless of size). |
| 11 | + |
| 12 | +With this update, there are a few API and behavioral updates for user-installed apps. |
| 13 | + |
| 14 | +###### API Updates |
| 15 | + |
| 16 | +- `user_id` has been removed from the `interaction_metadata` field on messages. Instead, you can use the `id` field in the nested `user` object. See the [Message Interaction Metadata Object](#DOCS_RESOURCES_CHANNEL/message-interaction-metadata-object) for details. |
| 17 | +- User-installed apps are now limited to creating a maximum of 5 [follow-ups](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/followup-messages) when responding to interactions. This only affects the [Create Followup Message endpoint](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/create-followup-message), and apps installed to the server are unaffected. |
| 18 | +- On [Interactions](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/interaction-object-interaction-structure), the value of `authorizing_integration_owners` is now correctly serialized as a string. Previously, the `"0"` value was incorrectly serialized as a number. |
| 19 | +- `app_permissions` on [Interactions](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/interaction-object-interaction-structure) now correctly represents the permissions for user-installed apps. Previously, the value was incorrect for user-installed apps. |
| 20 | +- Updating a message can result in a `400` response if the content of the message was blocked by AutoMod, which may be particularly important for [deferred messages](#DOCS_INTERACTIONS_RECEIVING_AND_RESPONDING/responding-to-an-interaction). |
| 21 | +- Interaction responses are no longer forced to be ephemeral for servers with over 25 members. |
| 22 | + |
| 23 | +###### New `Use External Apps` Permission |
| 24 | + |
| 25 | +A new [`USE_EXTERNAL_APPS` (`1 << 50`) permission](#DOCS_TOPICS_PERMISSIONS/permissions-bitwise-permission-flags) was added, and is enabled for servers by default. The new permission lets modmins control whether user-installed apps can post public replies in a server. If `Use External Apps` is disabled and your app is *not* installed to the server, your app’s responses will be ephemeral for the end user. |
| 26 | + |
| 27 | +Read more in the [Moderating Apps on Discord Help Center article](https://support.discord.com/hc/en-us/articles/23957313048343-Moderating-Apps-on-Discord#h_01HZQQQEADYVN2CM4AX4EZGKHM). |
| 28 | + |
| 29 | +###### Updated Defaults for New Apps |
| 30 | + |
| 31 | +- Newly-created apps now default to having both "User Install" *and* "Guild Install" [installation contexts](#DOCS_RESOURCES_APPLICATION/installation-context) enabled. This can be updated in the **Installation** tab in an [app's settings](https://discord.com/developers/applications). |
| 32 | +- Newly-created apps now default to using the "Discord Provided Link" [install link](#DOCS_RESOURCES_APPLICATION/install-links). This can be updated in the **Installation** tab in an [app's settings](https://discord.com/developers/applications). |
| 33 | +- If Discord Provided Link is selected as the install link type, `application.commands` scope is added to both installation contexts. |
| 34 | + |
3 | 35 | ## Premium Apps: New Premium Button Style & Deep Linking URL Schemes |
4 | 36 |
|
5 | 37 | #### June 17, 2024 |
@@ -76,9 +108,6 @@ You can find the export at the bottom of the `Monetization → Analytics` tab of |
76 | 108 |
|
77 | 109 | #### March 18, 2024 |
78 | 110 |
|
79 | | -> preview |
80 | | -> User-installable apps are currently in preview. During the preview, there are major [limitations and known bugs](#DOCS_CHANGE_LOG/march-18-2024-limitations-and-known-issues), and API details are subject to change. |
81 | | -
|
82 | 111 | Apps can now be installed to users—making them easier to install, discover, and access across Discord. User-installed apps can be used across all of a user's servers, within their (G)DMs, and in DMs with the app's bot user. |
83 | 112 |
|
84 | 113 | When creating or updating your app, you can choose which installation types your app supports on the **Installation** page in your [app's settings](https://discord.com/developers/applications). To quickly get started, you can follow the new [Developing a User-Installable App tutorial](#DOCS_TUTORIALS_DEVELOPING_A_USER_INSTALLABLE_APP) or read details about the new changes below. |
|
0 commit comments