API Endpoint

POST Ticket Analyze API

/api/v1/ai/ticket-analyze

Analyze category, intent, sentiment, priority, urgency, department routing, and recommended actions of a customer support ticket.

Request Body Parameters

Field	Type	Required	Description
`ticket`	string	Required	The customer support ticket message text (Max: 20,000 characters).
`subject`	string	Optional	Optional ticket subject header.
`language`	string	Optional	Optional ticket language identifier.
`customer_context`	string	Optional	Optional customer account details context.
`product_context`	string	Optional	Optional product catalogs or specs context.
`business_context`	string	Optional	Optional support operational policies or rules context.
`previous_messages`	array	Optional	Optional array of previous messages in the ticket conversation thread.
`model`	string	Optional	Optional AI model to use.

Example Request

This example demonstrates how to request an analysis of a single login problem support ticket.

JSON Request

{
  "ticket": "I cannot log in to my account. It keeps saying invalid password even after resetting it.",
  "subject": "Login issue",
  "customer_context": "User ID: 12345, Active Premium Subscription."
}

cURL

curl -X POST https://rsflowhub.com/api/v1/ai/ticket-analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": "I cannot log in to my account. It keeps saying invalid password even after resetting it.",
    "subject": "Login issue",
    "customer_context": "User ID: 12345, Active Premium Subscription."
  }'

Example Response

The response returns intent, category, department recommendations, urgency indicators, and priority level details.

JSON Response

{
  "success": true,
  "data": {
    "result": {
      "category": "account",
      "intent": "restore_access",
      "sentiment": "negative",
      "priority": "high",
      "urgency": "high",
      "issue_summary": "Customer is unable to access their account due to password reset failures.",
      "key_problem": "Password reset mechanism not restoring account access.",
      "requires_human": true,
      "suggested_department": "account_support",
      "recommended_action": "assign_agent",
      "language": "en",
      "confidence": 0.96
    }
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 998
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.