Slack Integration Configuration
This guide provides detailed instructions for setting up the Slack integration in IntuitivePM. The integration uses Slack incoming webhooks to deliver notifications, Virtual Colleague messages, and project updates directly to your Slack channels.
Prerequisites
- A Slack workspace where you have permission to install apps.
- An IntuitivePM account with admin or owner permissions for your company.
Setup
Open your browser and go to api.slack.com/apps. Click Create New App, select From scratch, and enter an app name (we recommend “IntuitivePM”). Select the Slack workspace where you want the integration to post messages and click Create App.
In the left sidebar of your Slack app settings, click Incoming Webhooks and toggle the switch to On. Click Add New Webhook to Workspace, select the channel where you want notifications (e.g., #project-updates), and click Allow. Copy the generated webhook URL:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXLog in to IntuitivePM and navigate to Settings > Integrations > Slack. Paste your webhook URL into the Slack Webhook URL field. Click Test Connection to verify — you should see a test message in your Slack channel. Click Save.
Customize which events trigger Slack notifications:
- Project Updates — New tasks created, status changes, and assignments.
- Sprint Events — Sprint start, sprint end, and health score alerts.
- Virtual Colleague Reports — Automated reports and scan results.
- Mentions and Comments — When team members are mentioned or new comments are added.
Toggle each notification type on or off based on your team’s preferences.
Go to any project in IntuitivePM, create a test task or add a comment, and check your Slack channel to confirm the notification was delivered. If using Virtual Colleagues, trigger a manual scan and verify the report appears in Slack.
You can create multiple webhooks for different channels. For example, use one channel for Virtual Colleague reports and another for sprint notifications. Each Virtual Colleague can have its own webhook URL.
Troubleshooting
| Issue | Solution |
|---|---|
| Messages not appearing in Slack | Verify the webhook URL is correct and the Slack app is still installed in your workspace. |
| ”channel_not_found” error | The channel may have been renamed or deleted. Create a new webhook for the correct channel. |
| Duplicate messages | Check that you do not have multiple webhook URLs configured for the same channel. |
| Test works but real notifications fail | Ensure notification preferences are enabled for the event types you expect. |
For additional help, see the Common Issues page or contact support.