Telegram Integration

Installation

• Install this module in according to us_messenger Documentation

Configuration

In Telegram

• Send message /start then /newbot to @BotFather and follow further instructions to create a bot and get its token

In Odoo

• Activate Developer Mode
• Open menu [[ Settings ]] >> Technical >> Parameters >> System Parameters
• Check that parameter web.base.url is properly set and it's accessible over internet (it should not be a localhost). Also, telegram accepts https addresses only (i.e. not http). If you can use only localhost, use ngrok
• Open menu [[ Messengers ]] >> Messengers
• Select Kanban card with telegram icon and name 'Enter_bot_name' project
• Enter token from @BotFather to field token
• Enter bot name and select the operators with which the user will contact
• Unarchive the project
• Click button [Run Now] in the upper left corner

Usage

Conversation in Discuss menu

In Telegram:

• begin conversation with created bot
• enter contact data (email, phone number) optionally
• click button 'Connect with operator'

In Odoo:

• Open [[ Discuss ]] menu
• RESULT: two contact records will be created, child and parent. Later, other children from different messengers can join the parent record
• RESULT: there is channel with name Telegram:<TELEGRAM NAME> (the prefix can be configured in project parameter PARTNER_NAME_PREFIX). If you don't see, refresh current page
• Open the channel and reply to message

In Telegram:

• RESULT: the message is delivered via bot

You can continue chatting this way

Conversation in any document where there is a chatter

In Odoo:

• Make sure that in the [[ Messengers ]] >> Messengers >> <Your bot name> >> Parameters you have 'yes' written in DUPLICATE_MESSAGE_BY_ANSWER
• Add followers to chatter by clicking on button 'Add followers'. Select only parent contacts (without any bot name)
• Click on button 'Send Message'. Select to whom and in which messenger to send a message. Write message and send. Note: the message will be sent not only in the selected messenger but also by mail. To disable sending by mail you can click button Followers, select follower, click 'Edit subscription', and disable 'Discussions' and enable 'Note'
• In [[ Discuss ]] menu you will see the message from document with message with signature from which document it was written

In Telegram:

• RESULT: A new message will appear
• Answer on this message. Note: Reply to a message by clicking the appropriate button

In Odoo:

• RESULT: the message from Telegram you will see in chatter document

File sending and receiving

The operator has the ability to send not just text messages, but also messages with attachments.

The Telegram Bot API has a limit on the files sent through the bot:

• The operator cannot send to Telegram user more than 10 MB for photos and 50 MB for other files.
• Also, the operator cannot receive files larger than 20 MB from a Telegram user.