Metadata-Version: 1.0
Name: cabot-alert-telegram
Version: 0.2
Summary: A Telegram alert plugin for Cabot by Arachnys
Home-page: https://github.com/codesyntax/cabot_alert_telegram
Author: Mikel Larreategi
Author-email: mlarreategi@codesyntax.com
License: GPL
Description: =====================
        Cabot Telegram Plugin
        =====================
        
        Based on: https://github.com/lblasc/cabot-alert-slack
        
        This is an alert plugin for the cabot service monitoring tool. It allows you to alert users using a `Telegram`_ chat room.
        
        Installation
        ==============
        
        Enter the cabot virtual environment::
        
            $ pip install cabot_alert_telegram
            $ foreman stop
        
        
        or::
        
        
            $ pip install git+git://github.com/codesyntax/cabot_alert_telegram.git
            $ foreman stop
        
        
        Edit `conf/*.env`::
        
        
            CABOT_PLUGINS_ENABLED=cabot_alert_telegram=0.2
            ...
            TELEGRAM_BOT_TOKEN=bot_token
            TELEGRAM_CHAT_ID=id of the chat where messages will be sent
        
        
        Add cabot_alert_telegram to the installed apps in settings.py::
        
            $ foreman run python manage.py syncdb
            $ foreman start
        
        
        Telegram Bot
        ============
        
        You need to create a Telegram bot which will be used to send the messages to the users. To create a new Telegram Bot check the official documentation at https://core.telegram.org/bots
        
        You need to create a new Group Chat, add all your users to that chatroom and add also the Bot there.
        
        To get the chat id, open https://telegram.me and select the group chat you previously created. Check the URL, it will be something like this::
        
            https://web.telegram.org/#/im?p=g99999999
        
        You need to not the value of p parameter (g99999999) and exchange **g** with a **-**: **-g99999999**
        
        This is a bit hacky, but I don't know any other way to get the group id.
        
        
        .. _Telegram: https://telegram.org
        
        0.2 (2015-07-02)
        ================
        
        - document the bot [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - reformat message [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - reformat [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - docs [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - Merge remote-tracking branch 'origin/master' [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - Update README.md [Aitzol <anaberan@codesyntax.com>]
        
        
        
        0.1 (2015-07-02)
        ================
        
        - history! [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
        - version [Mikel Larreategi <mlarreategi@codesyntax.com>]
        
Platform: UNKNOWN
