Funzioni callback callback-functions

Puoi utilizzare le funzioni di callback dei widget di Dynamic Chat per inviare eventi di conversazione a qualsiasi piattaforma di terze parti.

Guida introduttiva getting-started

Questo evento indica che il widget del Dynamic Chat è pronto per l'uso e viene attivato quando tutti gli script relativi al Dynamic Chat vengono caricati nella pagina Web.

window.addEventListener('adobedx.conversations.ready', () => {
    // code here will execute when chatbot scripts are loaded in a webpage
});

Eventi di conversazione conversation-events

Questi eventi sono correlati a una conversazione con targeting su una pagina specifica per un visitatore specifico.

Conversazione attivata

Viene risolta una conversazione (ad esempio, un dialogo) destinata a un visitatore del sito web e viene mostrato il chatbot.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
 // code here will execute when the chatbot is loaded for a visitor
    });
});

Conversazione coinvolta conversation-engaged

Il visitatore ingaggiato (ad esempio, ha fornito la sua prima risposta) con il chatbot.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_ENGAGED, (event) => {
 // code here will execute when a visitor engages with the chatbot
     });
});

Conversazione completata conversation-completed

Il visitatore ha raggiunto la fine della conversazione.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_COMPLETED, (event) => {
 // code here will execute when a conversation is completed
     });
});

Conversazione chiusa

Il visitatore ha chiuso la conversazione prima di raggiungere la fine.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_CLOSED, (event) => {
 // code here will execute when a conversation is closed
    });
});

Il parametro event è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data.

Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid

Eventi di input visitatore

Questi eventi vengono attivati quando un visitatore che partecipa a una conversazione fornisce le sue informazioni di contatto (ad esempio, numero di telefono o indirizzo e-mail). Di seguito sono riportati gli eventi che rientrano in questa categoria.

Numero di telefono phone-number

Questo evento viene attivato quando un visitatore fornisce il proprio numero di telefono durante la conversazione.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_INPUT_PHONE, (event) => {
 // code here will execute when a visitor provides their phone number
    });
});

ID e-mail email-id

Questo evento viene attivato quando un visitatore fornisce il proprio indirizzo e-mail durante la conversazione.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_INPUT_EMAIL, (event) => {
 // code here will execute when a visitor provides their email address
    });
});

Il parametro event è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data.

Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid

Meeting Booking Events meeting-booking-events

Questi eventi vengono attivati quando un visitatore registra una riunione con il tuo rappresentante commerciale.

Di seguito sono riportati gli eventi che rientrano in questa categoria.

Riunione prenotata meeting-booked

Questo evento viene attivato quando un visitatore registra una riunione nel calendario di un agente.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_MEETING_BOOKED, (event) => {
 // code here will execute when a meeting is booked
    });
});

Il parametro event è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data.

Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid
Nome agente
payload.agentName
ID agente
payload.agentID
Informazioni riunione
payload.meetingInfo

Eventi chat in diretta live-chat-events

Questi eventi vengono attivati quando un visitatore si connette con un agente live durante il suo coinvolgimento con il chatbot.

Di seguito sono riportati gli eventi che rientrano in questa categoria.

Richiesta chat in diretta live-chat-requested

Questo evento viene attivato quando un visitatore seleziona l’opzione per chattare con un agente live e un agente disponibile viene risolto.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUESTED, (event) => {
 // code here will execute when a visitor requests a live chat
    });
});

Chat in tempo reale avviata live-chat-initiated

Questo evento viene attivato quando un visitatore seleziona l’opzione per chattare con un agente live e un agente accetta la chat.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_INITIATED, (event) => {
 // code here will execute after a live agent accepts the chat
    });
});

Chat in tempo reale terminata live-chat-ended

Questo evento viene attivato al termine di una conversazione tra un visitatore e l’agente live.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_ENDED, (event) => {
 // code here will execute when a live chat is ended
    });
});

Timeout chat in tempo reale live-chat-timeout

Questo evento viene attivato quando una conversazione live chat scade perché il visitatore non risponde più o perché il visitatore non risponde più.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUEST_TIMEOUT, (event) => {
 // code here will execute when a visitor abandons a live chat
    });
});

Il parametro event è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data.

Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid
Nome agente
payload.agentName
ID agente
payload.agentID

Se desideri inviare uno di questi eventi a una piattaforma di analisi come Adobe Analytics o Google Analytics, devi aggiungere la rispettiva chiamata di tracciamento all'interno di questi eventi di Dynamic Chat. Avrebbe un aspetto simile all’esempio di seguito.

window.addEventListener('adobedx.conversations.ready', () => {
    const {addListener, Enum} = window.AdobeDX;
    addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
 // Enter Adobe Analytics or Google Analytics function here
    ga('send', 'event', {
      eventCategory: Dynamic Chat Conversations',
      eventAction: 'Conversation Triggered',
      eventLabel: event.data.payload.id,
    });
    });
});
recommendation-more-help
94ec3174-1d6c-4f51-822d-5424bedeecac