Slack

Monitor mentions, DMs, and channel activity. Get notified when someone needs your attention — reply directly from the notification card without opening Slack.

Quick Setup

1. Go to api.slack.com/apps
2. Click Create New App → From scratch
3. Name it anything (e.g. "Phyllax") and select your workspace
4. Go to OAuth & Permissions in the sidebar
5. Scroll to User Token Scopes and add the scopes listed below
6. Click Install to Workspace at the top → Allow
7. Copy the User OAuth Token (starts with xoxp-)
8. Get your Team ID — open Slack in a browser, the URL looks like app.slack.com/client/T01234567/... — copy the T01234567 part
9. In Phyllax → Integrations → Slack → Connect → paste both values

Required Credentials

Field	Where to find it
User Token	api.slack.com → Your App → OAuth & Permissions → User OAuth Token (xoxp-...)
Team ID	Open Slack in browser → URL contains T01234567 after /client/

Why User Token?

Phyllax uses a User OAuth Token (xoxp-) so it can see your real DMs, mentions, and all channels — exactly what you see in Slack. A bot token can only see channels the bot is invited to, which means it would miss your direct messages entirely.

User tokens don't expire unless you revoke the app or a workspace admin removes it.

Required User Token Scopes

Add all of these under OAuth & Permissions → User Token Scopes:

Scope	What it does
channels:read	List public channels
channels:history	Read messages in public channels
groups:read	List private channels
groups:history	Read messages in private channels
im:read	List direct messages
im:history	Read direct messages
mpim:read	List group DMs
mpim:history	Read group DMs
users:read	Get user names and profiles
chat:write	Send messages (replies show as you)
reactions:read	Read emoji reactions

After adding scopes

You must Reinstall to Workspace after adding new scopes. Slack requires this — click the yellow banner at the top of the OAuth page. You'll get a new token — copy it and update in Phyllax.

How Phyllax Checks Slack

Phyllax calls the Slack API directly (not through the LLM) for fast, accurate results:

1. Fetches DMs — gets all your direct message conversations and recent messages
2. Checks channel mentions — scans channels for messages that @mention you
3. Resolves names — looks up real names for all senders (no raw user IDs)
4. Fetches thread context — if you're mentioned in a thread, pulls the thread summary
5. Groups by person — multiple DMs from the same person appear as one card
6. AI triage — only shows messages that actually need your attention
7. Only new messages — each check only looks at messages since the last check

What Phyllax Monitors

Schedule	What it checks
Mentions & DMs	DMs grouped by person + @mentions in channels with thread context
Message from person	DMs from a specific person (parameterized)
Channel keyword watch	Messages in channels matching a specific keyword

Notification Actions

Each DM conversation or mention gets its own notification card. When you expand it:

• AI Suggested Replies — auto-generated reply drafts in different tones (Professional, Friendly, Urgent, etc.)
• Send — sends directly to the DM or thread as you (not as a bot)
• Thread replies — if the mention is in a thread, your reply goes into that thread
• Open Slack — jump to the conversation in Slack
• Copy — copy the reply text to clipboard

Troubleshooting

"Access denied" or "missing_scope" error

You're missing one or more user token scopes. Go to api.slack.com → your app → OAuth & Permissions → add the missing scopes under User Token Scopes → Reinstall to Workspace → copy the new token → update in Phyllax.

"invalid_auth" error

Your token is wrong or was revoked. Go to api.slack.com → your app → OAuth & Permissions → copy the User OAuth Token again.

Messages not showing up from private channels

Add the groups:read and groups:history scopes, reinstall. With a user token you can see any private channel you're a member of — no need to invite a bot.

Can't send messages

Add the chat:write scope and reinstall. Messages will be sent as your Slack account.