User management
Handling users is important for most types of applications, and certainly so for interactive, conversational applications. Narratory make it easy to authenticate users and create different flows for new and returning users as described on this page.
Authenticating users
In most applications, you want to authenticate users since you simply need to know who they are in order to provide a personalized experience. This typically is done differently on different platforms.
Narratory currently, out of the box, supports authenticating users for Google Assistant/Google Actions. The only thing you need to do is to add a BotTurn with answers including the built-in intents SigninSuccess
and SigninFailed
AND importantly to enable "Google Sign in" Account linking on the Google Assistant console. Then Narratory will do the rest for you.
Enabling Account linking in the Google Assistant console:

Signing in
Important note: Google offers a standard flow for asking users to share their information with voice apps. The only addition to this flow you have to do is to add a phrase that assistant will say before their automatic phrases begin. It basically means filling in the gap here: "____, you’ll need an account with my test app. To create a new one for you, I’ll just need some info. If you want more details, say "Tell me more." So, can I ask Google for your name, email address, and profile picture?". See the script below for an example with some context.
Support for authentication on other platforms will be added shortly.
The above snippet shows how to build a sign-in step for Google Assistant app. If you try this on different platforms, you will get a custom error message.
The user-experience offered by the above is visualized by the following script for a happy path:
If the user says no to Googles automatic questions, the following flow will happen instead:
Returning users
Returning users will automatically be signed in on any other device where they are logged in with the same Google account. Thus, the whole auth BotTurn as shown in the previous section will be ignored and the user-experience for returning users will instead be:
Typically you want to handle returning visitors in a different way than new users, see the next section for how to do this.
Handling guests/verified users and new/returning visitors
You typically want to add greet returning users in a different way than new users, and in addition you might not be capable of giving full service to guest users (in the Google Assistant ecosystem a guest user is a user not logged in with their Google account). System-set variables exist for these cases that you can use in conditionals and API-calls.
Note: These variables are currently only supported for Google Assistant
An example showing how to use these variables is shown below: