Action

PreviousInput Validation NextPublishing & platform URLs FAQ

Last updated 3 years ago

Was this helpful?

Action

Clear Session

Often, at the end of a flow, an API backend call will be configured to, for example, save a train ticket in the ticket ordering system. Afterwards users should be able to book a new ticket to a different location.

You can achieve this with the 'clear session' action. This action removes the values of set session variables. This is useful when a user asks to correct a value, or to start over and delete all variables.

Send to offload provider

A user that reaches this action will be offloaded to a human customer support agent. For this to work, you need to enable offloading.

Depending on your selected offloading provider, additional configuration may be required.

API

Code

The code editor allows developers to quickly build custom logic on top of the bot by writing their own Javascript code blocks. Typically, the code editor is used to perform requests to external systems, or to do operations with variables.

There are also two tutorials in which we show you how the code editor can be used:

iframe

Have a look at this basic example:

<!DOCTYPE html><html lang="en">	<head>		<meta charset="UTF-8">		</head>		<body>			<button onClick="window.parent.postMessage(JSON.stringify({target:'CL_API',type:'SEND_MESSAGE', payload:{text: 'You clicked the button'} }),'*')">         SEND_MESSAGE        </button>		</body></html>

If this block of code is hosted and embedded within our iframe plugin, it will send the user a chat message when they click the button.

The postMessage API can also handle UPDATE_SESSION and GO_TO_DIALOGSTATE events.

JSON Builder

Website window events

You can use the JSON builder action in combination with the webwidget channel to receive window events on your webpage. These events will contain the data as configured in your JSON builder action.

Here's an example: Configure your JSON builder action to send a language key, with a variable retrieved from the session, and the "Send config to parent window" toggled on.

Your widget will trigger an event for that configuration to its parent window as a MessageEvent. The MessageEvent will contain a `data` field which contains the stringified result of the JSON builder configuration. Here's an example on how to listen to these events:

// Chatlayer JSON Builder Event Handlerwindow.addEventListener('message', (event) => {    const data = event && event.data && JSON.parse(event.data) || {}    const { type, payload } = data    if (type !== 'CL_DISPATCH_EVENT') return;    console.log('Chatlayer language received: ' + payload.language)})

PreviousInput Validation NextPublishing & platform URLs FAQ

Last updated 3 years ago

Was this helpful?