[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-dc77be91-f619-4d3d-a7bb-a84f420d1502":3,"$fGr6cON6DDP3ZUwruSe6mgRX5PjnAeXbjdxBa5j-fGYk":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"dc77be91-f619-4d3d-a7bb-a84f420d1502","freshservice-automation","通过Rube MCP（Composio）自动化Freshservice ITSM任务：创建\u002F更新工单、批量操作、服务请求和发件邮件。始终首先搜索工具以查找当前架构。","cat_prod_automation","mod_productivity","sickn33,productivity","---\nname: freshservice-automation\ndescription: \"Automate Freshservice ITSM tasks via Rube MCP (Composio): create\u002Fupdate tickets, bulk operations, service requests, and outbound emails. Always search tools first for current schemas.\"\nrisk: critical\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# Freshservice Automation via Rube MCP\n\nAutomate Freshservice IT Service Management operations through Composio's Freshservice toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Freshservice connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `freshservice`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https:\u002F\u002Frube.app\u002Fmcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `freshservice`\n3. If connection is not ACTIVE, follow the returned auth link to complete Freshservice authentication\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. List and Search Tickets\n\n**When to use**: User wants to find, list, or search for tickets\n\n**Tool sequence**:\n1. `FRESHSERVICE_LIST_TICKETS` - List tickets with optional filtering and pagination [Required]\n2. `FRESHSERVICE_GET_TICKET` - Get detailed information for a specific ticket [Optional]\n\n**Key parameters for listing**:\n- `filter`: Predefined filter ('all_tickets', 'deleted', 'spam', 'watching')\n- `updated_since`: ISO 8601 timestamp to get tickets updated after this time\n- `order_by`: Sort field ('created_at', 'updated_at', 'status', 'priority')\n- `order_type`: Sort direction ('asc' or 'desc')\n- `page`: Page number (1-indexed)\n- `per_page`: Results per page (1-100, default 30)\n- `include`: Additional fields ('requester', 'stats', 'description', 'conversations', 'assets')\n\n**Key parameters for get**:\n- `ticket_id`: Unique ticket ID or display_id\n- `include`: Additional fields to include\n\n**Pitfalls**:\n- By default, only tickets created within the past 30 days are returned\n- Use `updated_since` to retrieve older tickets\n- Each `include` value consumes additional API credits\n- `page` is 1-indexed; minimum value is 1\n- `per_page` max is 100; default is 30\n- Ticket IDs can be the internal ID or the display_id shown in the UI\n\n### 2. Create a Ticket\n\n**When to use**: User wants to log a new incident or request\n\n**Tool sequence**:\n1. `FRESHSERVICE_CREATE_TICKET` - Create a new ticket [Required]\n\n**Key parameters**:\n- `subject`: Ticket subject line (required)\n- `description`: HTML description of the ticket (required)\n- `status`: Ticket status - 2 (Open), 3 (Pending), 4 (Resolved), 5 (Closed) (required)\n- `priority`: Ticket priority - 1 (Low), 2 (Medium), 3 (High), 4 (Urgent) (required)\n- `email`: Requester's email address (provide either email or requester_id)\n- `requester_id`: User ID of the requester\n- `type`: Ticket type ('Incident' or 'Service Request')\n- `source`: Channel - 1 (Email), 2 (Portal), 3 (Phone), 4 (Chat), 5 (Twitter), 6 (Facebook)\n- `impact`: Impact level - 1 (Low), 2 (Medium), 3 (High)\n- `urgency`: Urgency level - 1 (Low), 2 (Medium), 3 (High), 4 (Critical)\n\n**Pitfalls**:\n- `subject`, `description`, `status`, and `priority` are all required\n- Either `email` or `requester_id` must be provided to identify the requester\n- Status and priority use numeric codes, not string names\n- Description supports HTML formatting\n- If email does not match an existing contact, a new contact is created\n\n### 3. Bulk Update Tickets\n\n**When to use**: User wants to update multiple tickets at once\n\n**Tool sequence**:\n1. `FRESHSERVICE_LIST_TICKETS` - Find tickets to update [Prerequisite]\n2. `FRESHSERVICE_BULK_UPDATE_TICKETS` - Update multiple tickets [Required]\n\n**Key parameters**:\n- `ids`: Array of ticket IDs to update (required)\n- `update_fields`: Dictionary of fields to update (required)\n  - Allowed keys: 'subject', 'description', 'status', 'priority', 'responder_id', 'group_id', 'type', 'tags', 'custom_fields'\n\n**Pitfalls**:\n- Bulk update performs sequential updates internally; large batches may take time\n- All specified tickets receive the same field updates\n- If one ticket update fails, others may still succeed; check response for individual results\n- Cannot selectively update different fields per ticket in a single call\n- Custom fields must use their internal field names, not display names\n\n### 4. Create Ticket via Outbound Email\n\n**When to use**: User wants to create a ticket by sending an outbound email notification\n\n**Tool sequence**:\n1. `FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL` - Create ticket with email notification [Required]\n\n**Key parameters**:\n- `email`: Requester's email address (required)\n- `subject`: Email subject \u002F ticket subject (required)\n- `description`: HTML email body content\n- `status`: Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed)\n- `priority`: Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent)\n- `cc_emails`: Array of CC email addresses\n- `email_config_id`: Email configuration ID for the sender address\n- `name`: Requester name\n\n**Pitfalls**:\n- This creates a standard ticket via the \u002Fapi\u002Fv2\u002Ftickets endpoint while sending an email\n- If the email does not match an existing contact, a new contact is created with the provided name\n- `email_config_id` determines which email address the notification appears to come from\n\n### 5. Create Service Requests\n\n**When to use**: User wants to submit a service catalog request\n\n**Tool sequence**:\n1. `FRESHSERVICE_CREATE_SERVICE_REQUEST` - Create a service request for a catalog item [Required]\n\n**Key parameters**:\n- `item_display_id`: Display ID of the catalog item (required)\n- `email`: Requester's email address\n- `quantity`: Number of items to request (default: 1)\n- `custom_fields`: Custom field values for the service item form\n- `parent_ticket_id`: Display ID of a parent ticket (for child requests)\n\n**Pitfalls**:\n- `item_display_id` can be found in Admin > Service Catalog > item URL (e.g., \u002Fservice_catalog\u002Fitems\u002F1)\n- Custom fields keys must match the service item form field names\n- Quantity defaults to 1 if not specified\n- Service requests follow the approval workflow defined for the catalog item\n\n## Common Patterns\n\n### Status Code Reference\n\n| Code | Status |\n|------|--------|\n| 2 | Open |\n| 3 | Pending |\n| 4 | Resolved |\n| 5 | Closed |\n\n### Priority Code Reference\n\n| Code | Priority |\n|------|----------|\n| 1 | Low |\n| 2 | Medium |\n| 3 | High |\n| 4 | Urgent |\n\n### Pagination\n\n- Use `page` (1-indexed) and `per_page` (max 100) parameters\n- Increment `page` by 1 each request\n- Continue until returned results count \u003C `per_page`\n- Default page size is 30\n\n### Finding Tickets by Date Range\n\n```\n1. Call FRESHSERVICE_LIST_TICKETS with updated_since='2024-01-01T00:00:00Z'\n2. Optionally add order_by='updated_at' and order_type='desc'\n3. Paginate through results\n```\n\n## Known Pitfalls\n\n**Numeric Codes**:\n- Status and priority use numeric values, not strings\n- Source channel uses numeric codes (1-6)\n- Impact and urgency use numeric codes (1-3 or 1-4)\n\n**Date Filtering**:\n- Default returns only tickets from the last 30 days\n- Use `updated_since` parameter for older tickets\n- Date format is ISO 8601 (e.g., '2024-01-01T00:00:00Z')\n\n**Rate Limits**:\n- Freshservice API has per-account rate limits\n- Each `include` option consumes additional API credits\n- Implement backoff on 429 responses\n\n**Response Parsing**:\n- Response data may be nested under `data` or `data.data`\n- Parse defensively with fallback patterns\n- Ticket IDs are numeric integers\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List tickets | FRESHSERVICE_LIST_TICKETS | filter, updated_since, page, per_page |\n| Get ticket | FRESHSERVICE_GET_TICKET | ticket_id, include |\n| Create ticket | FRESHSERVICE_CREATE_TICKET | subject, description, status, priority, email |\n| Bulk update | FRESHSERVICE_BULK_UPDATE_TICKETS | ids, update_fields |\n| Outbound email ticket | FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL | email, subject, description |\n| Service request | FRESHSERVICE_CREATE_SERVICE_REQUEST | item_display_id, email, quantity |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,202,179,"2026-05-16 13:19:21",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"效率工具","productivity","mdi-lightning-bolt-outline","文档处理、数据分析、自动化工作流",4,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"自动化","automation","mdi-robot-outline","工作流自动化、批处理",3,101,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"1068c314-6fef-4095-bd0b-59803ead4445","1.0.0","freshservice-automation.zip",3491,"uploads\u002Fskills\u002Fdc77be91-f619-4d3d-a7bb-a84f420d1502\u002Ffreshservice-automation.zip","fd0865b2bc67cf37d8c48d07825559a0f420a1f912dbc18f92c18e5e6b99aebe","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":8714}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]