GitHub
Links pull requests and commits to tickets. This app only receives; nothing is sent to GitHub.
Setup
- In Stoneity open Settings → Apps → Marketplace → GitHub → Install, enter a webhook secret you choose, and pick what should happen on open, on push and on merge.
- Copy the inbound address from Installed apps → GitHub → Settings.
- In GitHub open the repository (or organisation) Settings → Webhooks → Add webhook:
- Payload URL — the inbound address
- Content type —
application/json - Secret — the same secret you entered in Stoneity
- Events — Pull requests and, if you enabled commit notes, Pushes
How tickets are matched
A ticket number in the pull request title, branch name, description or a commit message links that pull request to the ticket:
INC-1042 fix printer queue
feature/INC-1042-printer-queue
Fixes INC-1042One pull request can reference several tickets, and each of them gets the link and the notes.
Behaviour
| Change | Result |
|---|---|
| Pull request opened or reopened | Link created, internal note on the ticket |
| Pull request merged | Note, and the ticket is resolved if you chose that |
| Pull request closed without merge | Note, link marked closed |
| Commit pushed mentioning a ticket | Internal note with the commit message, if enabled |
The pull request appears on the ticket under the Links tab, showing its current state.
Notes
- Every request must carry a valid
X-Hub-Signature-256computed with your secret; unsigned or mismatched requests are rejected and logged. - Lowercase references (
inc-1042) are ignored on purpose, so ordinary prose does not create links.