Skip to content

Commit b233811

Browse files
authored
Bot OAuth2: mention integration_type and Default Install Settings default (#8324)
* mention `integration_type` and Default Install Settings * Update developers/topics/oauth2.mdx * inline code
1 parent 7d0856f commit b233811

1 file changed

Lines changed: 10 additions & 7 deletions

File tree

developers/topics/oauth2.mdx

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -307,13 +307,14 @@ Bot authorization is a special server-less and callback-less OAuth2 flow that ma
307307
<ManualAnchor id="bot-authorization-flow-bot-auth-parameters" />
308308
###### Bot Auth Parameters
309309

310-
| name | description |
311-
|----------------------|-----------------------------------------------------------------------|
312-
| client_id | your app's client id |
313-
| scope | needs to include `bot` for the bot flow |
314-
| permissions | the [permissions](/developers/topics/permissions) you're requesting |
315-
| guild_id | pre-fills the dropdown picker with a guild for the user |
316-
| disable_guild_select | `true` or `false`—disallows the user from changing the guild dropdown |
310+
| name | description |
311+
|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------|
312+
| client_id | your app's client id |
313+
| scope? | needs to include `bot` for the bot flow |
314+
| permissions? | the [permissions](/developers/topics/permissions) you're requesting |
315+
| guild_id? | pre-fills the dropdown picker with a guild for the user |
316+
| disable_guild_select? | `true` or `false`—disallows the user from changing the guild dropdown |
317+
| integration_type? | the [installation context](/developers/resources/application#application-object-application-integration-types) for the authorization |
317318

318319
<ManualAnchor id="bot-authorization-flow-url-example" />
319320
###### URL Example
@@ -329,6 +330,8 @@ When the user navigates to this page, they'll be prompted to add the bot to a gu
329330
If you happen to already know the ID of the guild the user will add your bot to, you can provide this ID in the URL as a `guild_id=GUILD_ID` parameter.
330331
When the authorization page loads, that guild will be preselected in the dialog if that user has permission to add the bot to that guild. You can use this in conjunction with the parameter `disable_guild_select=true` to disallow the user from picking a different guild.
331332

333+
If you only provide the `client_id` parameter (with optionally `permissions`, `guild_id`, or `disable_guild_select`), the authorization will use the [default install settings](/developers/resources/application#configuring-an-install-link-and-default-install-settings) configured in the developer portal. Specifying `scope`, `integration_type`, or `redirect_uri` will override this behavior.
334+
332335
If your bot is super specific to your private clubhouse, or you just don't like sharing, you can leave the `Public Bot` option unchecked in your application's settings. If unchecked, only you can add the bot to guilds. If marked as public, anyone with your bot's URL can add it to guilds in which they have proper permissions.
333336

334337
### Advanced Bot Authorization

0 commit comments

Comments
 (0)