Skip to content

Commit db666a8

Browse files
committed
Docs: update HOW_TO_START.md
1 parent 329d9f3 commit db666a8

4 files changed

Lines changed: 14 additions & 7 deletions

File tree

docs/HOW_TO_START.md

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -396,16 +396,23 @@ Go to **Settings → Socket Mode** and enable it.
396396

397397
### 3. Generate an App-Level Token
398398

399-
Go to **Settings → Socket Mode → App Level Token**. Generate a token with the `connections:write` scope. Copy it — it starts with `xapp-`.
399+
Go to **Settings → Socket Mode → App Level Token**.
400+
401+
![slack_02](slack_02.png)
402+
403+
Generate a token with the `connections:write` scope. Copy it — it starts with `xapp-`.
400404

401405
> Save this token now, you will need it shortly.
402406
403-
![slack_02](slack_02.png)
404407
![slack_03](slack_03.png)
405408

406409
### 4. Configure Bot Token Scopes
407410

408-
Go to **Features → OAuth & Permissions → Bot Token Scopes** and add:
411+
Go to **Features → OAuth & Permissions → Bot Token Scopes**.
412+
413+
![slack_04](slack_04.png)
414+
415+
Scroll down to OAuth Permission Scopes and add:
409416

410417
- `app_mentions:read`
411418
- `chat:write`
@@ -415,7 +422,6 @@ Go to **Features → OAuth & Permissions → Bot Token Scopes** and add:
415422
- `mpim:history`
416423
- `files:read`
417424

418-
![slack_04](slack_04.png)
419425
![slack_05](slack_05.png)
420426

421427
### 5. Enable Event Subscriptions
@@ -429,10 +435,12 @@ Go to **Features → Event Subscriptions** and enable Events. Then go to **Subsc
429435

430436
### 6. Install the App
431437

432-
Click **Install to Workspace** and copy the **Bot User OAuth Token** (starts with `xoxb-`).
438+
Go back to **Features → OAuth & Permissions**. Click **Install to Workspace** and copy the **Bot User OAuth Token** (starts with `xoxb-`).
433439

434440
> Save this token as well before continuing.
435441
442+
![slack_07](slack_07.png)
443+
436444
### 7. Configure Picobot
437445

438446
#### Option 1
@@ -481,9 +489,8 @@ Now mention your bot in a Slack channel (`@Picobot hello!`) or send it a DM. Pic
481489

482490
**How the bot responds:**
483491
- **In channels** — only when @-mentioned (e.g. `@Picobot Hey, how are you pico?`)
484-
- **In DMs** — responds to every message
485492

486-
![slack_07](slack_07.png)
493+
![slack_08](slack_08.png)
487494

488495
---
489496

docs/slack_04.png

-94.7 KB
Loading

docs/slack_07.png

90.8 KB
Loading

docs/slack_08.png

53.3 KB
Loading

0 commit comments

Comments
 (0)