אירועים במודול ממשק המשתמש

בדף הזה מופיע תיעוד ה-API של כל האירועים במודול ממשק המשתמש המותאם אישית.

פרטי האירוע

שם האירוע Payload תיאור
active-conversation-selected ActiveConversationSelectedPayload מופעל כשבוחרים שיחה.
smart-reply-selected SmartReplySelection האירוע הזה מופעל כשבוחרים תשובה מהירה.
smart-reply-follow-up-suggestions-received SmartReplyFollowUpSuggestionsReceivedPayload האירוע הזה מופעל כשמתקבלות הצעות למעקב אחרי תשובה מהירה.
conversation-details-received ConversationDetailsReceivedPayload האירוע הזה מופעל כשמתקבלים פרטי השיחה מ-SDK (כולל פרטי הנציג והלקוח).
conversation-initialization-requested ConversationInitializationRequestedPayload האירוע הזה נשלח כשצריך לאתחל את השיחה ב-Dialogflow.
conversation-initialized ConversationInitializedPayload האירוע הזה מופעל כששיחה ב-Dialogflow עוברת אתחול.
conversation-started ConversationStartedPayload האירוע הזה נשלח כשהשיחה ב-Dialogflow מתחילה.
conversation-completed ConversationCompletedPayload הבקשה נשלחת במורד הזרם כדי להודיע לרכיבי ממשק המשתמש ולמנויים שהשיחה ב-Dialogflow הסתיימה בהצלחה בקצה העורפי.
complete-conversation-requested CompleteConversationRequestedPayload הבקשה נשלחת על ידי מחבר או שילוב כדי לסמן שהשיחה ב-Dialogflow הסתיימה.
conversation-profile-requested ConversationProfileRequestedPayload האירוע הזה נשלח כשמאחזרים את פרופיל השיחה של Dialogflow.
conversation-profile-received ConversationProfileReceivedPayload האירוע הזה נשלח כשפרופיל השיחה ב-Dialogflow מתקבל.
conversation-model-requested ConversationModelRequestedPayload האירוע הזה נשלח כשמתבצעת אחזור של מודל שיחה של Dialogflow.
conversation-model-received ConversationModelReceivedPayload האירוע הזה מופעל כשמתקבל מודל השיחה של Dialogflow.
new-message-received NewMessageReceivedPayload האירוע הזה מופעל כשמתקבלת הודעה חדשה בתמליל.
analyze-content-requested AnalyzeContentRequestDetails האירוע הזה נשלח כשצריך לשלוח בקשה לניתוח תוכן.
analyze-content-response-received AnalyzeContentResponseReceivedPayload האירוע הזה מופעל כשמתקבל AnalyzeContentResponse חדש.
conversation-summarization-requested ConversationSummarizationRequestedEventPayload נשלחה בקשה לסיכום השיחה.
stateless-conversation-summarization-requested StatelessConversationSummarizationRequestedPayload נשלחה בקשה לסיכום שיחה ללא שמירת מצב.
stateless-conversation-summarization-response-received StatelessConversationSummarizationResponseReceivedPayload התקבלה תגובה לסיכום שיחה ללא שמירת מצב.
conversation-summarization-received ConversationSummarizationReceivedPayload התקבל סיכום שיחה.
dialogflow-api-error DialogflowApiErrorPayload נתקלת בשגיאה ב-Dialogflow API.
dialogflow-api-authentication-error void נתקלה שגיאת אימות (401) של Dialogflow API.
answer-record-requested AnswerRecordRequestedPayload נשלחה בקשה להקלטת תשובה.
answer-record-received AnswerRecordReceivedPayload התקבל תיעוד של התשובה.
patch-answer-record-requested PatchAnswerRecordRequestedPayload קיבלת בקשה לעדכון של רשומת תשובה.
patch-answer-record-received PatchAnswerRecordReceivedPayload קיבלנו בקשה לעדכון של רשומת תשובה.
article-search-requested ArticleSearchRequestedPayload נשלחה בקשה לחיפוש מאמר.
article-search-response-received ArticleSearchResponseReceivedPayload התקבלו תוצאות חיפוש של מאמרים.
dark-mode-toggled DarkModeToggledPayload החלפת מצב כהה בשולחן העבודה של נציג.
snackbar-notification-requested SnackbarNotificationPayload נשלחה בקשה להצגת התראה בחטיף מידע.
live-person-connector-initialized void המחבר LivePerson אותחל.
genesys-cloud-connector-initialized void המחבר של Genesys Cloud אותחל.
api-connector-initialized void המחבר של ה-API אותחל.
event-based-connector-initialized void המחבר מבוסס-האירועים אותחל.
live-person-connector-initialization-failed void האתחול של המחבר LivePerson נכשל.
genesys-cloud-connector-initialization-failed void האתחול של המחבר ל-Genesys Cloud נכשל.
genesys-cloud-connector-access-token-received GenesysCloudConnectorAccessTokenReceivedPayload התקבל טוקן גישה למחבר Genesys Cloud.
api-connector-initialization-failed void האתחול של מחבר ה-API נכשל.
event-based-connector-initialization-failed void האתחול של המחבר מבוסס-האירועים נכשל.
event-based-connection-established void האירוע נשלח כשנוצר חיבור Websocket.
list-messages-requested ListMessagesRequestedPayload בקשה להצגת ההודעות בשיחה מסוימת.
list-messages-response-received ListMessagesResponseReceivedPayload האירוע הזה מופעל כשמתקבלת תגובה של רשימת הודעות.
virtual-agent-assist-response-message-selected VirtualAgentAssistResponseMessageSelectedPayload האירוע הזה מופעל כשבוחרים הודעת תגובה של Agent Assist וירטואלי. ההודעה שנבחרה תופיע בתיבת הקלט של הסוכן.
human-agent-transfer-initiated HumanAgentTransferInitiatedPayload האירוע הזה מופעל כששיחה מועברת מנציג וירטואלי לנציג אנושי.
search-knowledge-requested SearchKnowledgeRequestedPayload נשלחה בקשה לחיפוש מידע.
search-knowledge-response-received SearchKnowledgeResponseReceivedPayload התקבלה תשובה לחיפוש ידע.
knowledge-assist-v2-answer-pasted מחרוזת תשובה מ-Knowledge Assist v2 שאפשר להדביק בצ'אט.
batch-create-messages-requested BatchCreateMessagesRequestedPayload יצירת הודעות בכמות גדולה בשיחה. ההודעות יתווספו לשיחה בלי שההצעות של Agent Assist יופקו עבורן.
batch-create-messages-response-received BatchCreateMessagesResponseReceivedPayload התקבלה תשובה ליצירת הודעות בכמות גדולה.

