On conversation end

You can leverage a Function as a Service (FaaS) function to implement any functionality when a conversation is finished. This advanced approach allows for tailored event customization to enhance your bot's capabilities.

Through Automatic Messages, you can create functions triggered based on selected events. A payload is sent to a function containing metadata related to the specific conversation and based on the selected event during the invocation. 

Enable the automatic messages feature and Create a new function using the 'Messaging conversation end' messaging events. You can select one of the available templates for the chosen event. Currently, you can create only one function per template type for these conversational events. A deployed function on a specific messaging event can be invoked on multiple conversation events.

Create the FaaS Function

Navigate to the "Functions" section in LivePerson Conversational Builder. 

Click Automate > Functions. The Functions page appears.

Click Confirm to agree to the Terms of Use and GDPR Agreement.

Click the icon to open the LivePerson Functions page.

Click Create a Function. The Create a new function wizard appears.

Provide the following information:

1. Runtime: Select your runtime.
2. Event: Select the event that the FaaS function will track, in this case new conversation events. Select an event to see its available templates. 
3. Skill trigger: Select skills which trigger to which this function reacts. It is not necessary to select any skill, since this option was managed on the Automatic Messages section.
4. Greeting Template: Select a template to start your implementation. Select the code template that the FaaS function will have, which can vary depending on the event you selected.
5. Access to external domains required: Enable this option if you plan to call external APIs, including the API's domain. Disable it if no external API calls are required.
6. Code: Displays the code for the template selected.

Click Continue. The next page appears.

By default, access to external domains is blocked. Adding domains to the allowlist allows functions to send requests to them. If required, add domains to the field and click Continue. The next page appears.

Provide the function name and description in the fields. 

Click Create function the function is added. Once the function is open you can edit the code to implement any logic needed.

With Automatic Messages selected as the trigger, you can utilize the input.payload variable, containing conversation data, within your function code. 

This data contains:

The cbotEventType property in the invocation payload distinguishes conversation event types. Below is the mapping of conversation event types to messaging events on functions:

Deploy the Function:

Click the 3 dot menu on the created function.

Click Deploy function. The Create a deployment page appears.

Click Approve & Deploy. The function is deployed.

Your function is now deployed and ready for use. By utilizing FaaS functions, you can seamlessly customize events and enhance the functionality of your bot in Conversational Builder.