Summarize

Overview

The Summarize message condenses conversations into concise summaries to enhance understanding of specific contexts.

API Reference

Endpoint

• WebSocket URL: wss://ws-{{tenant}}.oco.optave.{{tld}}
• REST Endpoint (POST): https://{{tenant}}.oco.optave.{{tld}}/message/summarize

To be able to send messages, it is necessary to authenticate first.

Request Payload

The summarize message requires a payload containing the conversation history (conversations), connections.threadId, and context.organizationId (your client-specific organization ID). The other fields are optional.

REST

{
  session: {
    sessionId: "a1b2c3d4-e5f6-7890-abcd-123456789012",
    channel: { language: "en-US" },
    interface: { type: "chat" }
  },
  request: {
    requestId: "a1b2c3d4-e5f6-7890-1234-56789ab2345",
    attributes: {
      variant: "A"
    },
    connections: {
      threadId: "9e8d7c6b-5a49-3827-1605-948372615abc" // REQUIRED
    },
    context: { // generated by optave
      organizationId: "f7e8d9c0-b1a2-3456-7890-123456789abc" // REQUIRED
    },
    scope: {
      conversations: [ // REQUIRED
        {
          conversationId: "7f6e5d4c-3b2a-1098-fedc-ba9876543210",
          participants: [
            {
              participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
              displayName: "Alice Hawthorne",
              role: "user"
            },
            {
              participantId: "5b8c9d0e-2f4a-6b1c-9d8e-123456789abc",
              displayName: "Tom Callahan",
              role: "operator"
            }
          ],
          messages: [
            {
              content: "My flight was cancelled and I need to rebook",
              participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
              timestamp: "2024-01-15T10:30:00.000Z"
            },
            {
              content: "I understand this is frustrating. Let me help you with rebooking your flight. Could you please provide your booking reference?",
              participantId: "5b8c9d0e-2f4a-6b1c-9d8e-123456789abc",
              timestamp: "2024-01-15T10:30:30.000Z"
            },
            {
              content: "Sure, it is XYZ789",
              participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
              timestamp: "2024-01-15T10:31:00.000Z"
            }
          ],
          metadata: {}
        }
      ]
    }
  }
}

WebSocket

{
  headers: {
    correlationId: "20e35101-61e8-46e0-926d-6af84b378d95",
    tenantId: "6e3j5hdgemmjmoqih5u9b4mmqhrr",
    traceId: "405101-61e8-46e0-926d-6af84b378d95",
    idempotencyKey: "30e35101-61e8-46e0-926d-6af84b378d95",
    identifier: "message",
    action: "summarize",
    schemaRef: "optave.message.v3",
    sdkVersion: "3.2.1",
    timestamp: "2025-09-05T16:30:00.000Z"
  },
  payload: {
    session: {
      sessionId: "a1b2c3d4-e5f6-7890-abcd-123456789012",
      channel: { language: "en-US" },
      interface: { type: "chat" }
    },
    request: {
      requestId: "a1b2c3d4-e5f6-7890-1234-56789ab2345",
      attributes: {
        variant: "A"
      },
      connections: {
        threadId: "9e8d7c6b-5a49-3827-1605-948372615abc" // REQUIRED
      },
      context: { // generated by optave
        organizationId: "f7e8d9c0-b1a2-3456-7890-123456789abc" // REQUIRED
      },
      scope: {
        conversations: [ // REQUIRED
          {
            conversationId: "7f6e5d4c-3b2a-1098-fedc-ba9876543210",
            participants: [
              {
                participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
                displayName: "Alice Hawthorne",
                role: "user"
              },
              {
                participantId: "5b8c9d0e-2f4a-6b1c-9d8e-123456789abc",
                displayName: "Tom Callahan",
                role: "operator"
              }
            ],
            messages: [
              {
                content: "My flight was cancelled and I need to rebook",
                participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
                timestamp: "2024-01-15T10:30:00.000Z"
              },
              {
                content: "I understand this is frustrating. Let me help you with rebooking your flight. Could you please provide your booking reference?",
                participantId: "5b8c9d0e-2f4a-6b1c-9d8e-123456789abc",
                timestamp: "2024-01-15T10:30:30.000Z"
              },
              {
                content: "Sure, it is XYZ789",
                participantId: "2c4f8a9b-1d3e-5f70-8293-456789012def",
                timestamp: "2024-01-15T10:31:00.000Z"
              }
            ],
            metadata: {}
          }
        ]
      }
    }
  },
  action: "message"
}

Responses

🟢 Success (200-201)

The response consists of a summarize superpower.

{
  action: "superpower",
  actionType: "summarize",
  state: "completed",
  message: {
    results: [
      {
        response: [
          {
            content: "I need some help booking a ticket for the helicopter flight"
          }
        ]
      }
    ]
  }
}

🔴 Error

Error messages are similar in format to success messages, but contain an error state and a "response" JSON object:

{
  action: "superpower",
  actionType: "<superpower-name>",
  state: "error",
  message: {
    results: [
      {
        response: [
          {
            content: 'Error while fetching results'
          }
        ]
      }
    ]
  }
}