Slack Integration

Connect your define.wtf workspace to Slack to bring your acronym dictionary to where your team already communicates. Once connected, team members can use the /define slash command directly in Slack to look up definitions without leaving their workspace.

What You Get

Once Slack is connected:

• /define TERM command — Look up any acronym or term in your dictionary without leaving Slack
• Block Kit formatted responses — Rich, interactive reply messages with definition text and a link to the full entry
• No account required — Slack users don't need a separate define.wtf account to use /define (read-only access)
• Automatic tenant resolution — The command works in your connected Slack workspace and always searches your team's dictionary

Connection Requirements

• You must be an admin or owner with tenant:manage_settings permission
• Your Slack workspace must allow app installations
• You'll need workspace-level admin permissions in Slack to authorize the define.wtf app

Connecting Slack

Step 1: Navigate to Settings

1. Log in to define.wtf as an admin
2. Go to Settings → Slack
3. Click Add to Slack

Step 2: OAuth Authorization

1. You'll be redirected to Slack's OAuth authorization screen
2. Slack may ask you to select which workspace to install the app to (if you're signed in to multiple workspaces)
3. Review the permissions requested (the app requests minimal scopes)
4. Click Allow to authorize define.wtf
5. You'll be redirected back to define.wtf

Step 3: Confirm Connection

After authorization:

• You'll see a success message: "Slack workspace connected"
• Your Slack workspace status will show as "Connected"
• The /define command is automatically available in your workspace
• All team members can now use /define in any channel

Using /define in Slack

Basic Usage

/define OKR

Response Format

The /define command returns a Block Kit message with:

• Acronym/Term — The lookup term in bold
• Primary definition — The most upvoted definition for this term
• Definition author — Who contributed this definition
• Link to full entry — "View in define.wtf" link to your workspace

Example Slack response:

OKR: Objectives and Key Results
A goal-setting and performance management framework where objectives are qualitative goals and key results are quantifiable measures of progress.

Added by: Sarah Chen
[View in define.wtf]

Not Found

If a term isn't in your dictionary:

No definition found for "NOTATERM" in define.wtf

Want to add it? Jump to define.wtf and create a new entry.

Managing the Connection

View Connected Workspace

In Settings → Slack, you can see:

• Workspace status — "Connected" or "Not connected"
• Usage information — How to use the /define command

Disconnect Slack

To remove the Slack integration:

1. Go to Settings → Slack
2. Click Disconnect from Slack
3. Confirm the action (the /define command will stop working immediately)

After disconnection, team members will see an error when trying to use /define.

Switch Workspaces

Define.wtf supports connecting to only one Slack workspace per tenant. To connect a different workspace:

1. Disconnect the current workspace (see above)
2. Wait 30 seconds for Slack to sync the change
3. Connect the new workspace by clicking Add to Slack

If you need to connect multiple Slack workspaces to separate define.wtf teams, create separate define.wtf tenants.

Technical Details

OAuth Callback

The fixed callback URL for all define.wtf Slack integrations is:

https://app.define.wtf/api/slack/oauth/callback

Tenant identification uses a signed state parameter in the OAuth flow.

Tenant Resolution

When Slack sends a /define command:

1. The request includes your Slack workspace ID (team_id)
2. Define.wtf looks up which tenant is connected to this workspace
3. The search is scoped to that tenant's acronyms only
4. Results are returned in the appropriate workspace context

Signature Verification

All incoming Slack requests (slash commands, OAuth callbacks) are verified using HMAC-SHA256 signature verification. This ensures that only legitimate Slack requests are processed.

Best Practices

• Announce the command — Let your team know that /define TERM is available in Slack
• Link to definitions — Encourage team members to use the "View in define.wtf" link to see all definitions and vote
• Keep it updated — Regularly add new acronyms so the /define command stays useful
• Monitor usage — Check your audit trail to see which terms are most frequently looked up via Slack

Troubleshooting

"Slack integration failed to connect"

• Ensure you have workspace-level admin permissions in Slack
• Check that the Slack app hasn't been removed from your workspace
• Try disconnecting and reconnecting

"/define command not appearing in Slack"

• Give Slack 1-2 minutes to register the new command
• Try typing / in a Slack channel to see the command list refresh
• If still missing, try reconnecting the workspace

"No definitions found" when they exist in define.wtf

• Verify the correct workspace is connected
• Check that the term exists in your define.wtf dictionary
• Ensure the term search is using the exact acronym (search is case-insensitive but must match the term)

Can't disconnect Slack

• Ensure you have tenant:manage_settings permission
• Try again after clearing your browser cache
• If the issue persists, contact support

Privacy and Security

• Read-only access — The /define command only searches definitions; it cannot create, edit, or delete content
• No authentication required — Slack users don't need define.wtf accounts to use /define
• Audit logging — All /define command usage is logged for compliance and analytics
• No data export — Define.wtf does not export your Slack workspace data or messages