> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack
> Easily connect your [Spidra](https://spidra.io) preset to [Slack](https://slack.com/) and start receiving automated scrape results.
This guide walks you through how to integrate your saved [Spidra](https://spidra.io) preset with [Slack](https://slack.com/), enabling you to automatically send scraped data into your Slack workspace in just a few clicks.
Spidra offers **two integration methods** for Slack:
* **Webhook** – Ideal for sending simple, plain text messages and it is quick to set up.
* **Bot Token** – Suitable for advanced workflows and sending file attachments.
***
Let’s explore the setup for both methods.
## Step 1: Access the Integrations Page
Navigate to the **Integrations** tab on your dashboard and click on the **Add Integration** button.
## Step 2: Select Slack as Integration Type
From the preset dropdown, select the saved preset you'd like to connect to Slack. Choose **Slack** as your integration type.
Click **Next** to proceed.
## Step 3: Configure Your Slack Integration
Spidra supports two ways to connect with Slack. We'll start with the Slack Wehbook:
***
### Method 1: Using a Slack Webhook (Simple, Text-Only)
This method is perfect for quickly getting text-based scrape results delivered to a specific channel, it dooesn't support file attachment.
#### Steps to Get Your Slack Webhook URL
1. Go to the [Slack Incoming Webhooks page](https://api.slack.com/messaging/webhooks).
2. Click **"Create your Slack app"** (if you don’t already have one).
3. **Create your Slack App**:
* Name it something like `"Spidra Notifications"`.
* Choose the Slack workspace where you want to install it.
* Click **Create App**.
4. **Enable Incoming Webhooks**:
* In the app dashboard, navigate to **Features → Incoming Webhooks**.
* Toggle the switch to **activate webhooks**.
5. **Add the Webhook to a Channel**:
* Scroll down and click **“Add New Webhook.”**
* Select the channel you want messages sent to.
* Click **Allow** to grant access.
6. **Copy Your Webhook URL**:
* You’ll be provided a URL like:
```
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
```
* Paste this URL into the **Webhook URL field** in Spidra's Slack integration form.
**Note**: This method supports only plain text — for file attachments, use the Bot Token method.
***
### Method 2: Using a Slack Bot Token (Advanced, File Uploads)
If you need to send rich messages or file attachments (e.g., large data exports), we recommend using a Slack Bot Token integration. Since you’ve already created the **Spidra Notifications** Slack app, follow these steps to enable bot functionality.
#### Steps to Enable Bot Token in Your Existing Slack App
1. **Go to Your App Settings**: Visit api.slack.com/apps and click on your app: **Spidra Notifications**.
2. **Navigate to OAuth & Permissions**: In the left sidebar, click **OAuth & Permissions**.
3. **Set Scopes for Your Bot Token**: Scroll to Bot Token Scopes and click **Add an OAuth Scope**. Add the following permissions:
* `chat:write` → to send messages as the bot.
* `files:write` → to upload and send files.
* `channels:read` → to access public channels.
* `groups:read` → to access private channels (if needed).
4. **Install or Reinstall the App**: At the top of the page, click **Install App to Workspace or Reinstall** if already installed. Proceed to authorize the permissions for your workspace.
5. **Copy Your Bot User OAuth Token**: After installing, scroll up to the OAuth Tokens for Your Workspace section. Copy the token that starts with:
```bash theme={null}
xoxb-...
```
Paste this into the Bot Token field in Spidra's Slack integration form.
6. **Get Your Slack Channel ID**: Spidra also requires your Slack Channel ID to know where to send the data. Here’s how to get it:
* Open Slack and go to the desired channel.
* Right-click the channel name → Copy Link.
You’ll get a URL like:
```bash theme={null}
https://slack.com/app_redirect?channel=C1234567890
```
Copy the value after channel, this is your Channel ID, for example:
```bash theme={null}
C1234567890
```
Paste this ID into the Channel ID field in the integration form.
***
## Step 4: Set Up Your Schedule
Define how often and when you want the integration to trigger:
* **Frequency**: Daily, Weekly, and Monthly.
* **Time**: Select the exact time for the scrape job to run.
* **Timezone** (default is `UTC`): Use a valid [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (e.g., `Africa/Lagos`, `America/New_York`).
Click **Next** when you're done.
## Step 5: Name Your Integration
Give your integration a name that reflects its purpose, this helps with managing multiple integrations. **Example**: `Jobs Alert III`, etc.
## Step 6: Receive Data in Slack
Once your scheduled time hits, Spidra will automatically send the scrape results to your selected Slack channel. If you used the Slack Bot Token, you will be able to see the results and also download it.
You’ll find the data posted directly in your workspace, exactly how you configured it.
***