feat: enhance agent profile with availability status and signature

helpdesk/helpdesk/doctype/hd_agent/hd_agent.js

@@ -1,7 +1,9 @@
 // Copyright (c) 2022, Frappe Technologies and contributors
 // For license information, please see license.txt
 
-frappe.ui.form.on("HD Agent", {
-  // refresh: function(frm) {
-  // }
+frappe.ui.form.on('HD Agent', {
+    refresh: function(frm) {
+        // Example: make status editable
+        frm.set_df_property('availability_status', 'read_only', 0);
+    }
 });

helpdesk/helpdesk/doctype/hd_agent/hd_agent.json

@@ -9,7 +9,9 @@
   "user",
   "agent_name",
   "user_image",
-  "is_active"
+  "is_active",
+  "availability_status",
+  "signature"
  ],
  "fields": [
   {
@@ -34,6 +36,21 @@
    "in_list_view": 1,
    "label": "Is Active"
   },
+  {
+   "default": "Available",
+   "fieldname": "availability_status",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "label": "Availability Status",
+   "options": "Available\nAway",
+   "reqd": 1
+  },
+  {
+   "description": "automatically added in reply section",
+   "fieldname": "signature",
+   "fieldtype": "Small Text",
+   "label": "Signature"
+  },
   {
    "fieldname": "user_image",
    "fieldtype": "Attach Image",
@@ -42,7 +59,7 @@
  ],
  "index_web_pages_for_search": 1,
  "links": [],
- "modified": "2026-02-02 11:15:47.402850",
+ "modified": "2026-02-09 22:08:22.055831",
  "modified_by": "Administrator",
  "module": "Helpdesk",
  "name": "HD Agent",

helpdesk/helpdesk/doctype/hd_ticket/hd_ticket.py

@@ -424,7 +424,12 @@ def users_present_in_team_assignment_rule(self):
         return True
 
     @frappe.whitelist()
-    def assign_agent(self, agent: str):
+    def assign_agent(self, agent):
+        availability = frappe.db.get_value("HD Agent", agent, "availability_status")
+
+        if availability == "Away":
+            frappe.throw("This agent is marked as Away and cannot be assigned tickets.")
+
         assign({"assign_to": [agent], "doctype": "HD Ticket", "name": self.name})
 
         if frappe.session.user != agent:
@@ -558,6 +563,11 @@ def reply_via_agent(
         medium = "" if skip_email_workflow else "Email"
         subject = f"Re: {self.subject}"
         sender = frappe.session.user
+        # Append agent signature if present
+        signature = frappe.db.get_value("HD Agent", {"user": sender}, "signature")
+        if signature and signature not in message:
+            message = f"{message}\n\n{signature}"
+
         recipients = to or self.raised_by
         sender_email = None if skip_email_workflow else self.sender_email()
 

helpdesk/hooks.py

@@ -64,6 +64,9 @@
         "on_trash": "helpdesk.extends.assignment_rule.on_assignment_rule_trash",
         "validate": "helpdesk.extends.assignment_rule.on_assignment_rule_validate",
     },
+    "ToDo": {
+        "before_insert": "helpdesk.overrides.assign.validate_agent_availability"
+    },
 }
 
 has_permission = {
@@ -75,6 +78,10 @@
     "HD Ticket": "helpdesk.helpdesk.doctype.hd_ticket.hd_ticket.permission_query",
     "HD Saved Reply": "helpdesk.helpdesk.doctype.hd_saved_reply.hd_saved_reply.permission_query",
 }
+permission_query_conditions.update({
+    "User": "helpdesk.overrides.assign.user_query_condition"
+})
+
 
 # DocType Class
 # ---------------
@@ -99,3 +106,10 @@
 
 before_tests = "helpdesk.test_utils.before_tests"
 auth_hooks = ["helpdesk.auth.authenticate"]
+
+
+
+link_query_conditions = {
+    "User": "helpdesk.overrides.assign.user_query_condition"
+}
+

helpdesk/overrides/assign.py

@@ -0,0 +1,29 @@
+import frappe
+from frappe import _
+
+
+def validate_agent_availability(doc, method=None):
+    if not doc.allocated_to:
+        return
+
+    status = frappe.db.get_value(
+        "HD Agent",
+        {"user": doc.allocated_to},
+        "availability_status",
+    )
+
+    if status == "Away":
+        frappe.throw(
+            msg=_("This agent is marked as Away and cannot be assigned tickets."),
+            title=_("Agent Unavailable"),
+            exc=frappe.ValidationError,
+        )
+
+def user_query_condition(user):
+    return """
+        EXISTS (
+            SELECT 1 FROM `tabHD Agent`
+            WHERE `tabHD Agent`.user = `tabUser`.name
+            AND `tabHD Agent`.availability_status = 'Available'
+        )
+    """