Intangles Alert Notification
The Intangles Alert Notification helps users get immediate alerts when API failures occur while connecting to the Intangles system. It can automatically send alerts through email and WhatsApp to notify the team about issues like failed API requests, so the problem can be fixed quickly.
Purpose
This document is used to configure how and when the system should send alerts whenever the Intangles API fails. It helps to ensure that API communication issues are reported instantly without manual checking.
Main Features
- Automatically detects failed API requests from the Intangles system.
- Sends email alerts to the listed team members.
- Sends WhatsApp notifications (if Twilio integration is available).
- Prevents repeated alerts for the same issue within a short time.
- Automatically resets alerts after a set duration.
How It Works
1. Monitoring API Failures
The system checks recent API request logs from the Intangles API Request Log document. If multiple failed requests (status code not 200) are found within the specified time frame, it triggers an alert.
2. Sending Email Alerts
If the Send Mail Alert option is enabled, the system sends an email with details such as the failed API method and status code.
Example Email:
Subject: Intangles API Request Failed with status code 500
Body:
- Dear Team,
- The API request for get_vehicle_data has failed with status code 500.
- Please check the logs for more details.
- Best regards,
Liquiconnect Team
3. Sending WhatsApp Alerts
If Twilio Integration is installed and Send WhatsApp Alert is enabled, the system sends a WhatsApp message using the “Intangles API Request Failure Alert” template.
4. Resetting Alerts
Once an alert is sent, the system waits for the configured “Reset Alert After” time before it can send the same alert again. This avoids repeated notifications for the same issue.
Example Flow
- The Intangles API fails to respond or returns an error (like status 500).
- The system checks the logs for repeated failures.
- If failures are found, the alert is triggered.
- An email and/or WhatsApp message is sent to the defined recipients.
- After the reset time passes, the system can alert again for new failures.
Related Documents
- Intangles API Request Log – Tracks all API calls made to Intangles and their response statuses.
- WhatsApp Template Reference – Stores message templates for WhatsApp notifications.
Setup Tips
- Make sure the Intangles API Request Log is active and logging correctly.
- Configure a valid Email Account in ERPNext before enabling email alerts.
- If using WhatsApp, ensure the Twilio Integration app is installed and configured.
- Test with a small time window (e.g., 5 minutes) to confirm that alerts are working correctly.
Benefits
- Instantly identifies API failures.
- Automatically alerts your team to fix issues faster.
- Supports both email and WhatsApp alerts.
- Prevents duplicate notifications using reset timers.
Example WhatsApp Message
Message Template:
Dear Team,
We are currently experiencing failures in API requests.
API Method: get_vehicle_data
Status Code: 500
Please check the system logs for details.
Best regards,
Liquiconnect Team
This feature ensures that API issues are quickly identified and resolved without waiting for manual checks.