Skip to content
This repository has been archived by the owner on Sep 9, 2024. It is now read-only.

How it works

Gus edited this page Apr 9, 2018 · 1 revision

Gello works by subscribing Trello boards to GitHub repositories through a web UI, and selecting the corresponding Trello lists you would like cards to be created to following a GitHub event.

GitHub Webhooks

Gello uses GitHub webhooks to get event updates from the repositories subscribed.

When a subscription is made, Gello will create a GitHub webhook on the corresponding repository with the following permissions: Issues, Issue comments, Pull requests, and Pull request review comments.

This will allow the server to receive webhook events whenever an issue or pull request is created or commented upon. They are necessary for both the autocard and manual settings.

GitHub Events

Pull Request Event

For the autocard setting, if a pull request is created by a person outside of the members of a GitHub organization on a subscribing repository, a Trello card will be submitted to a board list (or a number of lists), configurable in the Gello web-UI.

Issue Event

Likewise, for the autocard setting, if an issue is created by a person outside of the members of a GitHub organization on a subscribed repository, a Trello card will be submitted to a board list (or a number of lists), configurable in the Gello web-UI.

Pull Request Comment Event

For the manual setting, if a pull request has been created, and a member of the GitHub organization comments gello create_card on the pull request, a Trello card will be submitted to a board list (or a number of lists), configurable in the Gello web-UI.

Issue Comment Event

For the manual setting, if an issue has been created, and a member of the GitHub organization comments gello create_card on the issue, a Trello card will be submitted to a board list (or a number of lists), configurable in the Gello web-UI.