TelegramNotifier is a powerful PrestaShop module that sends instant notifications about new orders, admin logins, and new customer registrations directly to your Telegram. Stay informed about every sale, monitor your store's security, and keep track of new customers in real-time, right on your smartphone or computer!
- 🚀 Instant notifications for new orders
- 🔐 Admin login notifications with IP address, country, and timestamp
- 👤 New customer registration notifications with detailed customer information
- 📊 Detailed order information, including product list and shipping address
- 🛠 Easy setup through PrestaShop admin panel
- 👥 Support for multiple notification recipients
- 🔒 Secure data transmission via Telegram API
- 🛠 Integrated error logging system with PrestaShop (PrestaShopLogger)
- 🔄 Automatic check for module updates directly through Telegram messages
- 🌐 Multi-shop support with
{shop_name}placeholder
- Download the latest version of the module from the Releases section.
- Log in to your PrestaShop admin panel.
- Navigate to "Modules" > "Upload a module".
- Upload the downloaded ZIP file of the module.
- Once installed, find "TelegramNotifier" in the module list and click "Configure".
-
Telegram Bot Token:
- Create a new bot via @BotFather on Telegram.
- Obtain the Bot Token provided by BotFather.
-
Telegram Chat ID(s):
- Send a message to your newly created bot.
- Visit
https://api.telegram.org/bot<YourBOTToken>/getUpdatesto get the chat ID. - You can enter multiple chat IDs separated by commas.
-
Max Messages per Action:
- This setting allows you to control the maximum number of messages sent per action.
- In most cases, you don't need to change this value.
- If your store frequently receives many simultaneous orders, it's recommended to reduce this value to 2. This will ensure more efficient message delivery, but the messages may be less detailed.
- All messages will be sent 100% but not fully detailed if you decrease this value.
- Set this value to 0 for unlimited messages per action.
-
Message Templates: Customize the notification messages using available placeholders:
New Order Notification Template:
{order_reference}: The unique order reference 📦{shop_name}: The name of the shop 🛍️{customer_name}: Name of the customer 👤{customer_email}: Email address of the customer 📧{ip_address}: The IP address of the customer 🌐{country}: The country of the customer 🏳️{date_time}: The date and time of the order (server time) 🕒{phone_number}: Customer's phone number 📞{total_paid}: Total amount paid for the order 💰{shipping_address}: Delivery address 🏠{delivery_method}: Chosen delivery method 🚚{payment_method}: Method of payment used 💳{products_list}: List of products in the order 🛍️{order_comment}: Any comment left by the customer 📝
Admin Login Notification Template:
{employee_name}: Name of the employee who logged in 👤{employee_email}: Email address of the employee 📧{ip_address}: IP address used for login 🌐{country}: Country associated with the IP address 🏳️{date_time}: Date and time of the login (server time) 🕒
New Customer Notification Template:
{customer_name}: Name of the customer 👤{customer_email}: Email address of the customer 📧{ip_address}: The IP address of the customer 🌐{country}: The country of the customer 🏳️{date_time}: The date and time of the registration (server time) 🕒{birthday}: Customer's birthday 🎂{gender}: Customer's gender 👫{newsletter}: Whether the customer subscribed to the newsletter 📰
-
Telegram Update Notifications:
- Stay informed about new updates to the TelegramNotifier module directly through Telegram messages.
-
New Customer Registration Notifications:
- Enable to receive notifications when a new customer registers.
-
Admin Login Notifications:
- Enable to receive alerts when an admin logs into the PrestaShop backend, providing security insights in real-time.
-
Save your settings and use the "Test Message" button to verify the configuration.
- Using the
{country}placeholder in the message templates might slightly slow down your store due to the external API call required to retrieve the country information. - The Telegram Update Notifications feature might slightly slow down your store due to the external API call used to check for updates, but it is recommended to keep it enabled.
The Admin Login Notifications feature helps you monitor access to your store's backend. This is especially useful in cases where an employee's account has been compromised, allowing you to react quickly and prevent potential damage. For example, if you receive a login notification from a country you don't typically operate in, it could indicate unauthorized access. If you receive a notification for a login you don't recognize, change your admin password immediately!
Errors can be found in the Advanced Parameters and Logs section of the PrestaShop admin panel. You can navigate to Advanced Parameters > Logs to view the event log and debug any issues related to the module.
If you encounter any issues or have suggestions for improving the module, please create an issue in this repository.
This project is licensed under the MIT License - see the LICENSE file for details.
[Alex] - [https://github.com/alex2276564]
We appreciate your contribution to the project! If you like this module, please give it a star on GitHub.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
- Fork the repository.
- Create a new branch (
git checkout -b feature/YourFeature). - Commit your changes (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/YourFeature). - Open a Pull Request.
Thank you for using TelegramNotifier for PrestaShop! We hope it helps you stay on top of your e-commerce business. 🚀📊