Yappa Knowledge Hub — Slack Bot User Guide

Guide to using the Yappa Knowledge Hub Slack bot for capturing, organizing, and sharing team knowledge.

Last Updated: 2026-05-15

---

Overview

The Yappa Knowledge Hub Slack bot helps teams capture, organize, and share knowledge directly within Slack. It provides a rich App Home dashboard, message shortcuts for saving conversations, and digest generation for periodic summaries.

Key Features

• App Home Dashboard — Browse all knowledge, categories, and AI summaries in a tabbed interface
• Message Shortcut — Right-click any message to save it as knowledge
• Global Shortcut — Add knowledge from anywhere via the lightning bolt menu
• Thematic Lists (Categories) — Organize knowledge by topic, team, or project
• Digest Generation — Create AI-powered summaries of recent knowledge per category
• Digest Distribution — Send digests to subscribers in specific channels
• Category Settings — Configure automatic digest schedules per category
• Subscriptions — Subscribe to categories to receive digests automatically

---

Getting Started

Accessing the Bot

1. App Home Tab — Click the Yappa Knowledge Hub app in your Slack sidebar
2. Message Shortcut — Right-click (or long-press) any message > "Add to YapHub"
3. Global Shortcut — Click the lightning bolt icon > "Quick Add to YapHub"

First Steps

1. Open the App Home to see the dashboard
2. Click "Toevoegen" (Add) to create your first knowledge item
3. Browse thematic lists to see what's already available

---

App Home Dashboard

The App Home is the central hub for browsing and managing all knowledge.

View Modes

Switch between three views using the dropdown at the top:

Mode	Dutch Label	What It Shows
All Lists	Alle Lijsten	All thematic categories with item counts
All Knowledge Items	Alle Kennisitems	All knowledge items with previews
All AI Summaries	Alle AI Samenvattingen	AI-generated summaries for items

Quick Actions

• Toevoegen (Add) — Create new knowledge
• Digest — Generate a digest
• Dashboard — Open detailed dashboard

Thematic Lists Section

Browse all categories. Each category card shows:

• Category name and icon
• Target groups
• Item count

Overflow Menu (right-click or three dots on each category):

• add_knowledge — Add knowledge to this category
• digest — Generate a digest for this category
• distribute — Distribute existing digests
• settings — Configure digest settings
• subscribe / unsubscribe — Toggle subscription

---

Adding Knowledge

Via Message Shortcut

1. Right-click (or long-press on mobile) any message
2. Select "Add to YapHub"
3. A modal opens with the message text pre-filled
4. Add a title, select a category, add tags
5. Click "Opslaan" (Save)

The bot extracts any URLs from the original message automatically.

Via Global Shortcut

1. Click the lightning bolt icon in the message input area
2. Select "Quick Add to YapHub"
3. Fill in the form:
   • Title (required)
   • Content (required)
   • Thematic List — select a category
   • URL — optional link
   • Tags — comma-separated keywords
4. Click "Opslaan" (Save)

Confirmation

After saving, you receive a DM confirming the item was created:

✅ Kennis "Title" is opgeslagen.

---

Categories (Thematic Lists)

Categories organize knowledge by topic, team, or project.

Creating a Category

1. From App Home, click "Toevoegen" or use the "Add List" action
2. Fill in:
   • Naam (Name) — required
   • Beschrijving (Description) — optional
   • Icon — emoji selector
3. Click "Aanmaken" (Create)

Category Overflow Actions

Each category in the App Home has an overflow menu with:

Action	Description
Add Knowledge	Open add modal with this category pre-selected
Generate Digest	Create an AI summary of recent items
Distribute	Send a digest to subscribers
Settings	Configure automatic digest frequency
Subscribe	Get notified when new digests are generated
Unsubscribe	Stop receiving notifications

---

Digest Generation

Create AI-powered summaries of knowledge items in a category.

Generating a Digest

1. Open a category's overflow menu > "Generate Digest"
   • Or use the "Digest" quick action on the home tab
2. Select a category
3. Configure options (days to look back, target group filter)
4. Click "Genereren" (Generate)

The bot sends the digest to you as a DM. Generation is async — you'll get a confirmation immediately and the digest follows when ready.

Digest Format

Each digest includes:

• Category name and time period
• List of new items with previews
• AI summaries per target group
• Item count

---

Digest Distribution

Send generated digests to specific channels or subscribers.

Distributing

1. Open a category's overflow menu > "Distribute"
   • Or use the home tab "Distribute" action
2. Select the category
3. Choose a digest from the list
4. Select target channels
5. Confirm distribution

---

Category Settings

Configure automatic digest scheduling per category.

Settings Available

Setting	Options	Description
Digest Enabled	Yes/No	Turn auto-digests on or off
Frequency	Weekly, Biweekly, Monthly, Quarterly	How often to generate
Day	Monday–Sunday	Which day to generate
Time	Hour slots	When to generate

Accessing Settings

• Category overflow menu > "Settings"
• Or from the home tab "Settings" action

---

Subscriptions

Subscribe to a category to automatically receive digests.

• Subscribe — Category overflow menu > "Subscribe"
• Unsubscribe — Category overflow menu > "Unsubscribe"

---

Keyboard Shortcuts

In modals:

• Tab — Navigate between fields
• Enter — Submit (on single-line fields)
• Esc — Close modal
• Shift + Enter — New line in multi-line fields

---

Privacy & Permissions

What the bot can see:

• Messages in channels where it's added
• Files shared in those channels
• User IDs and names (for attribution)

What the bot cannot see:

• Private DMs (unless you message it directly)
• Channels where it's not added
• Deleted messages or edit history

Required Scopes:

• chat:write — Send messages
• files:read — File information
• channels:history — Read channel messages
• users:read — User information

---

Troubleshooting

Modal won't open:

• Try refreshing Slack (Ctrl+R)
• Ensure the bot is installed in your workspace

Can't find knowledge:

• Check if you're in the right view mode (Lists vs Items vs Summaries)
• Try switching between categories

Getting errors:

• Check the DM from the bot for error details
• Contact your workspace admin