Conteneur V1

Cette page contient la documentation de l'API pour la méthode de conteneur permettant d'implémenter des modules d'interface utilisateur. Vous trouverez ci-dessous les fonctionnalités d'Agent Assist que vous pouvez implémenter en tant que composants dans votre conteneur.

Attributs

Nom de propriété Type Commentaire
fonctionnalités chaîne Liste des clés de fonctionnalités de suggestions d'Agent Assist à afficher, séparées par une virgule. Exemple : "SMART_REPLY, CONVERSATION_SUMMARIZATION"
api-headers chaîne En-têtes supplémentaires à inclure dans les appels d'API Dialogflow. Exemple : "Content-Type:application/json, Accept:application/json"
conversation-profile chaîne Nom du profil de conversation à utiliser.
agent-desktop AgentDesktop Logiciel de bureau d'agent à intégrer.
auth-token chaîne Jetons d'authentification à utiliser pour les appels d'API.
api-key chaîne Clé API facultative à utiliser pour les appels d'API.
channel CommunicationChannel Canal de communication utilisé pour cette application (chat, voix ou omnicanal).
custom-api-endpoint chaîne Point de terminaison d'API personnalisé facultatif à utiliser (si les modules d'interface utilisateur sont configurés avec un serveur proxy).
thème 'dark' | 'light' Thème de couleurs à utiliser.
show-header BooleanString Indique si l'en-tête des suggestions d'Agent Assist doit être affiché.
dark-mode-background chaîne Couleur d'arrière-plan à utiliser pour le mode sombre. Si aucune couleur n'est spécifiée, des valeurs par défaut sont fournies pour les principaux bureaux d'agent compatibles.
notifier-server-endpoint chaîne Point de terminaison du serveur de notification à utiliser pour les conversations basées sur des événements.
event-based-transport EventBasedTransport Protocole de transport à utiliser pour les conversations basées sur des événements.
event-based-library EventBasedLibrary Bibliothèque à utiliser pour les conversations basées sur des événements.
oauth-client-id chaîne ID client OAuth facultatif pour l'authentification implicite, utilisé dans certaines configurations de bureau d'agent (Genesys Cloud).
redirect-uri chaîne URI de redirection facultatif vers lequel accéder après l'authentification, utilisé dans certaines configurations de bureau d'agent (Genesys Cloud).
genesys-cloud-region chaîne Région facultative pour Genesys Cloud, par défaut mypurecloud.com.

Utilisation

Les attributs sont des propriétés de composants basées sur des chaînes qui peuvent être définies de différentes manières :

HTML

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

JavaScript

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

Entrées

Nom de propriété Type Commentaire
socketIoConnectOpts SocketIoConnectOpts Options de connexion Socket.io supplémentaires.
config UiModuleContainerConfig Objet de configuration permettant de définir des configurations spécifiques aux modules.

Utilisation

Les entrées sont généralement des objets JavaScript ou d'autres types de propriétés complexes qui doivent être attribués directement à l'instance d'élément :

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

Types

Pour connaître les types personnalisés utilisés par le composant, consultez la section suivante.

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";
  };
}