How to Connect Slack to Verk

Slack is where your team talks. Verk is where your work lives. Let's connect them so you never miss a beat.

Why connect Slack?

When Slack and Verk are connected, you can:

• Send messages to any channel or user from Verk workflows
• Create new channels programmatically
• Get notified in Slack when important events happen
• Have your AI agents post updates directly to channels
• Keep your team in sync without switching between apps

What you'll need

Before you start, make sure you have:

• Admin access to your Slack workspace (or ask your admin to approve the connection)
• Admin or Member role in your Verk organization
• A Slack workspace with the channels you want to integrate

Connecting Slack to Verk

Here's how to set up the connection:

1. Open Integrations settings

   • Log into Verk
   • Click your organization name in the top navigation
   • Go to Settings → Integrations

2. Find Slack

   • Scroll through the available integrations
   • Find the Slack card
   • Click the Connect button

3. Authorize with Slack

   • You'll be redirected to Slack's authorization page
   • Review the permissions Verk is requesting (we only ask for what we need to function)
   • Select the workspace you want to connect
   • Click Allow to grant access

4. Confirm the connection

   • You'll be redirected back to Verk
   • You should see a success message
   • The Slack card will now show "Connected" with a green indicator

That's it! Slack is now connected to your Verk organization.

What Verk can do with Slack

Once connected, you can use Slack in several ways:

Send messages to channels

Your workflows and AI agents can post messages to any public or private channel (that the Verk bot has been invited to):

• Post task updates to a project channel
• Share daily summaries with your team
• Send alerts when important events happen

Send direct messages

Send private messages to specific team members:

• Notify someone when they're assigned a task
• Send personalized reports
• Alert users about action items

Create new channels

Automatically create channels for new projects or teams:

• Set up a channel when a new project is created
• Create temporary channels for sprints or events
• Organize discussions by topic

Get real-time notifications

Set up notifications so you never miss important updates:

• Task assignments
• Status changes
• Comments and mentions
• Workflow completions

Setting up notifications

Want to know when tasks are assigned to you? Here's how to set up personal notifications:

1. Go to notification settings

   • Navigate to Settings → Notifications
   • Find the Slack Notifications section

2. Choose your events

   • Check the events you want to be notified about:
     • Task assigned to me
     • Task I'm watching was updated
     • Someone mentioned me in a comment
     • Task deadline approaching
     • Workflow completed

3. Select notification channel

   • Choose where notifications should go:
     • Direct messages (private, just for you)
     • Specific channel (shared with your team)

4. Save your preferences

   • Click Save Changes
   • You'll receive a test notification to confirm it's working

Using Slack in workflows

The real power of Slack integration comes when you use it in your Verk workflows. Here's what you can do:

Example: Project kickoff automation

When a new project is created:

1. Create a dedicated Slack channel for the project
2. Send a welcome message with project details
3. Notify team members in their DMs

Example: Daily standup summary

Every morning at 9 AM:

1. Collect all tasks due today
2. Format them into a nice message
3. Post to your team's standup channel

Example: Alert on blockers

When a task is marked as blocked:

1. Send an immediate alert to the project channel
2. Tag the project manager in the message
3. Include task details and what's blocking it

To set up workflow actions with Slack:

1. Open any workflow in Verk
2. Add an action step
3. Choose Send Slack Message or Create Slack Channel
4. Configure the action with channel name, message content, etc.
5. Use variables to make messages dynamic (task names, assignees, etc.)

Adding the Verk bot to channels

For Verk to send messages to a channel, the Verk bot needs to be a member of that channel.

For public channels:

1. Open the channel in Slack
2. Click the channel name at the top
3. Go to Integrations tab
4. Click Add apps
5. Search for "Verk" and add it

For private channels:

1. Open the private channel in Slack
2. Type /invite @Verk in the message box
3. Press Enter to send the invitation
4. The Verk bot will be added to the channel

You only need to do this once per channel. After that, Verk can send messages there anytime.

Managing your connection

Viewing connection status

To check if Slack is still connected:

