delete_ticket
Delete Ticket
Permanently delete a HelpDesk ticket by its ID. This action is irreversible and will remove the ticket and all associated data including messages, attachments, and activity history.
delete_ticket
Permanently delete a HelpDesk ticket by its ID. This action is irreversible and will remove the ticket and all associated data including messages, attachments, and activity history.
list_tickets
List and search HelpDesk tickets with filtering, sorting, and pagination. Use filters to narrow results by status, team, assignee, tags, requester email, date ranges, or free-text search. Supports cursor-based pagination for large result sets.
get_report
Fetch reporting data from HelpDesk. Available report types: new-tickets, ticket-sources, ticket-rating, agent-rating, rating-per-agent, rating-per-team, ticket-status, tickets-status-per-agent, tickets-status-per-team, response-time, response-time-per-agent, response-time-per-team, resolution-time, resolution-time-per-agent, resolution-time-per-team, new-tickets/24h-distribution, ticket-sources/24h-distribution, ticket-rating/24h-distribution, ticket-status/24h-distribution, response-time/24h-distribution, resolution-time/24h-distribution, failed-outgoing-emails, tickets-status-duration, tickets-status-duration-total, tickets-status-duration-per-agent, tickets-status-duration-per-team.
manage_macros
Manage HelpDesk macros. Supports listing all macros, getting a specific macro by ID, creating new macros, updating existing macros, and deleting macros. Macros are reusable sets of actions that can be applied to tickets.
get_ticket
Retrieve the full details of a single HelpDesk ticket by its ID. Returns complete ticket information including events (messages and activity), requester details, tags, custom fields, rating, and merge status.
manage_rules
Manage HelpDesk automation rules. Supports listing all rules, getting a specific rule by ID, creating new rules, updating existing rules, and deleting rules. Rules define automated triggers and actions for ticket processing.
update_ticket
Update an existing HelpDesk ticket. This is a flexible tool that combines core ticket updates, tag management, follower management, and silo movement into a single operation. Only provide the fields you want to change; all optional fields that are omitted will remain unchanged.
query_audit_log
Query the HelpDesk audit log to retrieve a history of actions performed in the account. Supports filtering by action type, entity type, author, and date range with pagination.
create_ticket
Create a new HelpDesk ticket. At minimum, a subject and requester email are required. Optionally set initial status, priority, team assignment, agent assignment, tags, followers, CC recipients, and custom field values.
manage_agents
List, get, create, update, and delete HelpDesk agents. Agents are team members who handle tickets and customer communication. Use this tool to manage the agents in your HelpDesk account, including their roles, team assignments, and autoassignment settings.
manage_tags
List, get, create, update, and delete HelpDesk tags. Tags are labels that can be applied to tickets for categorization, filtering, and automation. Tags can optionally be scoped to specific teams.
manage_canned_responses
List, get, create, update, and delete HelpDesk canned responses. Canned responses are pre-written reply templates that agents can quickly insert into ticket replies to save time and ensure consistent messaging. They can have keyboard shortcuts and be scoped to specific teams.
manage_teams
List, get, create, update, and delete HelpDesk teams. Teams are used to organize agents into groups for ticket routing, assignment, and collaboration. Each team can have its own set of agents, tags, and canned responses.
manage_custom_fields
List, get, create, update, and delete HelpDesk custom fields. Custom fields allow you to add additional structured data to tickets beyond the default fields. They support different data types (single line text, multi-line text, URL, date) and can be scoped to specific teams with configurable edit permissions.
merge_tickets
Merge or unmerge HelpDesk tickets. In "merge" mode, multiple child tickets are merged into a single parent ticket, consolidating their conversations. In "unmerge" mode, a previously merged ticket is separated back into individual tickets.
send_rating_request
Send a customer satisfaction rating request email to the requester of a HelpDesk ticket. The requester will receive an email allowing them to rate their support experience as good, neutral, or bad, with an optional comment.
Manage customer support tickets including creating, updating, assigning, and filtering tickets by status, priority, tags, teams, and custom fields. Add public or private messages and attachments to ticket conversations. Import historical tickets from other systems. Manage agents with roles, team membership, and autoassignment settings. Organize agents into teams with configurable email templates and reply addresses. Create automation rules with triggers and actions to automatically process tickets. Define reusable macros and canned response templates. Configure custom email domains and mailboxes for inbound routing. Create saved ticket filter views. Access reports on ticket volume, ratings, response times, and resolution times. Query audit logs of system changes. Manage webhooks for ticket lifecycle events including creation, updates, status changes, assignment changes, new messages, and tag changes.
Common questions about connecting Helpdesk to AI agents with Metorial.