К основному содержанию
скилл CX Codex

freshservice-automation — скилл для Claude Code: задачи ITSM

Скилл freshservice-automation автоматизирует работу с заявками Freshservice через Rube MCP: поиск, создание, массовое обновление и отправка уведомлений.

MIT 121 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill freshservice-automation -a claude-code
Открыть на GitHub

Что делает freshservice-automation

Скилл подключает модели к инструментам Freshservice через шлюз Rube MCP от Composio. Для запуска требуется добавить эндпоинт https://rube.app/mcp в конфигурацию клиента и активировать авторизацию вызовом RUBE_MANAGE_CONNECTIONS с набором freshservice.

Внутри заложены сценарии работы с API: чтение тикетов через FRESHSERVICE_LIST_TICKETS с постраничной навигацией по 30 записей, регистрация инцидентов и сервисных заявок, а также массовые операции. Статусы и приоритеты передаются строгими числовыми кодами: например, статус 2 означает «Open», а приоритет 4 — «Urgent». Описание тикета принимает разметку HTML.

По умолчанию Freshservice возвращает только заявки за последние 30 дней. Без указания фильтра updated_since в формате ISO 8601 старые инциденты в выдачу не попадут.

Какие задачи решает

  • создать тикет инцидента с HTML-описанием
  • обновить статус у группы заявок разом
  • отправить сервисную заявку из каталога
  • найти обращения с фильтром по дате обновления

Примеры запросов агенту

  • Найди открытые тикеты в Freshservice с высоким приоритетом
  • Создай заявку на сброс пароля от пользователя [email protected]
  • Обнови статус тикетов 1042 и 1043 на Resolved

Как установить freshservice-automation

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill freshservice-automation -a claude-code

2Вручную: положить файлы

~/.claude/skills/freshservice-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/freshservice-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о freshservice-automation

Как установить freshservice-automation в Claude Code?

Выполните команду npx skills add davepoon/buildwithclaude --skill freshservice-automation -a claude-code в терминале.

Что делает freshservice-automation?

Даёт агенту команды для чтения, поиска, регистрации и массового обновления тикетов Freshservice через протокол MCP.

Что нужно подготовить перед запуском сценариев?

Нужно подключить MCP-сервер https://rube.app/mcp и подтвердить статус ACTIVE через инструмент RUBE_MANAGE_CONNECTIONS для тулкита freshservice.

Исходный текст

SKILL.md · MIT
---
name: freshservice-automation
description: "Automate Freshservice ITSM tasks via Rube MCP (Composio): create/update tickets, bulk operations, service requests, and outbound emails. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: customer-support
---

# Freshservice Automation via Rube MCP

Automate Freshservice IT Service Management operations through Composio's Freshservice toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/freshservice](https://composio.dev/toolkits/freshservice)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Freshservice connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `freshservice`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `freshservice`
3. If connection is not ACTIVE, follow the returned auth link to complete Freshservice authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. List and Search Tickets

**When to use**: User wants to find, list, or search for tickets

**Tool sequence**:
1. `FRESHSERVICE_LIST_TICKETS` - List tickets with optional filtering and pagination [Required]
2. `FRESHSERVICE_GET_TICKET` - Get detailed information for a specific ticket [Optional]

**Key parameters for listing**:
- `filter`: Predefined filter ('all_tickets', 'deleted', 'spam', 'watching')
- `updated_since`: ISO 8601 timestamp to get tickets updated after this time
- `order_by`: Sort field ('created_at', 'updated_at', 'status', 'priority')
- `order_type`: Sort direction ('asc' or 'desc')
- `page`: Page number (1-indexed)
- `per_page`: Results per page (1-100, default 30)
- `include`: Additional fields ('requester', 'stats', 'description', 'conversations', 'assets')

**Key parameters for get**:
- `ticket_id`: Unique ticket ID or display_id
- `include`: Additional fields to include

**Pitfalls**:
- By default, only tickets created within the past 30 days are returned
- Use `updated_since` to retrieve older tickets
- Each `include` value consumes additional API credits
- `page` is 1-indexed; minimum value is 1
- `per_page` max is 100; default is 30
- Ticket IDs can be the internal ID or the display_id shown in the UI

### 2. Create a Ticket

**When to use**: User wants to log a new incident or request

**Tool sequence**:
1. `FRESHSERVICE_CREATE_TICKET` - Create a new ticket [Required]

