🆕Integration with GitHub
Overview
Integrating GitHub with MangoApps offers a centralized experience for team members, ensuring everyone stays on the same page and enhancing collaboration around updates. Key features of this integration include Security & Control, Real-Time Updates, and Team Collaboration. With secure OAuth authentication, you can choose one or more GitHub repositories for notifications, and webhooks are configured via the API to eliminate manual setup. Any activities such as commits, forking, pushes, and pulls in selected repositories are converted into feeds within MangoApps Teams. Moreover, MangoApps users can comment on feeds generated for pull requests and commits.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FOiHFKdFWPQHMZ37laCa1%252Fgithub-mark.png%3Falt%3Dmedia%26token%3D522abad7-e0ea-423f-a8bb-c47a15ee7035&width=768&dpr=4&quality=100&sign=bef5edb&sv=1)
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FEdox3VKCrGOcatUiB1RF%252FGitHub_Logo.png%3Falt%3Dmedia%26token%3D6532299c-594e-4a3d-bcbf-9d92f3a88141&width=768&dpr=4&quality=100&sign=7720b97d&sv=1)
This integration supports GitHub Free, Pro, Team, and Enterprise Cloud editions, providing real-time notifications, centralized activity tracking, and improved collaborative capabilities within a secure and user-friendly environment.
Role prerequisites to set this integration
To set up this integration, specific roles are required.
GitHub Admin to set up the GitHub account, repository, and enable the webhook.
GitHub Developer to merge code to the GitHub branch
MangoApps Admin to enable the GitHub integration at the domain level
MangoApps Teams Admin to configure the integration at the team level in MangoApps
Instructions to Setup Github
First, the GitHub Admin should create a GitHub account and add the code repository where code will be compiled and merged to a “main” branch.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FJIrCXif3SCwmTsPoJHrd%252Ftryjfyuktryths.png%3Falt%3Dmedia%26token%3D89a7a7a1-83bc-4f71-94a0-75334ccc8b76&width=768&dpr=4&quality=100&sign=1eae4204&sv=1)
Software Developers can install GitHub Desktop locally to write code in their local repository, commit changes, and push changes to GitHub Cloud.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FZ22i335QjmhKkYOK3yAX%252Fsrtjykryut.png%3Falt%3Dmedia%26token%3Dfd382939-2501-4ea7-a481-25ed84688d11&width=768&dpr=4&quality=100&sign=7fece7b3&sv=1)
Next, the integration between GitHub and MangoApps needs to be enabled from the MangoApps side.
Instructions to Setup MangoApps
Configuration for Domain Admins in MangoApps
The MangoApps domain administrator needs to open the admin portal, navigate to the Integrations section, and toggle "GitHub" to ON.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FirKuTXkBUmU7BAoKDwjv%252Fmhjukfyuky.png%3Falt%3Dmedia%26token%3D85777e86-33c0-4d8a-ab1d-63bb19e781a6&width=768&dpr=4&quality=100&sign=f0ad0942&sv=1)
Next, the network administrator should set up the GitHub widget for the HOME page by adding it from the widget gallery.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FsT9IihOGpMerNNpJLf9H%252Fvbnxfgxd.png%3Falt%3Dmedia%26token%3D23e1a961-1a4b-4329-94a6-43e3ab78d0e9&width=768&dpr=4&quality=100&sign=cf48dda2&sv=1)
The widget should be configured by adding a header image and setting up the visibility setting for a specific user segment or everyone.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FyWe1p7D7ft1WTFW9o5i5%252Fgaerhgzsdfv.png%3Falt%3Dmedia%26token%3D06b975d0-3c5a-463c-8ab7-d0792d73c87d&width=768&dpr=4&quality=100&sign=6222badf&sv=1)
Since GitHub updates are primarily meant for the Software Engineering Team, setting up a user segment will limit these updates to the particular team only.
Configuration for Team Admins in MangoApps
Once the network admin enables GitHub, the team admin needs to enable the integration in the team where GitHub notifications should be received. To do this, the team admin should navigate to the relevant project on MangoApps and enable the integration there by clicking on "Admin tools" > "Configure Integrations" > "GitHub Settings."
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FjgDEA6m42d1meNLPhTwQ%252Fvdsgzfxnc.png%3Falt%3Dmedia%26token%3Db6c756ea-a95c-424a-b5a6-8e4a958da941&width=768&dpr=4&quality=100&sign=c0b0fb38&sv=1)
Upon enabling the GitHub integration, a popup will appear, prompting you to authenticate your GitHub account by entering the “administrator” user credentials of your GitHub account and its URL.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252F1YMzQxDDkCzTKZ0oUQza%252Fw3r2q4y.png%3Falt%3Dmedia%26token%3Db8018731-6e78-4ecd-a187-a4a4e26449d6&width=768&dpr=4&quality=100&sign=f26e1c1&sv=1)
After authenticating successfully, team administrators will need to select the GitHub repository from which the notification is to be synced into MangoApps.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FKgq04mD4Itixtatsb34Y%252Fvbtdyjsher.png%3Falt%3Dmedia%26token%3D5a3d6f98-b6b8-45ef-8af8-ae68c66dd52a&width=768&dpr=4&quality=100&sign=aa2b76ba&sv=1)
Finally, set up team members who have permission to post comments submitted in MangoApps back into GitHub.
End User Experience
When a Software Developer commits the code in GitHub and merges it to the “main” branch, a notification will be triggered and displayed in the news feed of the team.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FR5ypT1SxsQH8nBnXucfP%252Fsrgawerbdfbz.png%3Falt%3Dmedia%26token%3D178035ac-7729-487d-8663-535fc36bf94d&width=768&dpr=4&quality=100&sign=e1b4e3&sv=1)
Key details of these notifications include:
Commit ID: A GitHub commit ID is a unique 40-character identifier for each commit in a repository, used to reference and manage specific changes.
Reported By: Logged-in GitHub user who had added, updated and modified the code in Github repository.
Type: A commit in GitHub is a snapshot of changes made to a repository's files, identified by a unique ID and accompanied by a descriptive message. In GitHub, besides commits, other key types include branches, tags, pull requests, issues, and releases.
Repository: A GitHub repository is a storage space for a project, containing all the files, history, and revision tracking for the project.
Commit Message: A commit message in GitHub is a descriptive summary of the changes made in a commit, providing context and clarity to collaborators about the purpose and content of the changes.
Committed On: Date and time at which the commit is submitted in the GitHub branch
Author: GitHub developer user
GitHub Widget
Additional features of the integration include user segment-based dashboard widget configuration, allowing only a specified set of people to see the GitHub widget on their Home page.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FOVK4ALP7WQPcQySTwccD%252Ffgnsrysrt.png%3Falt%3Dmedia%26token%3D03ee2d4a-9bc5-4213-8285-cb97f07642b5&width=768&dpr=4&quality=100&sign=accb0c2b&sv=1)
GitHub on the Newsfeed
Clicking on widget items pops up the newsfeed with notification details and allows users to reply.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FKWbL3RAhpFEYJVCDr6Sb%252Fcdwfret.png%3Falt%3Dmedia%26token%3D71cff184-7adb-4d1d-8bcc-fd8ef85cc428&width=768&dpr=4&quality=100&sign=5c9d8cad&sv=1)
The development team can reply on the GitHub news feed, and the response is submitted to GitHub.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FDLWkpdgKpx9ROmHsc0SV%252Fsrjdgfvaewr.png%3Falt%3Dmedia%26token%3Dbb97f675-25fb-4da5-aa1c-6138bff81dda&width=768&dpr=4&quality=100&sign=25b52d55&sv=1)
Likewise, GitHub users can read MangoApps submitted comments and reply from GitHub.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252FqpI2PoTPWhuaZhjmZcOp%252Fsyujnbvcew.png%3Falt%3Dmedia%26token%3D51af2e88-e1c2-4fec-95ba-01f51adec9e6&width=768&dpr=4&quality=100&sign=d594b78e&sv=1)
MangoApps users can search GitHub notifications using a search term from the reply of the feed.
![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1627138357-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LjKbJ2ssjhlUZRcGOXW%252Fuploads%252F1BvumQIP7jZDYFTdGqDg%252Fy98ukmjnrge.png%3Falt%3Dmedia%26token%3D7fb4ca57-5505-425f-8d80-d79f1806d98b&width=768&dpr=4&quality=100&sign=ecb73d03&sv=1)
Testing Considerations
A team admin or network admin can follow these steps to test the integration:
Ensure the authentication credentials in MangoApps are entered correctly
Set up the project members who have permission to post back to GitHub
Finally, test the workflow and verify that only the required GitHub repository is selected for notifications in MangoApps.
Security Considerations
GitHub admin should share the credentials only with the teams/network Admin of MangoApps to complete the integration.
Any comments posted for internal collaboration should not have the Post to GitHub checkbox selected.
Rollout Recommendations
Once the MangoApps GitHub integration is complete, team members can view news feeds for all tickets in the MangoApps teams where the integration is enabled. Ensure that all necessary customer service team members are added to the integration settings on the MangoApps side so they can reply to tickets created in GitHub.
By following these steps, teams can seamlessly integrate GitHub with MangoApps, enhancing collaboration and ensuring that all team members stay informed about the latest updates and activities.
Last updated