clarify slack alert (#1776)

Co-authored-by: Mason Daugherty <mason@langchain.dev>

Author: tanushree-sharma

src/langsmith/alerts-webhook.mdx

@@ -120,7 +120,13 @@ Here is an example for configuring LangSmith alerts to send notifications to Sla
 3. Review the permissions and click **Allow**
 4. Copy the **Bot User OAuth Token** that appears (begins with `xoxb-`)
 
-### Step 4: Configure the Webhook Alert in LangSmith
+### Step 4: Add the Bot to a Slack Channel
+
+Add the bot to the specific channel you want to receive alerts in. You can add a bot to a Slack channel by mentioning it in the message field (e.g., `@botname`).
+
+You also need the channel ID to configure the webhook alert in LangSmith. You can find the channel ID by opening channel details > About
+
+### Step 5: Configure the Webhook Alert in LangSmith
 
 1. In LangSmith, navigate to your project
 2. Select **Alerts → Create Alert**
@@ -135,6 +141,7 @@ https://slack.com/api/chat.postMessage
 ```
 
 **Headers**
+<Note>Replace `xoxb-your-token-here` with your Bot's User OAuth Token</Note>
 
 ```json
 {
@@ -143,9 +150,8 @@ https://slack.com/api/chat.postMessage
 }
 ```
 
-> **Note:** Replace `xoxb-your-token-here` with your actual Bot User OAuth Token
-
 **Request Body Template**
+<Note>It is required to fill in the `{channel_id}` from the value found in Step 4. <br /><br />The remaining fields: `alert_name`, `project_name` and `project_url` optionally add additional context to the alert message. You can find your `project_url` in the browser's URL bar. Copy the portion up to but not including any query parameters.</Note>
 
 ```json
 {
@@ -177,17 +183,15 @@ https://slack.com/api/chat.postMessage
 }
 ```
 
-**NOTE:** Fill in the `channel_id`, `alert_name`, `project_name` and `project_url` when creating the alert. You can find your `project_url` in the browser's URL bar. Copy the portion up to but not including any query parameters.
-
 6. Click **Save** to activate the webhook configuration
 
-### Step 5: Test the Integration
+### Step 6: Test the Integration
 
 1. In the LangSmith alert configuration, click **Test Alert**
 2. Check your specified Slack channel for the test notification
 3. Verify that the message contains the expected alert information
 
-### (Optional) Step 6: Link to the Alert Preview in the Request Body
+### (Optional) Step 7: Link to the Alert Preview in the Request Body
 
 After creating an alert, you can optionally link to its preview in the webhook's request body.
 
@@ -197,7 +201,7 @@ To configure this:
 
 1. Save your alert
 2. Find your saved alert in the alerts table and click it
-3. Copy the dsiplayed URL
+3. Copy the displayed URL
 4. Click "Edit Alert"
 5. Replace the existing project URL with the copied alert preview URL