This article deals with the following topics:
Luma provides Administrators a configurable approach to registering users in Luma and associate them with the required chat channels. Administrators can register users through email (available out-of-the box see Register Users through Email), SMS or another approach of their choice. When a new user sends a message to Luma from any chat channel, Luma needs to associate that user's chat account with their Luma account. The user will be prompted for association with or without validation. After successful association, the user's chat account is mapped to their Luma account. The default role associated to users after registration is Self Service User.
The Luma platform provides several key API components that can be used for a custom registration process including the following:
For more information on all of these components see APIs for User Registration.
The following is an example of a user registration process that prompts the user for their mobile number, if their mobile number is associated with an existing active Luma account, a one time password (OTP) will be sent to their phone number. Once the number is entered the user's chat channel account is successful associated with their Luma account and they can interact with Luma.
See the diagram below to view the full workflow of this process.
This sample user registration process uses the following skills:
The following sample walks you through the steps to configure the skills for user registration by prompting the user for their mobile number. However, your custom registration process may contain more or less skills depending on your configuration. To create a custom registration process which involves prompting the user to enter their mobile number, do the following:
Create a web service to check whether the user exists in Luma and use it in an attribute. Use that attribute in the skill as shown in the following images.
Reconciliation key can be username, first name, last name, mobile number or email address. |
After validating the user and checking whether the user is associated to a channel, the next step is to check if the user exists and is not authenticated in the channel. If yes, then proceed by sending the OTP to the mobile number. OTP is generated by using a Function (@fn.randomNumber) and storing the attribute in the context of the skill as shown below.
If the entered OTP is incorrect, there are two options – have user go through the user registration process again or have a provision to resend the OTP as shown below.
Send a message to the user that the entered OTP is invalid, before prompting to enter the OTP again. |
Send a message to the user that the entered OTP is invalid, before prompting to enter the OTP again. |
If the entered OTP is correct, user is associated to the channel by triggering the system skill ‘Luma Channel Association’ as shown below.
The user is now registered and associated to the respective chat channel. The welcome skills are displayed to the user, which are configured as part of the post fulfillment. The post fulfillment action can be created only for ‘Luma Channel Association' skill.
This section discusses the user registration process in Luma through a user's chat process.
When a new user interacts with Luma through any channel for the first time, it prompts users to register themselves. When the user triggers the user registration skill, Luma prompts user to enter their mobile number. If the entered mobile number is not associated to any contact, then the following error appears.
When a new user tries to register in Luma through a supported chat channel, an OTP is sent to their registered mobile number for verification. If the user enters wrong OTP, then another OTP is sent until user enters the correct OTP. Alternatively, user gets three options to choose from - Continue as Guest, Enter OTP and Resend OTP as shown below.
When the user entered mobile number is valid and associated to a Luma contact, then an OTP is sent to the registered mobile number. When the user enters the correct OTP, the welcome skills are shown to the registered user as shown below.
Once the user registration is complete, you can send messages to your Bot user and receive responses from your Luma Virtual Agent. In case of any issues with the configuration, please contact the Serviceaide Support team.
When a user is already authenticated in a channel, then the following message appears on entering the associated mobile number.