How to Connect and Manage External Platform Integrations in devActivity

devActivity's 'Integrations' section within 'Settings' allows you to connect with various external platforms, consolidating your development activities and enhancing team visibility. This guide will walk you through the process of connecting and managing these integrations.

To get started, navigate to the 'Settings' section in the main navigation bar and then select the 'Integrations' tab.

Connecting Code Repository Platforms

Beyond the default GitHub integration, you can connect other code repositories to track developer activity comprehensively.

1. Access Integrations: From your devActivity dashboard, click 'Settings' in the top navigation, then select the 'Integrations' tab.
2. Locate Code Repositories: Scroll down to the 'CODE REPOSITORY PLATFORM' section.
3. Connect Bitbucket or GitLab: Find 'Bitbucket' or 'GitLab' in the list. Click the 'Manage App' link next to your desired platform.
4. Authorize Connection: Follow the on-screen prompts to authorize devActivity's access to your Bitbucket or GitLab account. This typically involves logging into the external platform and granting permissions.
5. Verify Integration: Once authorized, devActivity will begin tracking code activity from the integrated platform.

Integrating Task Tracker Systems

Connect your task management systems to pull issue data into devActivity for richer analytics and project insights.

1. Access Integrations: Navigate to 'Settings' > 'Integrations'.
2. Locate Task Trackers: Scroll to the 'TASK TRACKER' section.
3. Install/Manage App: For platforms like Jira, Asana, ClickUp, or Trello, click the relevant action link (e.g., 'Link Users', 'Configure Projects', 'Reinstall').
4. Link Users (for Jira, Asana, ClickUp, Trello): Click 'Link Users'. This step is crucial for mapping devActivity users to their corresponding accounts in the task tracker, ensuring accurate attribution of work.
5. Configure Projects (for Jira, Asana, Trello): Click 'Configure Projects'. Select which specific projects from your task tracker devActivity should monitor for issue data. This allows you to control the scope of data ingested.
6. Reinstall (for Jira): If you encounter issues with an existing Jira integration, you can click 'Reinstall' to re-establish the connection and refresh permissions.
7. Switching Issue Source: Once a task tracker like Jira is integrated and configured, devActivity will prioritize pulling issue data from it instead of GitHub for the selected projects.

Configuring Communication Platform Integrations

Set up communication platforms to receive automated reports, alerts, and notifications directly in your team's chat channels.

1. Access Integrations: Go to 'Settings' > 'Integrations'.
2. Locate Communication Platforms: Scroll to the 'COMMUNICATION' section.
3. Connect Slack: Find 'Slack' and click the 'Manage App' link. Follow the prompts to authorize devActivity and select the Slack channels where you want to receive reports, alerts, achievements, and challenge notifications.
4. Install Microsoft Teams or Google Chat: For 'Microsoft Teams' or 'Google Chat', click the 'Install App' link. This will guide you through adding the devActivity app to your respective communication platform.
5. Verify Notifications: After setup, you can typically test the integration to ensure notifications are being sent correctly to your chosen channels.

By following these steps, you can effectively connect and manage your external platform integrations, centralizing your development workflow and maximizing the value of devActivity's analytics.