MyRepoBot - Documentation

On this page, we are collecting mini guides and answers to the most frequently asked questions. If you couldn't find an answer to your question, or experience any issues using MyRepoBot, feel free to reach out to us through myrepobot@redwerk.com
General
Telegram
Discord
Google Chat

General

‍

What is MyRepoBot?

MyRepoBot is a bot that allows you to integrate with your Github, Gitlab or Bitbucket repositories. MyRepoBot works in Telegram, Discord and Google Chat. Manage your integration using simple commands to retrieve updates in repositories and get reminders about pending pull requests.

‍

Can I use MyRepoBot for self-hosted Github/Gitlab solutions?

Yes, you can use the bot for both - Self-hosted (Server) and Cloud repositories providers. However, you will have different authorization methods for Cloud and Self-hosted repository:

  • Authorization token. This method is only available for Bitbucket, GitHub Cloud and GitLab Cloud. It isn't available for Self-hosted GitHub and GitLab. To use it you need to create an auth token in your repository provider account and share it with the bot. With this method you will be able to subscribe to all available repositories where have enough permission to do so.
  • Webhook created manually. This method is available for Bitbucket and both Cloud and Server instances of GitHub and GitLab. However, for Cloud repositories we recommend to use Authorization Token, cause it gives more customization features for your subscription. To use authorization via webhook you need to add a webhook to EACH of your repositories manually. You can ask your repository admin to do this instead of you.

‍

Why don't I see all my repositories in the list of repos in MyRepoBot when I set up notifications?

The issue may be that you don't have all needed permissions to set up notifications in some repositories.

  • GitHub: only Owner can configure notifications in a repository, regardless of whether it's a public or private repository. Collaborator does not have such rights. So in the list of available repositories, you will only see repositories where you have Admin permissions.
  • GitLab: Maintainer and Owner roles can configure notifications, it doesn't matter if the repository is private or public. So in the list of available repositories, you will only see repositories where you have Owner or Maintainer permissions.
  • Bitbucket: only repository Admin can configure notifications, regardless it's public and private repository. So in the list of available repositories, you will only see repositories where you are Admin.

‍

Can I subscribe to all repositories?

If you use an Authorization token when setting a subscription you can choose the repository you want to subscribe to or choose the option 'All repositories' to subscribe to all repositories.

If you use Manual Webhooks when setting a subscription, you must add a webhook to each repository you want to subscribe to. So, in general, you can subscribe to all repositories, but it will take more time.

‍

What is a reminder in MyRepoBot?

Reminders are scheduled messages that you receive with a set-up frequency about Pull requests that are stuck in the open state for some time. For example, in your project group, you can set up that you want to get a reminder every day at 10 a.m. about PRs that are open for more than 2 days. Doing so can encourage your team to review them and deliver code faster.

‍

Why don't I see all my repositories in the list of repos in MyRepoBot when I set up reminders?

The issue may be that you don't have all needed permissions to set up reminders in some repositories. In GitLab Reporter, Developer, Maintainer, and Owner can set up reminders, but not Guest. In Bitbucker, it's enough to have Read access to the repo, in GitHub it's enough to be a colloborator to set up reminders.

‍

Which repo events does MyRepoBot support?

  • New branch was pushed
  • Changes was pushed to branch
  • Changes was FORCE pushed to branch (only for Github and Bitbucket)
  • Branch was deleted
  • Repository was forked (only for Github and Bitbucket)
  • Repository settings was changed (only for Bitbucket)
  • Build in progress
  • Build successful
  • Build failed
  • New Issue created
  • Issue was updated
  • Issue was closed
  • New Pull Request/Merge Request
  • Pull Request was changed
  • Pull Request Approved
  • Pull Request Approval removed (only for Gitlab and Bitbucket)
  • Pull Request Changes requested (only for Github and Bitbucket)
  • Pull Request Change request cancelled (only for Bitbucket)
  • Pull Request Merged
  • Pull Request Declined
  • New comment in the commit
  • New comment in the issue
  • New comment in Pull Request
  • Comment in the Pull Request was deleted (only for Github and Bitbucket)

‍

