yrestom / erpnext_telegram Goto Github PK

View Code? Open in Web Editor NEW

92.0 15.0 104.0 93 KB

Telegram Integration for Erpnext

License: Other

Python 80.73% JavaScript 19.27%

erpnext_telegram's Introduction

Erpnext Telegram Integration And Notifications

Telegram Integration and Extra Notifications For Frappe & Erpnext to sending fast notifications for more productivity.

Main features

Telegram Notifications:

Sending custom notification by Telegram Bots to Users, Employees, Customers, Suppliers or Students, and Telegram group chat.
Sending Telegram direct messages from any form view.
Multiple Telegram Bots channels.

SMS Notifications:

Sending custom notification by SMS to Users, Employees, Customers, Suppliers or Students .

Date Notifications:

Get alerts on important dates

How to Install

./env/bin/pip install python-telegram-bot --upgrade "This command is necessary to install the python-telegram-bot into bench environment. Otherwise, the pip3/pip command will install it in the python environment"
bench get-app erpnext_telegram_integration https://github.com/yrestom/erpnext_telegram.git
bench --site [your.site.name] install-app erpnext_telegram_integration
bench build
bench restart
Create a new Telegram bot in BotFather

For more reference :
- Bots: An introduction for developers
- Learn to build your first bot in Telegram with Python
Get Telegram Bot Token from BotFather

Setup and Use:

Telegram Notifications:

In Erpnext Telegram Integration

Go to → Telegram Settings -> New Enter Telegram Bot Token
Go to → Telegram User Settings -> New to setup and define a new user setting
1. Choose party.
2. Choose Telegram User.
3. Choose Telegram Settings.
4. If it's a group check "Is Group Chat".
5. Press "Generate Telegram Token" then the app will copy the "Telegram Token" to clipboard and will open a new window into the browser to the Bot web page.
6. Paste "Telegram Token" in the Telegram Bot or if it is a Group Chat paste in the group after adding the Bot.
7. Press "Get Chat ID" And if everything is ok it will get the chat ID.
8. Press Save.
Go to → Telegram Notification -> New You can configure various notifications in your system to remind you of important activities. As the original Erpnext Notification.

Here chose the profile of "Telegram User Settings" want to send to him the notification or use the checkbox "Dynamic Recipients" to get the recipient from the DocType dynamically if it has a Link Field like "Customer", "Supplier", "Student" or "Employee", for this it needs to set up a "Telegram User Settings" for the customer, supplier ...
Also, you can send directly a Telegram message from any form view by going to the Menu and click "Send To Telegram".
When the app send a Telegram Notification it will write a new log into Extra Notifications > Extra Notification Log .

SMS Notifications:

in Extra Notifications:

Go to → SMS Settings and set it up as here.
Go to → SMS Notification → New

You can configure various notifications in your system to remind you of important activities. As the original Erpnext Notification.

Here chose the "Recipients" want to send to them the notification or use the checkbox "Dynamic Recipients" to get the recipient from the DocType dynamically if it has a Link Field like "Customer", "Supplier", "Student" or "Employee", for this it needs to set up a Contact for the customer, supplier..., and make sure the contact is related to the customer or supplier... and has Primary Mobile number as default.
Press Save.

Date Notifications:

in Extra Notifications:

Go to → Date Notification → New.
Choose the DocType Name.
Press "Get Date Fields"
Choose the wanted fields an delete the rest.
Configure when the alert will be trigger by selecting "Days Before" or "Days After" and selecting a number of days for each field.
Configure the "Conditions" if need it.
Press Save.

When the Date Notification is trigger it will send an email to the related user and it will write a new log into Extra Notifications > Extra Notification Log .

Dependencies

Frappe Version 12+
Python Version 3+
python-telegram-bot

License

MIT

erpnext_telegram's People

Contributors

Stargazers

Watchers

Forkers

hafeeserp ahmadragheb rknroot flexy2ky teddyseptiadi askmetoo exar888 aakvatech hrgadeha imcowboysibs solosoftma compres axentorllc erpnext-apps-store sammish linuxtechie mohsinalimat molandtoxx toobaff philliyg kaviyaperiyasamy sihaysistema bobcodev agilasoft mattholmes-ug asoral pjamsheer kidsyn nabinhait sherinkr miaezario allanshak vinhnguyent090 lovinmaxwell adesinasam arrazka lebill369 tjomtek tahirsesomo penieldev isyasin govind-jangid revasiya msf4-0 kevinbrown1980 cepho dadabhagwan techabout stephenbdt andrewhartono lajidey-foss zulfi007 younis-amb amutaher islammoustafa95 kimsreng aadithpunathil hirengenirex azhkhn routeget zshiftycrook mohamedabdulsalam96 alkuhlani mr-dy986 sayyyed onespaceerp ionic-info alaalsalam franknyarkoh muirawachanga dineshpanchal93 nihantra themayurahir admin627863 hidayatmanusiya yuntan0 humenth rowad-org-erp-team sengho825 arteryp ratha7129 tespheakdeyesoftix ahmdfowzi nihantra-patel fadlibdr ivanguevaram mohamadosama empress-eco syamkerai kamalparyani miteshpc akiratfli jeza4771 ahmedalbanna abanoupjohnny