**Key parameters**:
- `subject`: Ticket subject line (required)
- `description`: HTML description of the ticket (required)
- `status`: Ticket status - 2 (Open), 3 (Pending), 4 (Resolved), 5 (Closed) (required)
- `priority`: Ticket priority - 1 (Low), 2 (Medium), 3 (High), 4 (Urgent) (required)
- `email`: Requester's email address (provide either email or requester_id)
- `requester_id`: User ID of the requester
- `type`: Ticket type ('Incident' or 'Service Request')
- `source`: Channel - 1 (Email), 2 (Portal), 3 (Phone), 4 (Chat), 5 (Twitter), 6 (Facebook)
- `impact`: Impact level - 1 (Low), 2 (Medium), 3 (High)
- `urgency`: Urgency level - 1 (Low), 2 (Medium), 3 (High), 4 (Critical)

**Pitfalls**:
- `subject`, `description`, `status`, and `priority` are all required
- Either `email` or `requester_id` must be provided to identify the requester
- Status and priority use numeric codes, not string names
- Description supports HTML formatting
- If email does not match an existing contact, a new contact is created

### 3. Bulk Update Tickets

**When to use**: User wants to update multiple tickets at once

**Tool sequence**:
1. `FRESHSERVICE_LIST_TICKETS` - Find tickets to update [Prerequisite]
2. `FRESHSERVICE_BULK_UPDATE_TICKETS` - Update multiple tickets [Required]

**Key parameters**:
- `ids`: Array of ticket IDs to update (required)
- `update_fields`: Dictionary of fields to update (required)
  - Allowed keys: 'subject', 'description', 'status', 'priority', 'responder_id', 'group_id', 'type', 'tags', 'custom_fields'

**Pitfalls**:
- Bulk update performs sequential updates internally; large batches may take time
- All specified tickets receive the same field updates
- If one ticket update fails, others may still succeed; check response for individual results
- Cannot selectively update different fields per ticket in a single call
- Custom fields must use their internal field names, not display names

### 4. Create Ticket via Outbound Email

**When to use**: User wants to create a ticket by sending an outbound email notification

**Tool sequence**:
1. `FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL` - Create ticket with email notification [Required]

**Key parameters**:
- `email`: Requester's email address (required)
- `subject`: Email subject / ticket subject (required)
- `description`: HTML email body content
- `status`: Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed)
- `priority`: Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent)
- `cc_emails`: Array of CC email addresses
- `email_config_id`: Email configuration ID for the sender address
- `name`: Requester name

**Pitfalls**:
- This creates a standard ticket via the /api/v2/tickets endpoint while sending an email
- If the email does not match an existing contact, a new contact is created with the provided name
- `email_config_id` determines which email address the notification appears to come from

### 5. Create Service Requests

**When to use**: User wants to submit a service catalog request

**Tool sequence**:
1. `FRESHSERVICE_CREATE_SERVICE_REQUEST` - Create a service request for a catalog item [Required]

**Key parameters**:
- `item_display_id`: Display ID of the catalog item (required)
- `email`: Requester's email address
- `quantity`: Number of items to request (default: 1)
- `custom_fields`: Custom field values for the service item form
- `parent_ticket_id`: Display ID of a parent ticket (for child requests)

**Pitfalls**:
- `item_display_id` can be found in Admin > Service Catalog > item URL (e.g., /service_catalog/items/1)
- Custom fields keys must match the service item form field names
- Quantity defaults to 1 if not specified
- Service requests follow the approval workflow defined for the catalog item

## Common Patterns

### Status Code Reference

| Code | Status |
|------|--------|
| 2 | Open |
| 3 | Pending |
| 4 | Resolved |
| 5 | Closed |

### Priority Code Reference

| Code | Priority |
|------|----------|
| 1 | Low |
| 2 | Medium |
| 3 | High |
| 4 | Urgent |

### Pagination

- Use `page` (1-indexed) and `per_page` (max 100) parameters
- Increment `page` by 1 each request
- Continue until returned results count < `per_page`
- Default page size is 30

### Finding Tickets by Date Range

```
1. Call FRESHSERVICE_LIST_TICKETS with updated_since='2024-01-01T00:00:00Z'
2. Optionally add order_by='updated_at' and order_type='desc'
3. Paginate through results
```

## Known Pitfalls

