Skip to main content

GitHub Bot

GitPOAP has built an opt-in GitHub bot that has two functions:

  • Real-time awarding & notifications: for each PR that earns the contributor a GitPOAP, the bot will automatically detect & immediately reward a GitPOAP. It'll post a nice note and it will only post once per contributor per year. Without this, it takes a couple hours for your GitPOAPs to be awarded.
  • Ad-hoc awarding: a maintainer can tag the bot to award your GitPOAP to anyone deserving (eg submitted a valuable Issue), so you are no longer limited to merged PRs. For example: Nice job @wackerow! Here's a GitPOAP to show our appreciation @gitpoap-bot

An example bot notification:

Installing on your Project

If you'd like gitpoap-bot to start notifying your contributors when they've received a GitPOAP for their contribution, first navigate to the GitHub App page for the gitpoap-bot. On the top right you should see a configure button:

Click on this link and then click on the organization you'd like to add the bot to:

You will be taken to an installation configuration page for your GitHub Organization. From here, you should scroll down to the "Repository Access" section, click on the "Only select repositories" option, select any repos that have GitPOAPs associated with them, and then hit "Save" underneath. As an example, we at GitPOAP have created a GitPOAP for the repository for this documentation:

And that's it! Now gitpoap-bot will start notifying users when their merged PRs have earned them new GitPOAPs.

Enabling GitPOAP notifications

GitPOAP notifications are enabled by default once the bot is installed, so there is nothing additional you need to do. If you'd like them to be disabled you can either uninstall the bot or reach out to our team on our discord and we can disable it so you can still use the tagging functionality.

Tagging contributors

Gitpoap-bot also has the capability to issue GitPOAPs to contributors by tagging them in a comment. When both @gitpoap-bot and one or more contributors' handles are tagged within a comment on a PR or Issue, a new GitPOAP claim will be issued to these users if they don't have one already.

For example, to issue a new GitPOAP to a GitHub user via a PR or Issue, add a comment with @gitpoap-bot tagged like so:

Note: @gitpoap-bot can appear anywhere in the comment, & the names of contributors do NOT have to directly follow @gitpoap-bot.


What permissions does the bot have?

The bot has permissions to read and write comments on Issues and PRs. The bot does not have the ability to merge PRs.