Contenedor V1

En esta página, se incluye la documentación de la API para el método de contenedor de implementación de módulos de IU. A continuación, se indican las funciones de Agent Assist que puedes implementar como componentes dentro de tu contenedor.

Atributos

Nombre de la propiedad Tipo Comentario
características cadena Lista separada por comas de las claves de funciones de sugerencias de Agent Assist que se renderizarán. Ejemplo: "SMART_REPLY, CONVERSATION_SUMMARIZATION"
api-headers cadena Son encabezados adicionales que se incluyen en las llamadas a la API de Dialogflow. Ejemplo: "Content-Type:application/json, Accept:application/json"
conversation-profile cadena Nombre del perfil de conversación que se usará.
agent-desktop AgentDesktop Software de escritorio del agente con el que se realizará la integración.
auth-token cadena Es el token de autenticación que se usará para las llamadas a la API.
api-key cadena Es la clave de API opcional que se usará para las llamadas a la API.
canal CommunicationChannel Canal de comunicación que se usa para esta aplicación (chat, voz o omnicanal).
custom-api-endpoint cadena Es un extremo de API personalizado opcional para usar (si los módulos de la IU están configurados con un servidor proxy).
tema "dark" | "light" Es el tema de color que se usará.
show-header BooleanString Indica si se debe mostrar el encabezado de sugerencias de Agent Assist.
dark-mode-background cadena Color de fondo que se usará para el modo oscuro. Si no se especifica ninguno, se proporcionan valores predeterminados para los escritorios de agentes principales admitidos.
notifier-server-endpoint cadena Es el extremo del servidor de notificaciones que se usará para las conversaciones basadas en eventos.
event-based-transport EventBasedTransport Es el protocolo de transporte que se usará para las conversaciones basadas en eventos.
event-based-library EventBasedLibrary Biblioteca que se usará para las conversaciones basadas en eventos.
oauth-client-id cadena ID de cliente de OAuth opcional para la autenticación implícita, que se usa en algunas configuraciones de escritorio del agente (Genesys Cloud).
redirect-uri cadena Es el URI de redireccionamiento opcional al que se puede navegar después de la autenticación, que se usa en algunos parámetros de configuración de escritorio del agente (Genesys Cloud).
genesys-cloud-region cadena Región opcional para Genesys Cloud. El valor predeterminado es mypurecloud.com.

Uso

Los atributos son propiedades de componentes basadas en cadenas que se pueden establecer de las siguientes maneras:

HTML

js <element-selector property-name="value">

JavaScript

js var el = document.querySelector('element-selector'); el.setAttribute('property-name', 'value');

Entradas

Nombre de la propiedad Tipo Comentario
socketIoConnectOpts SocketIoConnectOpts Son opciones de conexión adicionales de Socket.io.
config UiModuleContainerConfig Objeto de configuración para definir configuraciones específicas del módulo.

Uso

Por lo general, las entradas son objetos JavaScript u otros tipos de propiedades complejas que se deben asignar directamente en la instancia del elemento:

const el = document.querySelector('element-selector');
el.propertyName = value;

Tipos

Consulta la siguiente sección para conocer los tipos personalizados que usa el componente.

AgentDesktop

"LivePerson" | "GenesysCloud" | "SalesForce" | "Custom"

CommunicationChannel

"chat" | "voice" | "omnichannel"

BooleanString

"true" | "false"

EventBasedTransport

"websocket" | "polling"

EventBasedLibrary

"SocketIo"

SocketIoConnectOpts

interface SocketIoConnectOpts extends SocketIOClient.ConnectOpts {
  auth: {
    token: string;
  };
  withCredentials?: boolean;
}

UiModuleContainerConfig

interface UiModuleContainerConfig {
  knowledgeAssistConfig?: {
    articleLinkConfig: {
      /**
       * Whether to open the article in a new tab or as a dialog. Defaults to new
       * tab.
       */
      target?: "blank" | "popup";
      /**
       * Options to configure the popup's size and location. See
       * https://developer.mozilla.org/en-US/docs/Web/API/Window/open#window_features.
       */
      popupWindowOptions?: string;
      /**
       * The field name on the document metadata if a separate article link source
       * is provided.
       */
      linkMetadataKey?: string;
    };
  };
  knowledgeAssistV2Config?: {
    articleLinkConfig?: {
      /**
       * Whether to open the article in a new tab or as a dialog. Defaults to new
       * tab.
       */
      target?: "blank" | "popup";
      /**
       * Options to configure the popup's size and location. See
       * https://developer.mozilla.org/en-US/docs/Web/API/Window/open#window_features.
       */
      popupWindowOptions?: string;
      /**
       * The field name on the document metadata if a separate article link source
       * is provided.
       */
      linkMetadataKey?: string;
    };
    showCopyAnswer: boolean;
    showPasteAnswer: boolean;
  };
  summarizationConfig?: {
    /**
     * Optional callback that can be used to save the generated summary to an
     * external source.
     */
    onSaveSummary?: (
      summary: {
        summary: string;
        conversationDetails: ConversationDetails;
      },
      saveCallbacks: {
        setLoading: () => void;
        setSuccess: (message: string) => void;
        setError: (message: string) => void;
      }
    ) => void;

    /** Whether to show the 'Generate summary' button. */
    showGenerateSummaryButton?: "true" | "false";
  };
}