What includes 'My updates' subscription?

  • You was assigned to an Issue
  • You (or group you are included to) was tagged in a comment / PR or issue description
  • Issue you created was updated
  • Issue you assigned was updated
  • PR you created was updated / approved / merged / etc
  • PR you assigned was updated / approved / merged / et

‍

How to disconnect my account from the bot?

If you used Authorization Token to disconnect your account you need to go to /help > Remove your repository credentials. Your authorization token and all subscriptions and reminders settings will be deleted after this.

If you have added a webhook manually, you need to remove it from your repository.

‍

Does the bot has localizations?

No, MyRepoBot only has English version.

Telegram

‍

How do I get started in Telegram?

1. Open t.me/my_repobot

2. Click "Start"

3. Enter /connect command

4. Choose the 'Add or edit credentials' option

5. Choose your repository provider - Github, Gitlab, or Bitbucket.

6. You must create an access token for the app from your Github/Gitlab/Bitbucket account. Follow the instructions for the selected repo.

‍

Can I use the bot in the Telegram Channel?

No, the bot doesn't support Channels in Telegram, but you can still use it in Telegram Group.

‍

Can I connect several repositories to the bot?

Telegram and Google Chat. You can simultaneously connect multiple repos (Github, Gitlab, or Bitbucket) types using different chats. However, you are restricted to using one account for any repo type in one chat. So you can't use Github and Gitlab accounts or two Bitbucket accounts in the same chat, for example. If you want to do so, you can create a group chat with the bot and connect the bot to another account there.

Discord. You only can use one Repository (GitHub or GitLab or Bitbucket) account per Discord server.

Start Using in Telegram

Discord

‍

How do I get started in Discord?

To add the bot to Discord Server you must have Manage Server permission in the server.

Follow the link to add the bot to your space in Discord: https://discord.com/api/oauth2/authorize?client_id=1166718780311879750&permissions=0&scope=applications.commands%20bot

After you add the bot to the server, it becomes available in all channels. However, the bot will send reminders and notifications only in the channel where you set up them.

‍

Can I connect several repositories to the bot?

You only can use one Repository (GitHub or GitLab or Bitbucket) account per Discord server.

‍

How to set up the bot to send notifications in the selected channel in Discord?

MyJiraBot sends notifications to the channel where you set up the bot. For example, if you used the /watch command in #general to set up notifications - the bot will send notifications to this channel. So you need to select the channel you want to receive notification, use /watch command there > Add new subscription > and finish the subscription flow. Then, the bot will send messages to this channel.

‍

Why I get 'bot doesn't have permission to send messages to the channel' error in Discord?

It seems you added the bot to the private channel without adding permission to send notifications to it. To fix this, go to Edit Channel > Permissions > Add members and roles > Find and add the bot.

‍

How to restrict channels the Discord bot can be used by slash commands?

Firstly, click the icon of your server located on the left side of the screen. Next, hover over ‘Server Settings,’ choose ‘Integrations’ and find 'Bots and Apps'.  In the bot's settings, you can change which members or roles can use commands and which channels allow commands. To limit the bot to one channel, select ‘Add Channels’ next to the ‘Channels’ menu. Then, select the channel in which you want to allow commands. You can also select multiple channels if you want to allow commands in more than one channel.

‍

How to delete the bot from Discord server?

To completely delete the bot from your server you need to go to Server Settings > Member > Click on three dots near MyRepoBot and choose 'Kick MyRepoBot' option.Your authorization token and all subscriptions and reports settings will be deleted after it.

Start Using in Discord

Google Chat

‍

How do I get started in Google Chat?

1. Open your Google Chat home page

2. Find and click on + button on the left sidebar near the 'Chat' title.

4. Type 'MyRepoBot' in the search

5. Click on Add > Chat or Space to start chat with the bot

6. Click 'Connect to Git'

7. Choose your Git type and follow the instructions. You must create an access token for the app from your Github/Gitlab/Bitbucket account.

‍

Can I connect several repositories to the bot?

You can simultaneously connect multiple repos (Github, Gitlab, or Bitbucket) types using different chats. However, you are restricted to using one account for any repo type in one chat. So you can't use Github and Gitlab accounts or two Bitbucket accounts in the same chat, for example. If you want to do so, you can create a group chat with the bot and connect the bot to another account there.

Start Using in Google Chat