מטענים ייעודיים (payloads) של אירועים

לראות את כל מטען הייעודי (payload) של אירועים מותאמים אישית.

ActiveConversationSelectedPayload

interface ActiveConversationSelectedPayload {
  conversationName: string;
}

AnalyzeContentRequestDetails

interface AnalyzeContentRequestDetails {
  type?: string;
  conversationId: string;
  participantRole:
    | "ROLE_UNSPECIFIED"
    | "HUMAN_AGENT"
    | "AUTOMATED_AGENT"
    | "END_USER";

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversations.participants/analyzeContent#request-body
   */
  request: AnalyzeContentRequest;
}

AnalyzeContentResponseReceivedPayload

interface AnalyzeContentResponseReceivedPayload {
  conversationName: string;
  payload: {
    type?: string;

    /**
     * @link
     * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversations.participants#Participant
     */
    participant?: Participant;

    /**
     * @link
     * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversations.participants/analyzeContent#request-body
     */
    request?: AnalyzeContentRequest;

    /**
     * @link
     * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/AnalyzeContentResponse
     */
    response: AnalyzeContentResponse;
  };
}

ArticleSearchRequestedPayload

interface ArticleSearchRequestedPayload {
  queryText: string;
}

ArticleSearchResponseReceivedPayload

interface ArticleSearchResponseReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/priv/docs/reference/rest/v2beta1/projects.locations.conversations.suggestions/searchArticles#response-body
   */
  payload: SearchArticlesResponse;
}

ConversationDetailsReceivedPayload

