Available · v1

Support Triage

Send a support message, get back a category, a priority, and whether a person should look at it. One request, three typed fields, ready for your routing rules.

  • Route tickets to the right queue the moment they arrive
  • Surface urgent outages and blocked customers first
  • Send legal threats and security reports to a person automatically
  • Typed enums and booleans, so routing logic stays in your code
Try it in the playgroundAPI referenceGuides
Request body
{
  "subject": "Refund not received",
  "message": "I returned my order two weeks ago and still haven't received my refund."
}
Response · 200 OK
{
  "request_id": "req_8sJq2LwzVd0cYb1E",
  "category": "billing",
  "priority": "medium",
  "requires_human_review": false
}
Output

A small, stable response

The response contract is versioned and stays the same as Kovca improves how results are produced.

FieldType
category

The area the ticket is mainly about.

billing | technical | account | product | other
priority

How urgent the customer's issue is.

low | medium | high
requires_human_review

True when the ticket mentions legal action or a security problem, or when the classification is ambiguous.

boolean
Integrate

One HTTP call

const response = await fetch("https://kovca.io/api/v1/support/triage", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KOVCA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "subject": "Refund not received",
    "message": "I returned my order two weeks ago and still haven't received my refund."
  }),
});

if (!response.ok) {
  const { error, request_id } = await response.json();
  throw new Error(`${error.code}: ${error.message} (${request_id})`);
}

const { category, priority, requires_human_review } = await response.json();
Create an API key

Related APIs

  • Shipment Intelligence

    Interpret shipment tracking exceptions and route each one to the right workflow.

  • Incident Intelligence

    Classify incidents, evaluate severity against your escalation policy, and recommend handling.

  • Lead Intelligence

    Qualify inbound leads by stated intent and your criteria, and recommend follow-up priority.