Slack Integration

Connect Slack to Waldium and manage your entire content workflow without leaving your workspace. Waldo, your AI assistant, lives in your Slack channel and can generate posts, list drafts, pull analytics, save threads to your knowledge base, and more.

Overview

Once connected, you can interact with Waldo by mentioning @Waldo in your connected channel or using the /waldo slash command. Waldo can:

• Generate blog posts — Create drafts from a topic in seconds
• List and preview drafts — See your recent drafts with quick actions to edit or publish
• View analytics — Get content stats and live traffic data from Umami
• Weekly digest — See a summary of your publishing activity
• Save Slack threads — Turn conversations into knowledge base documents
• Learn from URLs — Crawl a webpage and add it to your knowledge base
• Voice riffs — Start, schedule, and recap voice brainstorming sessions
• Link previews — Shared Waldium blog links automatically unfurl with rich previews

Getting Started

Step 1: Navigate to Slack Settings

1. Go to your Waldium dashboard
2. Navigate to Settings → Integrations
3. Click Slack from the integrations list

Step 2: Add to Slack

1. Click Add to Slack
2. You'll be redirected to Slack's OAuth flow
3. Choose the workspace you want to connect
4. Select the channel where Waldo should respond
5. Click Allow to complete the connection

Step 3: Start Using Waldo

Once connected, go to your chosen channel and type:

@Waldo help

Waldo will reply with a full list of available commands.

Commands

You can interact with Waldo in two ways:

• @Waldo [command] — Mention Waldo in your connected channel
• /waldo [command] — Use the slash command (replies are only visible to you)

Writing

When Waldo generates a post, it replies with the title, description, and reading time, plus action buttons to Edit in Waldium or Publish directly from Slack.

Analytics

Waldo understands natural language too. You can ask things like:

• "How are things going?"
• "How are the posts doing?"
• "How is traffic looking?"
• "Show me the numbers"

What you'll see in stats:

• Content — Total posts (published/drafts), posts this month, average reading time, top category, knowledge base file count
• Traffic — Pageviews, unique visitors, bounce rate, and average visit duration (powered by Umami analytics)

Knowledge Base

Your knowledge base makes AI-generated posts more accurate and on-brand. The more context you feed it — docs, blog posts, conversation threads — the better Waldo writes.

Learn command details:

• Waldo fetches the page, extracts the main text content, and saves it as a markdown file
• Works with any publicly accessible URL
• Content is truncated at ~50,000 characters for very long pages
• The page must be publicly accessible (no login-gated content)

Save this command details:

• Use this as a reply inside a thread you want to save
• Waldo collects all non-bot messages from the thread
• Saves them as a timestamped markdown document in your knowledge base

Voice Riffs

Riffs are voice brainstorming sessions where you talk through ideas out loud and Waldo helps turn them into blog posts.

After a riff session, you can:

• Create a post from it — Waldo generates a draft from your transcript
• Save to knowledge base — Store the transcript as reference material
• View the full transcript — Open it in the Waldium dashboard

Link Previews

When someone shares a Waldium blog URL in your connected channel, Waldo automatically unfurls it with a rich preview card showing:

• Post title and description
• Category, reading time, and author
• Site name

This works for both *.waldium.app subdomains and verified custom domains.

App Home Tab

Click on Waldo in your Slack sidebar to open the App Home Tab — a dashboard view that shows:

• Content stats — Total posts, published/draft counts, posts this month, avg reading time
• Traffic stats — Pageviews, visitors, bounce rate, avg visit duration (last 30 days)
• Recent drafts — Your 5 most recent drafts with Edit buttons
• Upcoming schedules — Auto-generate schedule and pending tasks
• Quick actions — Links to open your Waldium dashboard or view all drafts

The Home Tab refreshes every time you open it.

Notifications

You can configure Slack notifications in Settings → Integrations → Slack:

Toggle these on or off and pick the day of the week for the weekly digest.

Managing the Integration

Viewing Connection Status

Go to Settings → Integrations → Slack to see:

• Your connected Channel ID and Workspace ID
• Notification preferences
• Connection status

Disconnecting

1. Go to Settings → Integrations → Slack
2. Click Disconnect
3. Waldo will stop responding in that channel
4. You can reconnect at any time by clicking Add to Slack again

Tips

• Use threads — When generating posts, Waldo replies in-thread to keep your channel clean
• Natural language works — You don't need exact commands. Waldo uses AI to understand intent, so phrases like "write something about AI trends" or "how are the posts performing" work naturally
• Slash commands are private — /waldo stats shows results only to you, while @Waldo stats posts publicly in the channel
• Knowledge base improves quality — The more you feed your knowledge base (via learn and save this), the better Waldo's generated posts match your voice and brand
• Publish from Slack — You can publish drafts directly from Slack without opening the dashboard

Troubleshooting

Waldo isn't responding

• Make sure you're in the channel that's connected to your site (check Settings → Integrations → Slack)
• Verify Waldo is mentioned with @Waldo (not just "Waldo")
• Check that the Slack app is still installed in your workspace

"This channel isn't connected" error

• The channel you're in isn't linked to a Waldium site
• Go to Settings → Integrations → Slack and reconnect, choosing the correct channel

Commands aren't recognized

• Try @Waldo help to see all available commands
• Waldo uses AI to classify messages, so try rephrasing naturally
• Make sure you're not sending the command as part of a longer message with unrelated content

No traffic data in stats

• Traffic analytics require Umami to be configured for your site
• Content stats will still appear even without Umami
• Contact support if you believe Umami should be set up but isn't working

OAuth errors during setup

• access_denied — You declined the Slack permissions. Try again and click Allow.
• channel_already_connected — The channel you selected is already linked to another Waldium site. Each channel can only connect to one site.

Next Steps

• Set up content scheduling to auto-generate posts on a schedule
• Build your knowledge base to improve AI-generated content
• Configure your branding so generated posts match your style
• Explore the API for programmatic content management