Tag conversation transcripts | Makimoto

curl -X POST https://https//https/tag \
     -H "apikey: {{apikey}}" \
     -H "Content-Type: application/json" \
     -d '{
  "call_uuid": "call-abc123",
  "transcripts": [
    "Agent: Hello, how can I help you today?\nCustomer: I have a billing issue."
  ],
  "callback_url": "https://https//hooks.example.com/cb"
}'

{
  "data": {
    "tags": [
      {
        "call_reason": [
          "general_inquiry"
        ],
        "call_outcome": [
          "issue_resolved"
        ],
        "agent_approach": [
          "agent_helpful"
        ],
        "agent_behaviour": [
          "agent_acts_professionally",
          "agent_greets_at_start",
          "agent_ends_professionally"
        ],
        "customer_behaviour": [
          "customer_polite"
        ],
        "customer_sentiment": [
          "customer_negative_sentiment"
        ],
        "malicious_agent_behaviour": []
      }
    ],
    "meta_data": {
      "msg_id": "089f4f5c-32b3-4e98-9e76-e3eeca7f6aaf",
      "total_tokens": 686,
      "prompt_tokens": 589,
      "time_taken_secs": 19.275431,
      "completion_tokens": 97,
      "time_per_example_secs": 19.275431,
      "per_example_completion_tokens": [
        97
      ]
    }
  },
  "status": "S001"
}

Process and tag conversation transcripts with relevant labels or categories. Returns results inline when callback_url is omitted; otherwise returns 202 Accepted and POSTs the result to the callback when ready.

Request

This endpoint expects an object.

call_uuidstringRequired

transcriptslist of stringsRequired

callback_urlstringRequiredformat: "uri"

Response

Inline mode (no callback_url).

dataobject

statusstring

Errors

401

Unauthorized Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

504

Gateway Timeout Error

Headers

Request

Response

Errors