Slack Integration
Slack is the most popular messaging channel for IntuitivePM notifications. Configure Slack centrally in the Integration Hub, then assign the Slack channel to Virtual Colleagues or automation features that should use it.
How It Works
IntuitivePM supports two Slack delivery methods:
- Slack Bot: install the IntuitivePM Slack app, select Slack channels from IntuitivePM, and send richer channel messages.
- Slack Incoming Webhook: paste a Slack-generated webhook URL into an IntuitivePM notification channel.
When a Virtual Colleague runs a scan or an automation event fires, the system posts a formatted message to the Slack channel associated with the selected notification channel. Each Virtual Colleague can use its own Slack channel, or multiple colleagues can reuse the same one.
Prerequisites
- A Slack workspace where you have permission to install apps or manage incoming webhooks.
- An IntuitivePM account with admin or project manager permissions.
- At least one project created in your workspace.
Setting Up the Slack Connection
Step 1: Create a Slack App
- Go to api.slack.com/apps and click Create New App.
- Select From scratch.
- Name the app “IntuitivePM” so your team can identify the source of messages.
- Select the Slack workspace where you want messages delivered.
- Click Create App.
Step 2: Enable Incoming Webhooks
- In the left sidebar of your Slack app settings, click Incoming Webhooks.
- Toggle Activate Incoming Webhooks to On.
- Click Add New Webhook to Workspace.
- Select the channel where you want IntuitivePM messages to appear (e.g.,
#project-updates). - Click Allow.
- Slack generates a webhook URL that looks like:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX - Copy the URL to your clipboard.
Tip: Create separate webhooks for separate channels. You can have one for Virtual Colleague reports and another for real-time task notifications.
Step 3: Add the Webhook to the Integration Hub
- In IntuitivePM, navigate to System → Integrations → Integration Hub.
- Open Slack Incoming Webhook.
- Create a notification channel.
- Paste the webhook URL.
- Click Test to verify the webhook works. A test message will appear in your Slack channel.
- Assign the channel to the Virtual Colleague or automation that should use it.
The colleague will now post its reports and notifications to the configured Slack channel on every scheduled run.
What Messages Look Like
Slack messages from IntuitivePM are formatted as plain text with Slack markdown. The subject line is bold and the message body follows on the next line:
*Sprint Health Report — Engineering*
3 tasks are overdue in the current sprint. Task IPM-42 "Fix login redirect"
is 2 days past its due date and assigned to Jane. Consider reassigning or
extending the sprint deadline.
The colleague’s name and role are visible in the activity log inside IntuitivePM, but the Slack message itself focuses on the actionable content.
Message Types
Virtual Colleagues can send the following types of messages to Slack, depending on their role and configuration:
| Message Type | Description | Example Roles |
|---|---|---|
| Status reports | Summary of task progress, sprint health, or project status | Scrum Master, Project Lead |
| Overdue alerts | Notifications about tasks past their due date | Scrum Master, Project Lead, Member |
| Stale-task warnings | Tasks sitting in the same status for too long | Scrum Master, Product Owner |
| Escalations | Issues that require immediate attention | All roles except Myself and Customer |
| Reminders | Nudges for team members about upcoming deadlines | Scrum Master, Manager |
Troubleshooting
| Issue | Solution |
|---|---|
| Messages not appearing | Verify the webhook URL is correct and the Slack app is still installed. Regenerate the webhook if needed. |
Slack webhook returned 403 | The webhook URL has been revoked. Create a new webhook in your Slack app settings. |
Slack webhook returned 404 | The channel was deleted or the webhook is invalid. Create a new webhook for the correct channel. |
| Test works but scheduled runs fail | Check that the colleague is active (not paused) and that the schedule is configured correctly. |
| Duplicate messages | Ensure only one webhook URL is configured per colleague per channel. |
Next Steps
- Configure Teams notifications alongside Slack with the Microsoft Teams Integration guide.
- Set up company SMTP for email delivery in Email Setup.
- Learn how to create and configure Virtual Colleagues in the Creating Virtual Colleagues guide.