Telegram ======== Enable the Telegram channel to allow ticket creation and answering from within Zammad. To configure it under *Channels > Telegram*, you need the permission ``admin.channel_telegram``. .. note:: - Your Zammad instance needs to be publicly available via HTTPS (usage of Telegram webhooks). - The attachment size is limited to 20MB by `Telegram's Bot API `_. Register a Telegram Bot App --------------------------- Register your Telegram bot via your Telegram client according to the steps below. You can find additional information in `Telegram's bot documentation `_. Go to BotFather .. image:: /images/channels/telegram/telegram_bot_start.png :alt: Screenshot shows initial BotFather chat in Telegram Register a new bot Register a new bot by using ``/newbot`` and define its name and username. .. image:: /images/channels/telegram/telegram_bot_name_and_username.png :alt: Screenshot shows BotFather chat where a new bot is created Get your API token When you're all done, you will get your Telegram bot API token .. image:: /images/channels/telegram/telegram_bot_finish.png :alt: Screenshot shows BotFather chat after creating the bot Configure Zammad as Telegram Bot -------------------------------- In Zammad's Telegram configuration, click ``Add Bot``. Enter your API token, a welcome message and a goodbye message and choose a group in which the tickets should be created. .. image:: /images/channels/telegram/telegram-configuration.png :alt: Screenshot shows Zammad's Telegram configuration dialog :align: center After successfully creating the bot by clicking the ``Submit`` button, you can see your bot now in the channel detail section. .. image:: /images/channels/telegram/telegram_created.png :alt: Screenshot shows existing Telegram bot in Zammad :align: center :scale: 80% That's it. Now you can start using the Telegram channel in Zammad. To add another bot or edit, deactivate or delete the created bot, use the respective buttons to do so.