interface ConversationDetailsReceivedPayload {
  conversationName: string;
  payload: {
    chatInfo: {
      rtSessionId: string;
      accountId: string;
      chatRequestedTime: number;
      chatStartTime: number;
      sessionStartTime: number;
      chatStartUrl: string;
      spectatedEngagement: boolean;
      chatSkill: string;
    };
    chattingAgentInfo: {
      agentName: string;
      agentNickname: string;
      agentGroupName: string;
      agentId: number;
    };
    agentInfo: {
      accountId: string;
      agentName: string;
      agentNickname: string;
      agentId: number;
      agentEmail: string;
      employeeId: string;
      maxChats: number;
      agentGroupName: string;
    };
    chatTranscript: { lines: TranscriptMessage[] };
    surveyQuestions: {
      preChat: {
        email: { value: string; displayName: string };
        phone: { value: string; displayName: string };
        name: { value: string; displayName: string };
        customizedQuestions: [];
      };
      postChat: [];
      agentSurvey: [];
    };
    visitorInfo: {
      visitorId: string;
      visitorName: string;
      visitorSso: boolean;
      device: string;
      browser: string;
      operatingSystem: string;
      country: string;
      countryCode: string;
      state: string;
      city: string;
      isp: string;
      organization: string;
      IpAddress: string;
      visitStartTime: string;
      chattingVisitorState: string;
      chatRequestedTime: string;
      chatStartUrl: string;
      visitorTimezone: string;
      visitorTyping: boolean;
    };
    campaignInfo: {
      campaignName: string;
      campaignId: string;
      campaignDescription: string;
      targetAudience: [];
      goalName: string;
      goalId: string;
      goalDescription: string;
    };
    engagementInfo: {
      VisitorBehavior: [];
      skill: string;
      engagementType: string;
      engagementId: string;
      engagementName: string;
      agentNote: string;
      engagementSkill: string;
    };
    visitorJourney: {
      pages: [];
      searchEngine: { searchProvider: string; searchKeywords: string };
    };
    SDE: {
      customerDetails: [];
      personalInfo: [];
      marketingSource: [];
      leadGeneration: [];
      transaction: [];
      viewedProducts: [];
      shoppingCart: [];
      serviceActivity: [];
      error: [];
    };
    authenticatedData: { customerDetails: []; personalInfo: [] };
    claimsAndAuthType: { claims: {}; acr: string };
    applicationInfo: { theme: "light" | "dark" };
    customVariables: [];
    splitSession: { customVariables: [] };
  };
}

ConversationInitializationRequestedPayload

interface ConversationInitializationRequestedPayload {
  conversationName: string;
}

ConversationInitializedPayload

interface ConversationInitializedPayload {
  conversation: Conversation;
  participants: ParticipantsMap<Participant_ | null>;
}

ConversationProfileRequestedPayload

interface ConversationProfileRequestedPayload {
  conversationProfileName: string;
}

ConversationProfileReceivedPayload

type ConversationProfileReceivedPayload =
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversationProfiles#ConversationProfile
   */
  ConversationProfile | null;

ConversationModelRequestedPayload

interface ConversationModelRequestedPayload {
  modelName: string | null;
}

ConversationModelReceivedPayload

type ConversationModelReceivedPayload =
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversationModels#ConversationModel
   */
  ConversationModel | null;

ConversationSummarizationReceivedPayload

interface ConversationSummarizationReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/SuggestConversationSummaryResponse
   */
  payload: SuggestConversationSummaryResponse;
}

ConversationSummarizationRequestedEventPayload

type ConversationSummarizationRequestedEventPayload = {
  conversationName?: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversations.suggestions/suggestConversationSummary#request-body
   */
  request?: SuggestConversationSummaryRequest;
} | void;

DarkModeToggledPayload

interface DarkModeToggledPayload {
  on: boolean;
}

DialogflowApiErrorPayload

type DialogflowApiErrorPayload = {
  conversationName: string;
  source:
    | "TYPE_UNSPECIFIED"
    | "ARTICLE_SUGGESTION"
    | "FAQ"
    | "SMART_REPLY"
    | "DIALOGFLOW_ASSIST"
    | "SMART_COMPOSE"
    | "ISSUE_SMART_COMPOSE"
    | "SPELL_GRAMMAR_CORRECTION"
    | "CONVERSATION_SUMMARIZATION"
    | "KEY_MOMENT"
    | "ARTICLE_SEARCH"
    | "CONVERSATION_GUIDANCE"
    | "ARTICLE_SUGGESTION_VOICE"
    | "CONVERSATION_SUMMARIZATION_VOICE"
    | "KNOWLEDGE_SEARCH"
    | "KNOWLEDGE_ASSIST"
    | "ENTITY_EXTRACTION"
    | "ANALYZE_CONTENT"
    | "INITIALIZATION"
    | "AUTHORIZATION"
    | "LIST_MESSAGES"
    | "BATCH_CREATE_MESSAGES"
    | "GET_CONVERSATION_PROFILE"
    | "GET_CONVERSATION_MODEL"
    | "SEARCH_KNOWLEDGE"
    | "GENERATE_STATELESS_SUMMARY";
  data?: Dictionary;
  error: GoogleRpcStatus | null;
} | null;