erpnext_telegram's Issues

Can't get Chat ID

Frappe v14.21.1
ERPNext v14.12.0
Erpnext Telegram Integration v1.1.0 (master)

Ubuntu 22.04.1 LTS x86_64
python telegram bot 20

I have followed your small tutorial on Discuss, and as soon I press Get Chat ID I get

Failed to load resource: 500 error: https://mysite/api/method/erpnext_telegram_integration.erpnext_telegram_integration.doctype.telegram_user_settings.telegram_user_settings.get_chat_id_button

I've installed python telegram bot in my bench env, as well outside my bench env.

Version 14 Support

Does the app support erpnext/frappe version 14 ?

The resource http://erp.xyz.com/assets/js/erpnext_telegram_integration.min.js was preloaded using link preload but not used within a few seconds from the window's load event. Please make sure it has an appropriate as value and it is preloaded intentionally.

Trying to get the notification but

Telegram Notification Issue After Updating to Version 14

I have been experiencing with Telegram notifications after updating to version 14. It has been causing inconvenience in my day-to-day communication, and I am seeking your assistance in resolving this matter

Error
Traceback (most recent call last):
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 412, in evaluate_alert
alert.send(doc)
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 148, in send
self.send_a_telegram_msg(doc, context)
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 209, in send_a_telegram_msg
send_to_telegram(
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_settings/telegram_settings.py", line 45, in send_to_telegram
asyncio.run(bot.send_message(chat_id=telegram_chat_id, text=message))
File "/usr/lib/python3.10/asyncio/runners.py", line 37, in run
raise ValueError("a coroutine was expected, got {!r}".format(main))
ValueError: a coroutine was expected, got <telegram.message.Message object at 0x7fd8fcf2bdc0>

Cant set the condition on telegram notification when use grater than operator (> or <) return the condition is invalid

the doctype is a sales invoice

my condition is
doc.grand_total >= 2000

the error message is => The Condition 'doc.total > 2000 ' is invalid

"Send To Telegram" menu not shown up when the first page is not a form view

If the first paged loaded from server is a form view, the menu button is shown but not otherwise.
Even though the first page is form view and the menu button is shown, it will not show up when we navigate to other forms without refreshing the browser.

I have tested it on version 13

App supports 13 version Frappe & ERPNext?

Frappe Version 12+

That is, the application supports 13 version?

Telegram Error on ERPNext - Cannot process any document

Hi,

Suddenly whenever I try to save any document which should trigger the telegram notification on ERPNext. The document cannot save and I receive the following error.

Traceback (most recent call last):
  File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 412, in evaluate_alert
    alert.send(doc)
  File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 148, in send
    self.send_a_telegram_msg(doc, context)
  File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_notification/telegram_notification.py", line 209, in send_a_telegram_msg
    send_to_telegram(
  File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_settings/telegram_settings.py", line 45, in send_to_telegram
    asyncio.run(bot.send_message(chat_id=telegram_chat_id, text=message))
  File "/usr/lib/python3.10/asyncio/runners.py", line 37, in run
    raise ValueError("a coroutine was expected, got {!r}".format(main))
ValueError: a coroutine was expected, got <telegram.message.Message object at 0x7ff2e91a6620>

I am using ERPNext 14, hosted on Frappe Cloud
Our whole system is dependent on your amazing notification system. Please help me with this. Thanks :)

Table in telegram bot

How can i add table in bot message like

Thanks!!!

Notifications are not working since few days

Suddenly the notifications have stopped working, I am using frappe cloud hosted ERPNext and have installed Telegram Notifications, everything was working smoothly and suddenly this happened.
When I try to add a new user in telegram user settings, I cannot save the record even, i think the chat id is not updating as well.

Notification sends /app/doc... link by default in every telegram message

Even if the message is customized to be something else, the message by default contains 'See the document at ....' at the bottom of each message. I need to either disable this, or customize it - since the TG group is public and the documents being updated are public website documents, not something a user logs into desk to see.

Please advise on how to edit the code to fix this

Unable to generate a New Telegram User Settings in ERPNEXT

Hello
In our version 15 erpnext when I try to make a new Telegram User Setting I am receving an error regarding the telegram integration app while I go to save the document and get the Chat ID.

When installing on a local VM

Hi,

Installing erpnext_telegram_integration...
An error occurred while installing erpnext_telegram_integration:
invalid syntax (base.py, line 42)

ERPNext version
erpnext 12.18.0
erpnext_documentation 0.0.1
erpnext_telegram_integration 0.0.5
frappe 12.15.0

Telegram Notification(Login And Logout)

I am trying to make a Telegram notification when the user is log out or log in
I fill this data in fields:
1-Send alert on:('new' or 'save')
2-DocumentType('Activity Log')

When I enable this alert and save when the user press log out Error message showing
Error message('can only concatenate str (not "int") to str')
I will attach picture for error message and picture for Notification Screen

Note(I used the notification when the user submit the sale invoice and it is work good and the message sent to telegram )
please guide me .thanks

Missing recipint table

hi guys i am unable to see the recipient table even after selecting dynamic recipient from the checkbox..i am help is nice
vrsion 13.16 and 13.16.01 erpnext n frappe..

no recipint table

Support for ERPNext Version-14

Hi,
I am trying to upgrade my Erpnext Version 13 to Version 14. I have this app installed on my Version 13 instance.
However, when I am trying to upgrade bench command is throwing error that it couldn't find the git reference of erpnext_telegram app for the version 14.
Did anyone try upgrading to Version 14 and anyone find a solution?

Thanks & Regards,
Vinod Kumar K

In setup and use 5th setup is not working, i am use v15

async with bot: AttributeError: aenter

request.js:457
Traceback (most recent call last):
File "apps/frappe/frappe/app.py", line 94, in application
response = frappe.api.handle()
File "apps/frappe/frappe/api.py", line 54, in handle
return frappe.handler.handle()
File "apps/frappe/frappe/handler.py", line 47, in handle
data = execute_cmd(cmd)
File "apps/frappe/frappe/handler.py", line 85, in execute_cmd
return frappe.call(method, **frappe.form_dict)
File "apps/frappe/frappe/init.py", line 1619, in call
return fn(*args, **newargs)
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_user_settings/telegram_user_settings.py", line 52, in get_chat_id_button
chat_id = asyncio.run(get_chat_id(telegram_token_bot, telegram_token))
File "/usr/lib/python3.10/asyncio/runners.py", line 44, in run
return loop.run_until_complete(main)
File "/usr/lib/python3.10/asyncio/base_events.py", line 649, in run_until_complete
return future.result()
File "apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/telegram_user_settings/telegram_user_settings.py", line 60, in get_chat_id
async with bot:
AttributeError: aenter

Frappe Framework - v14.41.0
ERPNext - v14.31.3

Error while sending telegram notification

I am getting this error while my telegram notification is running i got the message in my telegram but system shows we this message and as i am sending this notification on submit it do not go forward to next step.
Error:
a coroutine was expected, got <telegram.message.Message object at 0x7f45b32835e0>

Open SMS Notification List Error

SMS Notification SMS Notification not found

Traceback (most recent call last):
File "/home/frappe/frappe-bench/apps/erpnext_telegram_integration/erpnext_telegram_integration/erpnext_telegram_integration/doctype/sms_notification/sms_notification.py", line 331, in evaluate_alert
alert = frappe.get_doc("SMS Notification", alert)
File "/home/frappe/frappe-bench/apps/frappe/frappe/init.py", line 850, in get_doc
doc = frappe.model.document.get_doc(*args, **kwargs)
File "/home/frappe/frappe-bench/apps/frappe/frappe/model/document.py", line 75, in get_doc
return controller(*args, **kwargs)
File "/home/frappe/frappe-bench/apps/frappe/frappe/model/document.py", line 113, in init
self.load_from_db()
File "/home/frappe/frappe-bench/apps/frappe/frappe/model/document.py", line 156, in load_from_db
frappe.throw(("{0} {1} not found").format((self.doctype), self.name), frappe.DoesNotExistError)
File "/home/frappe/frappe-bench/apps/frappe/frappe/init.py", line 432, in throw
msgprint(msg, raise_exception=exc, title=title, indicator='red', is_minimizable=is_minimizable, wide=wide, as_list=as_list)
File "/home/frappe/frappe-bench/apps/frappe/frappe/init.py", line 411, in msgprint
_raise_exception()
File "/home/frappe/frappe-bench/apps/frappe/frappe/init.py", line 365, in _raise_exception
raise raise_exception(msg)
frappe.exceptions.DoesNotExistError: SMS Notification SMS Notification not found

yrestom / erpnext_telegram Goto Github PK

erpnext_telegram's Introduction

Erpnext Telegram Integration And Notifications

Main features

Telegram Notifications:

SMS Notifications:

Date Notifications:

How to Install

Setup and Use:

Telegram Notifications:

SMS Notifications:

Date Notifications:

Dependencies

License

erpnext_telegram's People

Contributors

Stargazers

Watchers

Forkers

erpnext_telegram's Issues

Recommend Projects

Recommend Topics

Recommend Org