Frequently Asked Questions¶
Alan Studio¶
How can I test my scripts in Alan Studio?¶
How can I test my scripts in Alan Studio?
You can test your scripts with the Debugging Chat in the right pane of Alan Studio. Prior to testing, be sure to save your changes using the Save Changes button.
Can I edit and delete predefined scripts added to my Alan Studio project?¶
Can I edit and delete predefined scripts added to my Alan Studio project?
Yes, after you add predefined scripts to your project, you can edit or delete them as you’d like.
How many projects can I have in my Alan Studio account?¶
How many projects can I have in my Alan Studio account?
You can create as many projects as you need in your Alan Studio account.
Is there a limit on the number of users who can access the in-app assistant?¶
Is there a limit on the number of users who can access the in-app assistant?
There is no limitation on the number of users interacting with the in-app assistant.
However, you can intentionally make the in-app assistant available to a limited group of users with the cohorts functionality, for example, in a staged rollout scenario.
What is the QR code used for in Alan Studio?¶
What is the QR code used for in Alan Studio?
With the QR code, you can test an app integrated with Alan on your mobile device. Download and install Alan Playground on your iOS or Android device, scan the QR code with the device camera and tap the Alan button in the app to start testing it.
Integration and implementation¶
What platforms does Alan integrate with?¶
What platforms does Alan integrate with?
Alan integrates with any iOS, Android or web app. It also integrates with cross-platform apps like Flutter, Ionic and React Native.
How can I test my new Alan project on mobile?¶
How can I test my new Alan project on mobile?
There are two ways to test your Alan Studio project on the mobile platform:
With Alan Playground: In Alan Studio, go to the Playground section — here you will see the QR code. In Alan Playground, click Scan QR Code, scan the QR code of the project with the device camera and test your in-app assistant on the device.
Using your app UI: if your app already has the Alan button, you can use it to test a new Alan Studio project. Launch the app on mobile, tap the Alan button and hold it for 8 seconds. In Alan Studio, go to the Playground section and scan the QR code with the device camera. You can now test your Alan project.
Can I customize the Alan button?¶
Can I customize the Alan button?
You can change the look and feel for the Alan button in Alan Studio:
The button colors are fully customizable to match any graphic or app theme.
The Alan logo can be replaced with a custom icon or logo.
Can I change Alan’s voice to female voice?¶
Can I change Alan’s voice to female voice?
You can change Alan’s voice in Alan Studio. Alan lets you select the voice type: male or female, and the regional accent for all languages you want to use in your in-app assistant.
Can I define my own entities in Alan?¶
Can I define my own entities in Alan?
In Alan, users can define their own entities from either discrete sets of data (for example, days of the week), regular expressions or through custom slots with fuzzy matching where entities can be constructed around ‘hard-to-pronounce’ words or phrases.
What extra permissions do Alan apps need?¶
What extra permissions do Alan apps need?
Apps that use Alan only need the user to grant microphone access to work.
I do not see the Alan button on my webpage¶
I do not see the Alan button on my webpage
Check if you run the Alan button in a browser that supports an Audio API.
If you use ‘http’, run the page on the localhost (otherwise use ‘https’).
Make sure the Alan button isn’t disabled in Alan Studio: check the button settings in the Integrations section for your project.
How do I activate the in-app assistant?¶
How do I activate the in-app assistant?
To start interacting with Alan, you can do one of the following:
Tap the assistant button in the app
On iOS and Android platforms, use the wake word to activate the assistant. Make sure the wake word option is enabled for your assistant project.
Use the activate() method of the Alan Client API to activate the Alan button programmatically.
How do I stop voice interaction?¶
How do I stop voice interaction?
To stop interacting with Alan, you can do one of the following:
Tap the assistant button in the app
Say one of the following phrases to deactivate the Alan button with voice:
Thanks Alan
Thank you Alan
Alan thank you
Alan thanks
Stop Alan
Alan stop
Use the deactivate() method of the Alan Client API to deactivate the Alan button programmatically.
Can I customize the ‘Hey Alan’ wake word?¶
Can I customize the ‘Hey Alan’ wake word?
Yes, you can use a custom wake word for your in-app assistant. Please contact the Alan AI team for details.
How can I disable my Alan button?¶
How can I disable my Alan button?
You can disable the Alan button through the button options in the Integrations view of Alan Studio.
Does the microphone usage with Alan drain the battery faster?¶
Does the microphone usage with Alan drain the battery faster?
Battery consumption with Alan from the microphone is minimal. The Alan SDKs have default settings that turn the microphone off automatically after a brief period of inactivity; however, the microphone timeout can be increased or decreased based on developer preferences in Alan Studio.
What if I migrate my data from one service to another?¶
What if I migrate my data from one service to another?
Your data can be hosted anywhere, you will still be able to work with Alan.
Is everything written in JavaScript?¶
Is everything written in JavaScript?
Commands and responses in Alan Studio must be written in JavaScript.
How to pass POST parameters from Alan Studio?¶
How to pass POST parameters from Alan Studio?
In Alan Studio, you can use built-in JavaScript libraries.
Does Alan Studio have different instances for Development, QA and Production?¶
Does Alan Studio have different instances for Development, QA and Production?
Alan Studio has three separate instances for you to use in any project: Development, Testing and Production.
Is there an activation phrase?¶
Is there an activation phrase?
Yes, the default activation phrases are Hey, Alan
and OK, Alan
. Make sure the wake word option is enabled for your assistant project.
How is it better than Dialogflow?¶
How is it better than Dialogflow?
The Alan Platform offers very easy integration with web/mobile apps and a more flexible way to create voice enabled apps by using the JavaScript language. This allows users to build complex enterprise-level apps.
How much does it cost to get started?¶
How much does it cost to get started?
See Plans & Pricing for details.
Can I use any database or backend?¶
Can I use any database or backend?
Yes, any database or backend can be used.
I saw the infrastructure scheme of the Alan Platform. What parts do I have to deploy?¶
I saw the infrastructure scheme of the Alan Platform. What parts do I have to deploy?
You only need an app or device to run Alan.
What does ‘p’ mean in Alan Studio example scripts?¶
What does ‘p’ mean in Alan Studio example scripts?
This is a name of the variable that references an object you can use to call Alan Studio SDK methods. It also contains data for a user voice session and other contextual information. You can use any name for this variable.
This object has:
Slot values for intents, for example:
Voice script¶intent("$(A cat|dog|pig)", p => p.play("You say " + p.A.value)).
play
: a method to playback voice responses.state
: an object for storing context data.userData
: an object for storing user data during the current dialog session.auth
: an object that accepts configuration from the client (mobile or web). Typically, it can be used for passing authorization data for external services.You can return a
value
from the current context by callingp.resolve(value)
.
How do I catch unrecognized voice commands?¶
How do I catch unrecognized voice commands?
To see the list of user’s utterances that your in-app assistant failed to understand and match to the voice commands in your script, do either of the following:
Open Alan Studio logs and click the Unrecognized filter option.
Go to the Analytics view and check the Interactions widget. Make sure the Unrecognized filter is on.
If you want to catch the utterance as the user pronounces it, you can use the Record intent audio option. In Alan Studio, go to the Integrations section and in the button settings section, enable this option. With this option enabled, you will see the play icon to next to an unrecognized command in Alan Studio logs. Click this icon to listen to the intent audio.
Can I integrate Alan with WordPress?¶
Can I integrate Alan with WordPress?
Alan can be integrated with any project built with the supported languages and frameworks. The backend of your app does not matter since integration is accomplished mostly on the frontend side.
I get an error when downloading Alan Client SDK files¶
I get an error when downloading Alan Client SDK files
Check the Internet connection to your device and your computer.
Can I start my app with Alan using Siri or Google Assistant?¶
Can I start my app with Alan using Siri or Google Assistant?
To start your voice-enabled app through Siri or Google Assistant, use the native Apple or Google functionality. Summon Siri or Google Assistant on your device and say: Launch <your app name>
(for Siri) or Open <your app name>
(for Google Assistant). For details, see Siri documentation and Google Assistant documentation.
iOS¶
How to pass parameters from iOS to Alan Studio?¶
How to pass parameters from iOS to Alan Studio?
You can do this in a few ways:
When you are creating a connection, you can pass a JSON object.
You can call a JS function with parameters.
We have functionality to set the visual context using the SDK.
I get permissions errors on iOS. What should I do?¶
I get permissions errors on iOS. What should I do?
In iOS, the user must explicitly grant permission for an app to access the device microphone and camera. The Info.plist
file of the app must contain NSMicrophoneUsageDescription
and NSCameraUsageDescription
keys with string values explaining how the app uses this data.
To add these keys, go to Info > Custom iOS Target Properties, add the Privacy - Microphone Usage Description and Privacy - Camera Usage Description permissions to the list and provide the descriptions for them. For details, see iOS Developer documentation.
Why does the Alan button request microphone permissions after every page refresh in iOS browsers?¶
Why does the Alan button request microphone permissions after every page refresh in iOS browsers?
By default, the browser is configured to ask you about granting camera and microphone permissions. To allow the microphone usage for Alan permanently, to the left of the address bar in the browser, tap aA > Website Settings. In the Settings window, under Microphone, change the permission to Allow.
Note
This setting is available in iOS 13 and later.
How do I allow the microphone usage for a website viewed locally?¶
How do I allow the microphone usage for a website viewed locally?
If you add the Alan button to a webpage or website viewed locally, for example, for debugging purposes, the browser will require you to allow microphone access every time you activate the button. To allow microphone access permanently, in Safari, go to Safari > Preferences > Websites, select Microphone and change the microphone permission to Allow.
The Alan button is overlapped by another UI element on the screen¶
The Alan button is overlapped by another UI element on the screen
The Alan button must be added to the topmost view in the view hierarchy so that it appears on top of all UI elements. You can create a container view and add the Alan button to it.
My app with the Alan button fails on the iOS simulator with Apple Silicon Mac¶
My app with the Alan button fails on the iOS simulator with Apple Silicon Mac
Note
The steps below are applicable for the AlanSDK.framework
bundle. You do not need to perform additional actions if you use the AlanSDK.xcframework
bundle.
When running an app with the Alan button on the iOS simulator with Apple Silicon Mac, you may encounter the following error: Building for iOS Simulator, but linking in object file built for iOS...
.
To work around this issue, do the following:
In the XCode project, go to Build Settings.
Set the Excluded Architectures option to
arm64
(EXCLUDED_ARCHS = arm64
).Set the Validate Workspace option to
YES
(VALIDATE_WORKSPACE = YES
).Set the Enable Bitcode option to
NO
(ENABLE_BITCODE = NO
).
Security and privacy¶
Does Alan record my conversations?¶
Does Alan record my conversations?
Alan does not record or store your conversations audio data. Alan does store the Speech to Text commands and responses from your app’s usage, which is entirely private to you and inaccessible to Alan employees and any third-party engines.
Does Alan encrypt data?¶
Does Alan encrypt data?
The client app and Alan Cloud exchange data on an encrypted HTTPS/TLS channel. The Alan Platform supports the latest recommended secure cipher suites to encrypt all traffic in transit, including the TLS 1.2 protocol, and SHA2 signatures.
The Alan Client SDKs store no data on the local device. The Alan Cloud stores analytics and performance data in files and databases. This data is encrypted using AES-256 encryption and can be further enhanced with enterprise private keys.
Alan technologies¶
What is SLU?¶
What is SLU?
Spoken Language Understanding (SLU) is a voice processing technology designed to work with the error-prone output of Automatic Speech Recognition (ASR) instead of written text, like chatbots.
What is the Domain Language Model?¶
What is the Domain Language Model?
The Domain Language Model is a unique procedure Alan uses for training our Speech Recognition software to better recognize the specialized language of your app, dynamically adapting to your users’ conversational style.
What is an intent?¶
What is an intent?
An intent is a voice command the user says to receive a voice response or perform some action in an app.
What is an entity?¶
What is an entity?
An entity is a specific part of speech or text holding data such as name or height. Each entity is part of an intent and conveys a set of information to the developer, for example, date, location and so on.
What is a context?¶
What is a context?
A context is the situation in which a conversation occurs. Contexts are a cornerstone in Alan’s conversational design as they dictate the flow of the conversation, much like in the real world, where different contexts may provide different meanings to the same sentence. In Alan Studio, developers can create unique context functions to specify the steps of the dialog and create interactive multi-stage conversations.
Billing¶
What is an interaction?¶
What is an interaction?
An interaction is a user’s utterance associated with Alan’s reply.
What is a user?¶
What is a user?
A unique user is a device from which the user connects to the assistant in your app. That is, if the user initiates several dialog sessions from the same device, he or she will still be considered a unique user.