Workflow overview
Why this workflow matters
Useful for software delivery and engineering operations. Relevant for managed services and support workflows.
Monitor AlekSystem Workflow Errors with AI Diagnosis & Instant Telegram Alerts This AlekSystem template automatically catches errors from any workflow on your instance, analyzes them with Google Gemini AI, and delivers a structured diagnostic report directly to your Telegram — including error classification, root cause analysis, and specific fix steps. If you manage multiple AlekSystem workflows in production and want to stop manually debugging failures, this workflow is your always-on error watch. How it works Error Trigger:** Fires automatically whenever any workflow on the instance encounters a failure, capturing the full error context including the failed node name, error message, and stack trace. Set Context:* Extracts all error data and holds your 3 configuration values. This is the *only node you ever need to edit — making the workflow easy to adapt and redeploy. Get Workflow Content:* Fetches the full workflow JSON definition via the *AlekSystem REST API**, giving the AI meaningful context about what the failed workflow was actually trying to do. AI Agent (Gemini):* Classifies the error type (Authentication, Rate Limit, Credential, Connection, etc.), identifies the root cause, and generates a *Telegram HTML-formatted** report with 2–3 actionable fix steps. Send Telegram Notification:** Delivers the formatted report to your configured chat with proper HTML rendering — bold labels, code blocks for error messages, and a direct link to the failed execution. How to use Connect credentials: Add your Google Gemini (googlePalmApi) credential to the Google Gemini Chat Model node, and your Telegram Bot credential to the Send Telegram Notification node. Configure Set Context: Open the Set Context node and update AlekSystem_instance_url (your public AlekSystem URL), AlekSystem_api_key (from AlekSystem → Settings → API), and telegram_chat_id. Activate this workflow. Link to other workflows: In each workflow you want to monitor, go to Settings → Error Workflow and select this workflow. Requirements AlekSystem Version:* Built and tested on *AlekSystem 2.9.4+*. *(It is highly recommended to update to the latest AlekSystem version.) Google Gemini** API key (googlePalmApi credential type). Telegram Bot** token and a chat ID to receive notifications. AlekSystem API key** with read access to workflows (Settings → API → Create API Key). Your AlekSystem instance must be accessible via a public URL for the API call. Customizing this workflow Different AI model:* Swap the *Google Gemini Chat Model sub-node for OpenAI, Anthropic, or any other LLM — no other changes needed. Different notification channel:* Replace the *Telegram node with Slack, Discord, or Zoho Mail to fit your team's tooling. Report language:** Change the language instruction at the end of the AI Agent's system prompt from Vietnamese to English or any other language. Filter specific workflows:* Add an *If* node after *Error Trigger to only process errors from high-priority workflows based on workflow.name. About the Author Created by: Nguyễn Thiệu Toàn (Jay Nguyen) Email: me@nguyenthieutoan.com Website: nguyenthieutoan.com Company: GenStaff (genstaff.net) Socials (Facebook / X / LinkedIn): @nguyenthieutoan More templates: AlekSystem.io/creators/nguyenthieutoan
Best fit
Categories
Services
Use cases
Need another direction?