A web server to receive webhooks from many online services and forward the information to many different messaging platforms, like Telegram or Slack, using a different template for each.

A service represents any web service that sends a webhook.

An event is identified from the given webhook (like a push on Github, for example)

A comm is then used to publish information from this hook in messaging services.

Dependencies

• Python 2.7

sudo pip install -r requirements.txt

Running

Run without deamon:
python captain_hook/endpoint.py

Run with deamon (required for the /update telegram command):

./daemon.sh install
/etc/init.d/hook-bot start

Acces the WebGui with the following url: https://YOURWEBSERVERADRES:5000/admin/

Currently supported services and events

• Github
• Bitbucket
• Docker
• Pagerduty
• Patreon
• Scrutinizer
• Codacy
• Slack
• Travis
• CircleCI
• Telegram (can be used as telegram bot)
• Zabbix (In combination with this script)

Currently supported comms to publish event information

• Telegram
• Slack
• Discord
• Mattermost

Documentation

See our documentation on Readthedocs

Contributors

• Brantje
• Maestroi

Error logging

We use sentry.io for error logging. This enables us to trackdown issues quickly. If you don't want this you can turn it off by setting global.enable_sentry to false in config.yml