First, create a unique Webhook to integrate with workSonar. To do this, open the repository you want to monitor

Select Repository Settings then go to the Webhooks tab on the next screen in the settings.

Image: Github Webhook Settings

To create a new Webhook that will notify workSonar about employee activity, click the Add Webhook button on the Webhooks tab in the Settings.

Image: Github Add Webhook Button

On the form, fill in the parameters for the new Webhook. The title is used to identify the Webhook, and we suggest naming it workSonar to make it clear where the data is being sent.

To collect user activity from the repository, you need to enter the URL where the data will be transmitted.

An important parameter is the Secret You can generate it or create it manually.

Each repository should have one Webhook and oneSecret and may have unlimited integrated user.

Image: Github Url and Secret Form

Please make sure that SSL verification is activated.

Image: Github SSL Section

The next step in the form is to check the Active selector in the Status section. This will help avoid duplicates and unnecessary data.

Image: Github Status Section

In the next Triggers section, select Push as the only option.

Image: Github Triggers Section

You are now ready to save the form by clicking the Save button and then navigate to the /integrations page on the workSonar portal to start adding users for activity monitoring.

After successfully integrating the Github Webhook, you can proceed to add users for monitoring.

To add a new user, go to the Github section on /integrations tab

Image: Github Integration Tab

First, select a user from the list of available Slack users to whom you want to assign the Github repository.

Image: Select Slack User

To obtain the Github Author Username, go to your Github project, then select the settings icon from the header and navigate to the Collaborators page

In the Manage access section, find the user you want to assign to the selected Slack user on the workSonar page.

Image: Github User Management Page

Copy User Nickname or go to the user's page by clicking on their entry in the user table.

Image: Github User Nickname Value

Paste the copied value into the Github Author Username field on the workSonar form.

Image: Github User Nickname Input

To fill in the Github Repository Full Name, go to your project page and copy the organization name and the project name also.

This is called the Full Name, separated by a /, slash character.

You can also find this name in your browser's address bar.

Image: Github Repository Full Name

Image: Github Repository Full Name Url

Then paste the value into the Github Repository Full Name text field.

Please ensure that the name does not contain any additional characters, as this is the only way we can correctly identify the integration.

Image: Github Repository Full Name Input

Image: Github Webhook secret form

After pressing the Add button, your configuration should appear in the table of integrated repositories below.

Image: Github User Integrated Success

From now on, when the user sends monitored events, a pulsing identifier indicating the event will appear next to their activity on the /dashboard tab.

Clicking on the identifier will open a modal with a list of activities within the specified time frame.

Image: Commit Event Identifier

To remove a repository assigned to a user, go to the /integrations page and select the Github tab.

Choose the user from the selector and scroll down to review the assigned repositories.

Image: Select Slack User

Image: Github User Integrations

Click the red delete button next to the desired repository.

A confirmation modal will appear, informing you that the data will be permanently deleted from the database.

To remove a full integration, the best method is to delete each Github repository assigned to each user. However, this isn't necessary.

Simply go to your repository and delete the previously added Webhook.

Image: Github Webhooks List