DokumentationMarketo EngageAnvändarhandbok om Marketo

Återanropsfunktioner

Senast uppdaterad: 22 juli 2024
  • Ämnen:
  • Dynamisk chatt

Du kan använda Dynamic Chat widget-återanropsfunktioner för att skicka konversationshändelser till andra tredjepartsplattformar.

Komma igång

Den här händelsen anger att widgeten Dynamic Chat är klar att användas och utlöses när alla skript som är relaterade till Dynamic Chat läses in på webbsidan.

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

Konversationshändelser

Dessa händelser är relaterade till en konversation som är riktad till en viss sida för en viss besökare.

Konversationen utlöstes

En konversation (t.ex. en dialogruta) som riktar sig till en webbplatsbesökare är löst och chattbot visas för dem.

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

Konversationen har aktiverats

Besökaren var engagerad (t.ex. med sitt första svar) med chattbot.

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

Konversationen har slutförts

Besökaren har nått slutet av konversationen.

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

Konversationen har avslutats

Besökaren har avslutat konversationen innan han eller hon är klar.

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

Parametern event är ett objekt med metadata relaterade till konversationen. Du kan komma åt dessa metadata genom att gå till event.data.

Här är några viktiga metadatavärden som du kan komma åt:

Metadata
Attribut
Konversationsnamn
payload.name
Konversations-ID
payload.id
Konversationstyp (dialog-/konversationsflöde)
payload.type
Användargränssnittstyp (popup/chatbot/inline)
payload.uiType
Sessions-ID
payload.sid

Indatahändelser för besökare

Dessa händelser utlöses när en besökare som deltar i en konversation lämnar sin kontaktinformation (t.ex. telefonnummer eller e-postadress). Nedan visas de händelser som hör till den här kategorin.

Telefonnummer

Den här händelsen utlöses när en besökare anger sitt telefonnummer under konversationen.

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

E-post-ID

Den här händelsen utlöses när en besökare anger sin e-postadress under konversationen.

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

Parametern event är ett objekt med metadata relaterade till konversationen. Du kan komma åt dessa metadata genom att gå till event.data.

Här är några viktiga metadatavärden som du kan komma åt:

Metadata
Attribut
Konversationsnamn
payload.name
Konversations-ID
payload.id
Konversationstyp (dialog-/konversationsflöde)
payload.type
Användargränssnittstyp (popup/chatbot/inline)
payload.uiType
Sessions-ID
payload.sid

Mötesbokningshändelser

Dessa händelser utlöses när en besökare bokar ett möte med din företagsrepresentant.

Nedan visas de händelser som hör till den här kategorin.

Mötet har bokats

Den här händelsen utlöses när en besökare bokar ett möte i en agentkalender.

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

Parametern event är ett objekt med metadata relaterade till konversationen. Du kan komma åt dessa metadata genom att gå till event.data.

Här är några viktiga metadatavärden som du kan komma åt:

Metadata
Attribut
Konversationsnamn
payload.name
Konversations-ID
payload.id
Konversationstyp (dialog-/konversationsflöde)
payload.type
Användargränssnittstyp (popup/chatbot/inline)
payload.uiType
Sessions-ID
payload.sid
Agentnamn
payload.agentName
Agent-ID
payload.agentID
Mötesinformation
payload.meetingInfo

Live Chat Events

Dessa händelser utlöses när en besökare ansluter till en live-agent under deras interaktion med chattbot.

Nedan visas de händelser som hör till den här kategorin.

Live-chatt begärd

Den här händelsen utlöses när en besökare väljer alternativet att chatta med en live-agent och en tillgänglig agent håller på att lösas.

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

Live-chatten har initierats

Den här händelsen utlöses när en besökare väljer alternativet att chatta med en live-agent och en agent godkänner chatten.

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

Live-chatt avslutad

Den här händelsen utlöses när en konversation mellan en besökare och den aktiva agenten avslutas.

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 för live-chatt

Den här händelsen utlöses när en live-chattkonversation avbryts på grund av att besökaren slutar svara eller att de har släppts.

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

Parametern event är ett objekt med metadata relaterade till konversationen. Du kan komma åt dessa metadata genom att gå till event.data.

Här är några viktiga metadatavärden som du kan komma åt:

Metadata
Attribut
Konversationsnamn
payload.name
Konversations-ID
payload.id
Konversationstyp (dialog-/konversationsflöde)
payload.type
Användargränssnittstyp (popup/chatbot/inline)
payload.uiType
Sessions-ID
payload.sid
Agentnamn
payload.agentName
Agent-ID
payload.agentID

Om du vill skicka någon av dessa händelser till en analysplattform som Adobe Analytics eller Google Analytics måste du lägga till deras respektive spårningsanrop i dessa Dynamic Chat-händelser. Det skulle se ut ungefär som exemplet nedan.

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