**Numeric Codes**:
- Status and priority use numeric values, not strings
- Source channel uses numeric codes (1-6)
- Impact and urgency use numeric codes (1-3 or 1-4)

**Date Filtering**:
- Default returns only tickets from the last 30 days
- Use `updated_since` parameter for older tickets
- Date format is ISO 8601 (e.g., '2024-01-01T00:00:00Z')

**Rate Limits**:
- Freshservice API has per-account rate limits
- Each `include` option consumes additional API credits
- Implement backoff on 429 responses

**Response Parsing**:
- Response data may be nested under `data` or `data.data`
- Parse defensively with fallback patterns
- Ticket IDs are numeric integers

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| List tickets | FRESHSERVICE_LIST_TICKETS | filter, updated_since, page, per_page |
| Get ticket | FRESHSERVICE_GET_TICKET | ticket_id, include |
| Create ticket | FRESHSERVICE_CREATE_TICKET | subject, description, status, priority, email |
| Bulk update | FRESHSERVICE_BULK_UPDATE_TICKETS | ids, update_fields |
| Outbound email ticket | FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL | email, subject, description |
| Service request | FRESHSERVICE_CREATE_SERVICE_REQUEST | item_display_id, email, quantity |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
Zendesk Automation Claude Office Skills Скилл Zendesk Automation распределяет обращения по отделам и отслеживает SLA в Zendesk. Пригодится командам поддержки, чтобы ускорить обработку тикетов. CX Codex +1 4 700установок teamwork-desk membrane Управляет тикетами, клиентами и компаниями в службе поддержки Teamwork Desk прямо из диалога с агентом через утилиту Membrane CLI. CX Codex +1 217установок persona-customer-support официальный googleworkspace Скилл persona-customer-support, который превращает ИИ-агента в поддержку: разбирает входящие письма, ведёт тикеты и эскалирует срочное в командный чат. CX Codex +1 31 000установок freshdesk membrane Скилл для работы с Freshdesk через агент: читай тикеты, контакты, компании, создавай заявки и добавляй заметки прямо из редактора. CX Codex +1 653установок outlook-calendar-automation sickn33 Скилл outlook-calendar-automation даёт агенту доступ к календарю Outlook через Rube MCP: создавать встречи, искать свободные окна, править и отменять события. CX Codex +1 967установок jira-automation davila7 Скилл jira-automation для Claude Code, управляет задачами и спринтами в Jira через Rube MCP. Ищет тикеты через JQL и обновляет проект из терминала. CX Codex +1 50установок

Из того же набора235

Весь набор →
circleci-automation Скилл circleci-automation для Claude Code управляет CircleCI через Rube MCP: запускает пайплайны, проверяет статусы воркфлоу и джобов, скачивает артефакты и результаты тестов. Требует активной авторизации CircleCI через Composio. CX Codex +1 122установок posthog-automation Скилл posthog-automation для Claude Code автоматизирует работу с PostHog через Rube MCP: отправляет события и управляет feature-флагами, проектами, профилями пользователей и аннотациями. CX Codex +1 121установок wrike-automation Скилл wrike-automation для Claude Code автоматизирует работу с Wrike через Rube MCP: задачи, папки, проекты, исполнителей и статусы. Управляет проектами из чата с агентом. CX Codex +1 121установок zoho-crm-automation Скилл zoho-crm-automation для автоматизации операций в Zoho CRM через Rube MCP: создание и обновление записей, поиск контактов, управление лидами и их конвертация. Нужна активная подписка на Zoho и подключение Rube MCP. CX Codex +1 121установок stripe-automation Скилл stripe-automation управляет платежами, подписками, счетами и возвратами в Stripe через шлюз Rube MCP прямо из чата с агентом. CX Codex +1 120установок mixpanel-automation Скилл mixpanel-automation автоматизирует работу с Mixpanel: собирает события, строит воронки, запрашивает профили пользователей и когорты. Работает через Rube MCP (Composio) — нужна активная подписка на Mixpanel. CX Codex +1 120установок coda-automation Скилл coda-automation управляет документами, таблицами и правами в Coda через Rube MCP прямо из чата с агентом. CX Codex +1 120установок postmark-automation Скилл postmark-automation гоняет Postmark через Rube MCP: отправка писем по шаблонам, правка шаблонов, статистика доставки и разбор bounce'ов прямо из чата с агентом. CX Codex +1 120установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой