social/mail_gateway_telegram

====================
Mail Telegram Broker
====================

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-tegin%2Fcb--addons-lightgray.png?logo=github
    :target: https://github.com/tegin/cb-addons/tree/13.0/mail_broker_telegram
    :alt: tegin/cb-addons

|badge1| |badge2| |badge3| 

This module allows to respond telegram chats as a telegram bot.

This way, a group of users can respond customers or any other set
of partners in an integrated way.

It is not intended to be integrated on default chatter as users don't need
to review again when one has responded.

**Table of contents**

.. contents::
   :local:

Configuration
=============

Create the bot
~~~~~~~~~~~~~~

1. Create a Bot on telegram https://core.telegram.org/bots
2. Create a broker following the examples on
   https://github.com/tegin/telegram-broker with the TOKEN provided


Configure Odoo
~~~~~~~~~~~~~~

1. Access on debug mode
2. Access `Settings > Technical Settings > Email > Telegram Bot`.
3. Create a bot and assign the token. Mark it as `Show on App`

Usage
=====

1. Access `Telegram`
2. Wait until someone starts a conversation with your bot.
3. Now you will be able to respond and receive messages to this person.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/tegin/cb-addons/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/tegin/cb-addons/issues/new?body=module:%20mail_broker_telegram%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Creu Blanca

Contributors
~~~~~~~~~~~~

* Enric Tobella <etobella@creublanca.es>
* Olga Marco <olga.marco@creublanca.es>

Maintainers
~~~~~~~~~~~

This module is part of the `tegin/cb-addons <https://github.com/tegin/cb-addons/tree/13.0/mail_broker_telegram>`_ project on GitHub.

You are welcome to contribute.