Slack Integration

Use DocLD inside Slack with the official DocLD Slack app. Upload documents, search, run extractions, trigger workflows, and chat with your documents from any channel or DM.

What you get

Capability	Description
Slash commands	`/docld ask`, `/docld search`, `/docld upload`, `/docld extract`, `/docld workflow`, `/docld summary`, `/docld status`
@mention RAG	Mention the app in a channel to ask questions about your DocLD knowledge bases (RAG)
File shared	Automatically upload files shared in channels where the app is added
App Home	Dashboard in Slack with quick access to documents and actions
DM chat	One-on-one chat with the bot over your documents

Setup

The DocLD Slack app is a Bolt for JavaScript app using Socket Mode. You can run it yourself or use a hosted offering if available.

1. Create a Slack app

Go to api.slack.com/apps and create a new app (from scratch or from the DocLD manifest).
Use the manifest in the DocLD repo at packages/docld-slack/manifest.json to preconfigure scopes and slash commands, or add them manually (see below).

2. Required scopes and commands

Bot token scopes: app_mentions:read, chat:write, files:read, commands, im:history, im:read, im:write, channels:history, groups:history, and others as required by the commands and events you enable.
Slash commands: Register /docld with optional subcommands (ask, search, upload, extract, workflow, summary, status).
Event subscriptions: Enable App mention (for RAG in channels), Message (DM) (for chat), File shared (for auto-upload).
Socket Mode: Enable Socket Mode and install the app to your workspace to receive events without a public URL.

3. Environment variables

Configure the app with:

Variable	Description
`SLACK_BOT_TOKEN`	Bot token (starts with `xoxb-`)
`SLACK_APP_TOKEN`	App-level token for Socket Mode (starts with `xapp-`)
`DOCLD_API_KEY`	Your DocLD API key
`DOCLD_API_URL`	DocLD API base URL (e.g. `https://your-deployment.vercel.app`)

4. Run the app

From the repo root:


npm run slack

Or from the package:


cd packages/docld-slack && npm run dev

Commands

/docld ask — Ask a question over a knowledge base (RAG).
/docld search — Semantic search across your documents.
/docld upload — Upload a document (e.g. from a file).
/docld extract — Run extraction with a schema.
/docld workflow — List or execute workflows.
/docld summary — Summarize a document.
/docld status — Check processing status.

Details and arguments are available in-app via Slack’s command help.

Workflow webhooks vs Slack app

You can also send workflow notifications to Slack using workflow integrations: create an integration of type slack with a webhook URL and use it in a workflow step. That is separate from the DocLD Slack app: the app brings DocLD into Slack; webhooks push workflow results to a channel.