SmartReplySelection

SuggestionFeatureSelection<SmartReplyAnswer>

SmartReplyFollowUpSuggestionsReceivedPayload

interface SmartReplyFollowUpSuggestionsReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/SuggestSmartRepliesResponse#smartreplyanswer
   */
  payload: SmartReplyAnswer_[];
}

PatchAnswerRecordRequestedPayload

type PatchAnswerRecordRequestedPayload = PatchPayload<{
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.answerRecords#AnswerRecord
   */
  answerRecord: AnswerRecord;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.answerRecords#AnswerRecord
   */
  previousAnswerRecord?: AnswerRecord | undefined;
}>;

PatchAnswerRecordReceivedPayload

interface PatchAnswerRecordReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.answerRecords#AnswerRecord
   */
  payload: AnswerRecord;
}

SnackbarNotificationPayload

interface SnackbarNotificationPayload {
  message: string;
  actionMessage?: string | undefined;
  actionHandler?: () => void;
}

AnswerRecordRequestedPayload

interface AnswerRecordRequestedPayload {
  answerRecordName: string;
}

AnswerRecordReceivedPayload

interface AnswerRecordReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.answerRecords#AnswerRecord
   */
  payload: AnswerRecord;
}

ConversationStartedPayload

interface ConversationStartedPayload {
  conversationName: string;
}

ConversationCompletedPayload

interface ConversationCompletedPayload {
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.conversations/complete
   */
  conversationName: string;
}

CompleteConversationRequestedPayload

interface CompleteConversationRequestedPayload {
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.conversations/complete
   */
  conversationName: string;
}

NewMessageReceivedPayload

type NewMessageReceivedPayload =
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/Message
   */
  Message;

GenesysCloudConnectorAccessTokenReceivedPayload

export declare interface GenesysCloudConnectorAccessTokenReceivedPayload {
  accessToken: string;
}

ListMessagesRequestedPayload

interface ListMessagesRequestedPayload {
  conversationName: string;
}

ListMessagesResponseReceivedPayload

interface ListMessagesResponseReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/ListMessagesResponse
   */
  payload: ListMessagesResponse;
}

VirtualAgentAssistResponseMessageSelectedPayload

interface VirtualAgentAssistResponseMessageSelectedPayload {
  responseMessage: string;
}

HumanAgentTransferInitiatedPayload

interface HumanAgentTransferInitiatedPayload {
  conversationName: string;
}

SearchKnowledgeRequestedPayload

interface SearchKnowledgeRequestedPayload {
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.suggestions/searchKnowledge
   */
  request: SearchKnowledgeRequest;
}

SearchKnowledgeResponseReceivedPayload

interface SearchKnowledgeResponseReceivedPayload {
  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.suggestions/searchKnowledge
   */
  request: SearchKnowledgeRequest;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/SearchKnowledgeResponse
   */
  response: SearchKnowledgeResponse;
}

BatchCreateMessagesRequestedPayload

interface BatchCreateMessagesRequestedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.conversations.messages/batchCreate#request-body
   */
  request: BatchCreateMessagesRequest;
}

BatchCreateMessagesResponseReceivedPayload

interface BatchCreateMessagesResponseReceivedPayload {
  conversationName: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/BatchCreateMessagesResponse
   */
  response: BatchCreateMessagesResponse;
}

StatelessConversationSummarizationRequestedPayload

interface StatelessConversationSummarizationRequestedPayload {
  conversationName?: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.suggestions/generateStatelessSummary#request-body
   */
  request?: GenerateStatelessSummaryRequest;
}

StatelessConversationSummarizationResponseReceivedPayload

interface StatelessConversationSummarizationResponseReceivedPayload {
  conversationName?: string;

  /**
   * @link
   * https://cloud.google.com/dialogflow/es/docs/reference/rest/v2beta1/GenerateStatelessSummaryResponse
   */
  response?: GenerateStatelessSummaryResponse;
}