repairshopr-ticket-comment

name	repairshopr-ticket-comment
description	Add a comment to an existing RepairShopr ticket
license	MIT
compatibility	opencode
metadata	{"audience":"technicians, kiosk applications","api":"POST /tickets/{id}/comment"}

What I do

I add a comment to an existing RepairShopr ticket. Can optionally set the comment as hidden (private/internal) and attribute it to a specific technician.

When to use me

Use this when:

• Adding the initial customer issue description
• Updating ticket status with notes
• Adding private/internal notes (hidden from customer)
• Recording serial numbers, PINs, or diagnostic info

How to use

Required API base URL:

• VITE_REPAIRSHOPR_SUBDOMAIN
• VITE_REPAIRSHOPR_API_KEY

Required:

• ticketId (integer) - The ticket ID

Parameters:

• subject (string) - Comment subject/title
• body (string) - Comment content (can be plain text or HTML)
• tech (string) - Technician name (e.g., "Jesus Vargas")
• user_id (integer) - User ID performing the action
• hidden (boolean) - If true, comment is private/internal
• sms_body (string) - SMS version of comment
• do_not_email (boolean) - Prevent email notification

Example call:

const result = await skill({ name: "repairshopr-ticket-comment" }, {
  ticketId: 12345,
  subject: "Initial Issue",
  body: "Customer reports laptop will not power on. Battery not charging.',
  tech: "Jesus Vargas",
  user_id: 131330,
  hidden: false
})

Response includes:

• comment object with id, created_at, subject, body, etc.

Hidden comments

Set hidden: true for:

• Serial numbers and system info
• Internal diagnostic notes
• Anything the customer should not see

Text formatting

• Use plain text for simplicity
• If comment_format parameter is set on ticket, it may affect formatting
• For rich text, pass HTML in body

Notes

• Requires "Tickets - Edit" permission
• Both subject and body are required unless you're only updating specific fields