Tag conversation transcripts | Makimoto

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

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

Process and tag conversation transcripts with relevant labels or categories.

Inline mode — omit callback_url: returns 200 OK with the tags in data.

Async mode — set callback_url: returns 202 Accepted and POSTs the result to your callback_url when ready. See the tagDelivered operation under Webhooks for the payload shape, retry policy, and correlation contract.

Request

This endpoint expects an object.

transcriptslist of stringsRequired

call_uuidstringRequired

callback_urlstringRequiredformat: "uri"

Response

Inline mode (no callback_url).

statusstring

call_uuidstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

504

Gateway Timeout Error

Headers

Request

Response

Errors