Skip to content

A bot created to replace the official Bitbucket Cloud bot for Webex, which has been sunsetted.

License

Notifications You must be signed in to change notification settings

Ralkage/webex-bitbucket-cloud-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Webex Bitbucket Cloud Bot

Description

A bot created to replace the official Bitbucket Cloud bot for Webex, which has been sunsetted. This bot listens to events from Bitbucket and sends notifications to a Webex room.

Features

  • Receives webhook events from Bitbucket
  • Sends formatted messages to a Webex room
  • Uses markdown for message formatting

Requirements

Installation

  1. Clone the repository:
   git clone https://github.com/Ralkage/webex-bitbucket-cloud-bot.git
   cd webex-bitbucket-cloud-bot
  1. Install dependencies:
npm install
  1. Create a .env file in the root directory of the project and add your Webex bot token and room ID:
WEBEX_BOT_TOKEN=your_webex_bot_token
WEBEX_ROOM_ID=your_webex_room_id

Local Development Setup

  1. Install ngrok if you haven't already. ngrok is a tool that creates a secure tunnel to your local server, allowing external services to access it. You can download ngrok from ngrok's website or install it using a package manager like Homebrew:
brew install ngrok
  1. Start your local server:
npm start
  1. Expose your local server to the internet using ngrok. In a new terminal window, run:
ngrok http 3000

This will provide you with a public URL (e.g., http://your-ngrok-url.ngrok.io) that you can use to configure Bitbucket webhooks.

  1. Configure Bitbucket webhooks to point to the ngrok URL. Go to your Bitbucket repository settings and add a new webhook with the URL provided by ngrok (e.g., http://your-ngrok-url.ngrok.io/webhook).

Contributing

Feel free to fork the repository and submit pull requests. Please ensure that your code adheres to the existing coding style and includes tests where applicable.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Christian Lopez (Ralkage)

About

A bot created to replace the official Bitbucket Cloud bot for Webex, which has been sunsetted.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published