diff options
Diffstat (limited to 'doc/bitbucket-webhooks.markdown')
| -rw-r--r-- | doc/bitbucket-webhooks.markdown | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/bitbucket-webhooks.markdown b/doc/bitbucket-webhooks.markdown new file mode 100644 index 00000000..7f59aa11 --- /dev/null +++ b/doc/bitbucket-webhooks.markdown @@ -0,0 +1,55 @@ +Bitbucket webhooks +================== + +Bitbucket events can be connected to Kanboard automatic actions. + +List of supported events +------------------------ + +- Bitbucket commit received +- Bitbucket issue opened +- Bitbucket issue closed +- Bitbucket issue reopened +- Bitbucket issue assignee change +- Bitbucket issue comment created + +List of supported actions +------------------------- + +- Create a task from an external provider +- Change the assignee based on an external username +- Create a comment from an external provider +- Close a task +- Open a task + +Configuration +------------- + + + +1. On Kanboard, go to the project settings and choose the section **Integrations** +2. Copy the Bitbucket webhook url +3. On Bitbucket, go to the project settings and go to the section **Webhooks** +4. Choose a title for your webhook and paste the Kanboard url + +Examples +-------- + +### Close a Kanboard task when a commit pushed to Bitbucket + +- Choose the event: **Bitbucket commit received** +- Choose the action: **Close the task** + +When one or more commits are sent to Bitbucket, Kanboard will receive the information, each commit message with a task number included will be closed. + +Example: + +- Commit message: "Fix bug #1234" +- That will close the Kanboard task #1234 + +### Add comment when a commit received + +- Choose the event: **Bitbucket commit received** +- Choose the action: **Create a comment from an external provider** + +The comment will contains the commit message and the url to the commit. |