Skip to content

Commit cc19cd2

Browse files
reference full links
1 parent 74ffa14 commit cc19cd2

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

41 files changed

+63
-66
lines changed

docs/english/building-an-app.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@ app = App(token=os.environ.get("SLACK_BOT_TOKEN"))
207207

208208
# Listens to incoming messages that contain "hello"
209209
# To learn available listener arguments,
210-
# visit https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html
210+
# visit https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html
211211
@app.message("hello")
212212
def message_hello(message, say):
213213
# say() sends a message to the channel where the event was triggered
@@ -233,7 +233,7 @@ app = App(
233233

234234
# Listens to incoming messages that contain "hello"
235235
# To learn available listener arguments,
236-
# visit https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html
236+
# visit https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html
237237
@app.message("hello")
238238
def message_hello(message, say):
239239
# say() sends a message to the channel where the event was triggered

docs/english/concepts/acknowledge.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ We recommend calling `ack()` right away before initiating any time-consuming pro
1010

1111
:::
1212

13-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
13+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
1414
```python
1515
# Example of responding to an external_select options request
1616
@app.options("menu_selection")

docs/english/concepts/actions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Actions can be filtered on an `action_id` parameter of type `str` or `re.Pattern
88

99
You'll notice in all `action()` examples, `ack()` is used. It is required to call the `ack()` function within an action listener to acknowledge that the request was received from Slack. This is discussed in the [acknowledging requests guide](/tools/bolt-python/concepts/acknowledge).
1010

11-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
11+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
1212

1313
```python
1414
# Your listener will be called every time a block element with the action_id "approve_button" is triggered
@@ -45,7 +45,7 @@ There are two main ways to respond to actions. The first (and most common) way i
4545

4646
The second way to respond to actions is using `respond()`, which is a utility to use the `response_url` associated with the action.
4747

48-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
48+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
4949

5050
```python
5151
# Your listener will be called every time an interactive component with the action_id “approve_button” is triggered

docs/english/concepts/ai-apps.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,6 @@ The Agents & AI Apps feature comprises a unique messaging experience for Slack.
2424

2525
That being said, using the `Assistant` class will streamline the process. And we already wrote this nice guide for you!
2626

27-
:::info
28-
You _could_ go it alone and [listen](/tools/bolt-python/concepts/event-listening) for the `assistant_thread_started`, `assistant_thread_context_changed`, and `message.im` events (see implementation details below) in order to implement the AI features in your app. That being said, using the `Assistant` class will streamline the process. And we already wrote this nice guide for you!
29-
:::
30-
3127
## The `Assistant` class instance {#assistant-class}
3228

3329
The `Assistant` class can be used to handle the incoming events expected from a user interacting with an app in Slack that has the Agents & AI Apps feature enabled. A typical flow would look like:
@@ -101,15 +97,16 @@ While the `assistant_thread_started` and `assistant_thread_context_changed` even
10197

10298
If you do provide your own `threadContextStore` property, it must feature `get` and `save` methods.
10399

104-
:::tip[Refer to the [module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.]
100+
:::tip[Refer to the [module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.]
105101
:::
106102

107103
## Handling a new thread {#handling-a-new-thread}
108104

109105
When the user opens a new thread with your AI-enabled app, the [`assistant_thread_started`](/reference/events/assistant_thread_started) event will be sent to your app.
110106

111-
:::tip
112-
When a user opens an app thread while in a channel, the channel info is stored as the thread's `AssistantThreadContext` data. You can grab that info by using the `get_thread_context` utility, as subsequent user message event payloads won't include the channel info.
107+
:::tip[When a user opens an app thread while in a channel, the channel info is stored as the thread's `AssistantThreadContext` data.]
108+
109+
You can grab that info by using the `get_thread_context` utility, as subsequent user message event payloads won't include the channel info.
113110
:::
114111

115112
### Block Kit interactions in the app thread {#block-kit-interactions}
@@ -260,9 +257,9 @@ When the user messages your app, the [`message.im`](/reference/events/message.im
260257
Messages sent to the app do not contain a [subtype](/reference/events/message#subtypes) and must be deduced based on their shape and any provided [message metadata](/messaging/message-metadata/).
261258

262259
There are three utilities that are particularly useful in curating the user experience:
263-
* [`say`](https://docs.slack.dev/bolt-python/reference/#slack_bolt.Say)
264-
* [`setTitle`](https://docs.slack.dev/bolt-python/reference/#slack_bolt.SetTitle)
265-
* [`setStatus`](https://docs.slack.dev/bolt-python/reference/#slack_bolt.SetStatus)
260+
* [`say`](https://docs.slack.dev/tools/bolt-python/reference/#slack_bolt.Say)
261+
* [`setTitle`](https://docs.slack.dev/tools/bolt-python/reference/#slack_bolt.SetTitle)
262+
* [`setStatus`](https://docs.slack.dev/tools/bolt-python/reference/#slack_bolt.SetStatus)
266263

267264
```python
268265
...

docs/english/concepts/app-home.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
You can subscribe to the [`app_home_opened`](/reference/events/app_home_opened) event to listen for when users open your App Home.
66

7-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
7+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
88
```python
99
@app.event("app_home_opened")
1010
def update_home_tab(client, event, logger):

docs/english/concepts/commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ There are two ways to respond to slash commands. The first way is to use `say()`
88

99
When setting up commands within your app configuration, you'll append `/slack/events` to your request URL.
1010

11-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
11+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
1212
```python
1313
# The echo command simply echoes on command
1414
@app.command("/echo")

docs/english/concepts/custom-steps-dynamic-options.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ A new `auto_acknowledge` flag allows you more granular control over whether spec
214214

215215
#### Example {#bolt-py}
216216

217-
In [Bolt for Python](https://docs.slack.dev/bolt-python/), you can set `auto_acknowledge=False` on a specific function decorator. This allows you to manually control when the `ack()` event acknowledgement helper function is executed. It flips Bolt to synchronous `function_executed` event handling mode for the specific handler.
217+
In [Bolt for Python](https://docs.slack.dev/tools/bolt-python/), you can set `auto_acknowledge=False` on a specific function decorator. This allows you to manually control when the `ack()` event acknowledgement helper function is executed. It flips Bolt to synchronous `function_executed` event handling mode for the specific handler.
218218

219219
```py
220220
@app.function("get-projects", auto_acknowledge=False)

docs/english/concepts/custom-steps.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Your app can use the `function()` method to listen to incoming [custom step requ
1111

1212
You can reference your custom step's inputs using the `inputs` listener argument of type `dict`.
1313

14-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn about the available listener arguments.
14+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn about the available listener arguments.
1515

1616
```python
1717
# This sample custom step formats an input and outputs it

docs/english/concepts/event-listening.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ You can listen to [any Events API event](/reference/events) using the `event()`
44

55
The `event()` method requires an `eventType` of type `str`.
66

7-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
7+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
88
```python
99
# When a user joins the workspace, send a message in a predefined channel asking them to introduce themselves
1010
@app.event("team_join")

docs/english/concepts/global-middleware.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Global middleware is run for all incoming requests, before any listener middlewa
44

55
Both global and listener middleware must call `next()` to pass control of the execution chain to the next middleware.
66

7-
Refer to [the module document](https://docs.slack.dev/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
7+
Refer to [the module document](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) to learn the available listener arguments.
88
```python
99
@app.use
1010
def auth_acme(client, context, logger, payload, next):

0 commit comments

Comments
 (0)