repairshopr-kiosk-checkin

name	repairshopr-kiosk-checkin
description	Complete check-in workflow: find/create customer, create ticket, add system info

What I do

I perform the full check-in workflow for a repair shop kiosk:

1. Search for an existing customer by email/phone
2. Create new customer if not found
3. Create a support ticket
4. Add the formatted issue description as a comment
5. Attach system info (serial, PIN) as a hidden private note

When to use me

Use this when you need a single-call solution for a self-service check-in kiosk that:

• Handles both existing and new customers
• Uses AI to format the customer's description
• Creates a complete ticket with all metadata
• Stores serial numbers and PINs privately

How to use

Required API base URL:

• VITE_REPAIRSHOPR_SUBDOMAIN
• VITE_REPAIRSHOPR_API_KEY

Also requires AI services for title generation and description formatting:

• VITE_API_BASE_URL (points to your backend with Nvidia API)

Parameters:

• customerEmail (string) - Customer's email
• customerPhone (string) - Customer's phone
• customerName (string, optional) - Full name for new customers
• ticketSubject (string) - Ticket subject (AI-generated if not provided)
• problemType (string) - Problem type/category (default: "Hardware")
• description (string) - Raw customer issue description
• unitSerialNumber (string) - Device serial number
• unitPin (string, optional) - Device PIN/passcode
• technicianId (integer) - User ID for ticket assignment
• technicianName (string) - Technician name for comments
• forceNew (boolean) - Skip search, always create new customer

Example call:

const result = await skill({ name: "repairshopr-kiosk-checkin" }, {
  customerEmail: "[e-mail]",
  customerPhone: "555-1234",
  customerName: "John Doe",
  description: "My laptop won't turn on, the power button doesn't respond.",
  unitSerialNumber: "ABC123",
  problemType: "Hardware",
  technicianId: 131330,
  technicianName: "Jesus Vargas"
})

Response includes:

• customer - Customer record (created or found)
• ticket - Created ticket
• ticketId - Ticket ID for reference
• formattedDescription - The AI-formatted description

Workflow details

1. Search: Attempts to find customer by email, then by phone
2. Create: If not found and name/email/phone provided, creates new customer
3. Ticket: Creates ticket with customer_id, subject, problem_type
4. Comment: Adds initial issue comment with formatted description
5. System note: Adds hidden comment with serial/PIN as "System Info"

Error handling

• If customer creation fails, the entire workflow fails
• If ticket creation fails, attempts to roll back or mark appropriately
• Returns descriptive error messages for each step

Permissions required

• Customers: List/Search, Create
• Tickets: Create, Edit (for comments)
• Comments: Add