docs/integrations/slack

Slack Integration

v1.3.0last modified 2026-03-27

Install Ekachit Bot

PRO PLAN REQUIRED

1. Open Ekachit → Settings → Integrations → Slack

2. Tap "Add to Slack"

3. Slack OAuth consent screen → select your workspace

4. Review permissions → "Allow"

5. Redirect back → ✓ Connected

⚠ In managed workspaces, an admin must approve the Ekachit app before team members can install it.

Workspace Permissions

We request the minimum scopes needed for focus features:

✓ dnd:write — set/clear Do Not Disturb during focus

✓ users.profile:write — update your status emoji + text

✓ chat:write — send DMs to you only (digests, summaries)

✕ channels:read — we cannot see your channels

✕ messages:read — we cannot read any messages

✕ files:read — we cannot access shared files

✕ users:read — we cannot see your coworkers

✕ admin.* — we have zero admin capabilities

DND Sync

When you start a focus session, Ekachit automatically enables Slack Do Not Disturb. When the session ends, DND is lifted.

dnd behavior

on_session_start:Slack DND enabled for session duration

on_session_end:DND cleared, notifications resume

on_session_cancel:DND cleared immediately

manual_override:you can always manually toggle DND in Slack

Configure when DND activates in Settings → Integrations → Slack → DND Mode:

always — every focus session enables DND

deep_work_only — only sessions linked to a task (default)

never — DND sync disabled

Focus Status

Ekachit auto-updates your Slack status during focus sessions:

// default status

emoji: 🎯

text: "In Focus Mode"

expiration: session end time

// with task linked

emoji: 🎯

text: "Focusing on: Build auth flow"

expiration: estimated completion or session end

Customize emoji and text format in Settings → Integrations → Slack → Status Format. Your previous status is saved and restored when the session ends.

Notification Batching

During focus sessions, Ekachit suppresses Slack notification anxiety by collecting a summary:

// end-of-session batch DM

🎯 Focus session complete (1h 45m)

While you were focused:

• 3 DMs received

• 2 channel mentions

• 1 thread reply

ℹ We track notification counts received during your focus session — we never read message content.

Daily Digest

Optional end-of-day Slack DM summarizing your focus performance:

📊 Daily Focus Report — March 27

Sessions: 4 completed (3h 20m total)

Phone pickups: 2 (46m recovery cost)

Tasks: 3 completed, 1 in progress

Focus score: 78/100

Streak: 🔥 5 days

digest settings

delivery_time:configurable (default: 6:00 PM local)

skip_weekends:configurable (default: true)

minimum_sessions:1 (no digest if no sessions that day)

What We Access

✓DND status (read + write) — to sync focus sessions

✓Profile status (read + write) — to show focus status

✓DM channel to you (write only) — for digests and summaries

✓Unread badge count (read only) — for notification batching

What We Don't Access

✕message content (any channel, DM, or thread)

✕channel list or membership

✕shared files or documents

✕reactions or emoji usage

✕user directory or profiles of others

✕workspace settings or admin functions

✕call or huddle data

✕search history

Common Issues

Bot not responding

Disconnect and reconnect in Settings → Integrations → Slack. This refreshes the OAuth token.

DND not syncing

Some workspaces have admin-controlled DND policies that override app settings. Check with your workspace admin.

Status not updating

Ensure users.profile:write permission was granted. Re-install the bot if this scope is missing.

Digest not arriving

Check delivery time in settings. Digests only send on days with at least 1 focus session. Verify DM channel isn't muted.

Disconnect

Settings → Integrations → Slack → "Disconnect"

immediate: OAuth token revoked

immediate: DND returns to your default setting

immediate: Status cleared (previous status restored)

immediate: No more DMs from Ekachit

Disconnecting does not delete any Ekachit data. Your focus history remains intact.