1. Go to Settings → Integrations
2. Look at the Slack card
3. A green "Connected" badge means everything is working
4. If you see "Disconnected" or "Authorization expired", you'll need to reconnect

Reconnecting Slack

If your connection expires or is revoked:

1. Go to Settings → Integrations
2. Click Reconnect on the Slack card
3. Follow the authorization flow again
4. All your previous workflows will continue working with the new connection

Disconnecting Slack

If you need to disconnect Slack:

1. Go to Settings → Integrations
2. Click the ... menu on the Slack card
3. Select Disconnect
4. Confirm you want to disconnect

Note: Disconnecting will disable all workflows that use Slack actions until you reconnect.

Troubleshooting

Bot not appearing in channel list

Problem: Can't find the Verk bot when trying to add it to a channel.

Solution: Make sure the Slack integration is connected in Verk first. The bot only appears in your workspace after you complete the authorization.

Messages not being delivered

Problem: Workflows run but messages don't appear in Slack.

Solutions:

• Verify the Verk bot has been added to the target channel
• Check that the channel name is spelled correctly in your workflow (including any hyphens)
• For private channels, make sure you've explicitly invited the Verk bot
• Check if your Slack connection has expired (go to Integrations settings)

"Channel not found" error

Problem: Workflow fails with a channel not found error.

Solutions:

• Channel names in Slack don't include the # symbol - use "general" not "#general"
• Make sure the channel exists and hasn't been archived
• Verify the Verk bot is a member of the channel
• If it's a private channel, the bot needs an explicit invitation

Not receiving notifications

Problem: You're not getting Slack notifications even though they're enabled.

Solutions:

• Go to Notification settings and verify they're turned on
• Check that you selected the right channel or DM option
• Make sure the Verk bot is in the notification channel (if using a channel)
• Look at your Slack notification settings - you might have muted the Verk bot

"Missing required scopes" error

Problem: Getting an error about missing permissions or scopes.

Solution: This means the Slack connection needs updated permissions. Go to Integrations, disconnect Slack, then reconnect it. The new authorization will include all required permissions.

Connection keeps expiring

Problem: You have to reconnect Slack frequently.

Solution: This can happen if your Slack workspace admin has strict security policies. Contact your Slack admin to ensure the Verk app is approved for long-term access.

Privacy and permissions

What Verk can access

When you connect Slack, Verk can:

• Send messages to channels the bot has been added to
• Create new public or private channels
• Read basic information about your workspace (name, domain)
• Read channel lists to help you configure workflows

What Verk cannot access

Verk cannot:

• Read messages in channels (unless explicitly sent to the bot)
• Access private messages between users
• Modify or delete messages
• Read files uploaded to Slack
• Access channels the bot hasn't been added to

Revoking access

You can revoke Verk's access at any time:

1. Go to your Slack workspace settings
2. Navigate to Apps → Manage
3. Find "Verk" in the list
4. Click Remove App

Or disconnect from within Verk:

1. Go to Settings → Integrations
2. Click Disconnect on the Slack card

Best practices

Channel organization

• Create dedicated channels for different types of notifications
• Use #verk-alerts for urgent notifications
• Use #verk-updates for daily summaries
• Keep personal notifications in DMs

Message formatting

• Keep messages concise and scannable
• Use Slack markdown for emphasis (bold, italics, lists)
• Include links back to tasks in Verk
• Add context so messages make sense without switching apps

Notification hygiene

• Only enable notifications for events that matter to you
• Use channels for team-wide updates, DMs for personal ones
• Review and adjust notification settings regularly
• Don't over-notify - it reduces effectiveness

Workflow design

• Test workflows with a private test channel first
• Use clear, descriptive message templates
• Include relevant task details (title, assignee, due date)
• Add error handling for missing channels or users

Getting help

If you run into issues not covered here:

• Check the Verk status page to see if there are known issues
• Contact your Verk organization admin
• Reach out to Verk support with details about what's not working

The Slack integration is one of our most popular features, and we're constantly improving it based on user feedback.