ApiAIAssistant provides AI Assistant APIs for transcript controls.

Constructors

Properties

metricsManager: default
pendingRtdRequests: Map<string, PendingRtdRequest<unknown>> = ...
webex: WebexSDK
wellnessContextProvider?: WellnessBreakContextProvider

Methods

  • Fetches historic transcripts for an interaction. This API is allowed only when real-time transcription feature is enabled.

    Parameters

    • agentId: string
    • interactionId: string

      interaction/conversation identifier

    Returns Promise<HistoricTranscriptsResponse>

  • Requests real-time assistance for an interaction.

    Parameters

    • params: RealTimeAssistanceParams

      Real-time assistance request parameters

    Returns Promise<Record<string, unknown>>

    HTTP response body from the AI Assistant event API

  • Requests an Agent Wellness Break. The promise resolves when the HTTP request is accepted with status 202; the later approval or denial is delivered independently through a wellness notification.

    Returns Promise<void>

    A promise that resolves with no value after HTTP acceptance

    Throws

    Structured Contact Center error when disabled, stale, invalid, or delivery fails

    Example

    await webex.cc.apiAIAssistant.requestWellnessBreak();
    @public
  • Responds to a backend-provided Agent Wellness Break offer. The promise resolves when the HTTP request is accepted with status 202 and does not wait for a WebSocket completion event.

    Parameters

    Returns Promise<void>

    A promise that resolves with no value after HTTP acceptance

    Throws

    Structured Contact Center error when disabled, stale, invalid, or delivery fails

    Example

    await webex.cc.apiAIAssistant.respondToWellnessBreak({
    action: WELLNESS_BREAK_USER_ACTIONS.ACCEPTED,
    });
    @public
  • Sends an event to the AI Assistant service.

    Parameters

    • agentId: string

      agent identifier

    • interactionId: string

      interaction/conversation identifier

    • eventType: AIAssistantEventType

      the type of event (e.g. 'CUSTOM_EVENT')

    • eventName: AIAssistantEventName

      the name of the event (e.g. 'GET_TRANSCRIPTS')

    • Optional eventMetaData: Record<string, unknown>

      event-specific fields to include in eventDetails.data

    • Optional languageCode: string

      language code within eventDetails.data

    • Optional trackingId: string

      tracking identifier within eventDetails.data

    • Optional publishTimestamp: number
    • Optional timeout: number

    Returns Promise<Record<string, unknown>>

  • Sends user action feedback for a real-time assistance adaptive card.

    Parameters

    • params: RealTimeAssistanceUserActionParams

      Real-time assistance user action parameters

    Returns Promise<Record<string, unknown>>

    HTTP response body from the AI Assistant event API

  • Parameters

    • rtdEventType: string
    • correlationId: string

    Returns string

  • Type Parameters

    • T

    Parameters

    • rtdEventType: string
    • correlationId: string
    • Optional settle: ((request) => void)
        • (request): void
        • Parameters

          • request: PendingRtdRequest<T>

          Returns void

    Returns PendingRtdRequest<T>