Studio FAQs
note
Welcome message is supported only for web and app SDK and it is not supported for any of the Channels.
Nodes
Why is the send OTP node not working?
Our out-of-the-box OTP verification is restricted only to the India region. If you’d like to avail of this functionality for international numbers, you will have to use external APIs.
Is it possible to skip triggering NLU for specific steps of a flow?
Yes, you can skip triggering NLU for specific flows using the Store comment node.
I have configured Hindi language but it is triggering fallback/different journey? What might be the reason?
In a flow, if you have selected "hi" (ISO code) for Hindi (button value), then it might be triggering another intent which you would have configured earlier ("hi" intent configured). To overcome this problem, set a variable, assign the variable value to Hindi language (hi), and then connect it to the Set language node.
I have an API response through which I’m getting a product image as a .png (few kb in size) Can I pass that into a Carousel/Image node to dynamically change the image?
Yes, use the following code snippet in the API parse function.
return new Promise(resolve => {
const imageVariable =
[{
"options": {
"caption": { "type": 'random' },
},
"url": "insertURL"
}]
resolve(imageVariable);
});
You can also do this in the carousal by creating your own custom/dynamic object (depending on the use case for which you select the node)
The options in a dynamic Whatsapp list always leads to the fallback flow. How can we tweak this?
You can use the Condition node to redirect each option to the respective flow.
- Insert the condition node in your flow.
- Populate the node with button values.
- Connect each button to the flow that has to be executed if that button is clicked.
Can we increase the pagination size limit in Database Node?
You can increase the size limit upto 25, to increase beyond that, while setting the Pagination, instead of Text, use Variables with a static value. Variables let you increase the size limit upto 200.
I am able to create the same variable in Journey and Global but when I create the first global variable, I am unable to create the journey variable with same name
Variables should not have the same name. If they do, it will fetch the value for which it is assigned based on the assigned priorities from global to local.
How to retrieve multiple data from the database node?
Create function and extract the data from the variable that stored the DB response.
Write
let records = data.variables.db_response.records
console.log(records, "records")
Log the result and check the data. After this you can use the data based on your use case.
Why am I getting a fallback message even when WhatsApps list message is configured?
To avoid a fallback message, you must store the value of the WhatsApp list option in a variable and use an IF condition to compare the variable value to trigger the respective outcome (flow, text, and so on).
Documents
What does a good document format look like?
The following are some of the characteristics of a document that’ll be processed well during document cognition. It's recommended to follow these guidelines while pre-processing your document - * It does not have scanned pages and images, these will be skipped if present in the doc. * At least 80% of the content is textual and well-formatted (e.g. Wikipedia articles) * Remove content and index pages, appendix pages, etc. (we will add the logic to skip these automatically in coming releases) * No bullet points before headings. Headings should have a larger font size and no spaces so that the parser can detect headings easily. * Simple tabular data works better than complex or merged tabular data in the documents.
Why am I not getting the right result in the first suggestion?
Because document cognition is a probabilistic model that is “predicting” the relevance of a specific paragraph or page by looking at the input string. There is no guarantee that the first result will be the most relevant. The most relevant results are expected to come in the top 3 results.
Why am I getting the other documents in suggestions which don't have the answer?
Same answer as above. The model assigns individual scores to all the documents’ paragraph and use them to show the results, so if the confidence threshold is low it can still show irrelevant answers. You can fine-tune the confidence threshold using some test cases.
Why am I getting multiple occurrences of the same document in the results?
Because there might be multiple pages/occurrences of relevant content in the same document. In such cases, we rank them, based on the score and return only two occurrences in each document by default. If you want to see more or fewer occurrences within the same document, you can control it by passing the value of `results per document` in your search query.
Can the model read tabular data or image presents in the documents?
Tables can be indexed by enabling the Parse table option while uploading, Simpler table works better than complex/merged tables. Images/diagrams will be skipped.
Why am I not able to access a document link, from a conversation I had yesterday? Can I change this dynamic URL to some fixed redirection URL?
Currently, we have restricted the life of each SAS link to an hour for security reasons. This can be removed/updated as per the client's request. You can generate a new link by asking the same query again in the bot. You can also change this redirection URL to a fixed URL using the document properties option. 
How do I ensure that the bot shows only relevant documents?
There is no specific logic added to detect irrelevance right now. However, we do provide a relevance score with each search result that the bot developer can use. The model returns all documents which contain even a few keywords in the query in decreasing order of relevance. The bot developer can choose to show only Top N (e.g. Top 5) or Top 25% of the results based on relevance score.
Can the Doc cog work if the documents are stored in a different system?
Doc cog has in-build integrations for Sharepoint, S3, URLs, and KBs (Salesforce, Service-now, Confluence). Any other KB can also be integrated which has APIs to access the articles/documents.
Docs QNAs are not being generated, do I need it for working of doc cog? or can I edit the response of doc cog results?
Doc cog search will work fine without the QNAs. If the upload docs are showing completed status, you can just enable doc cog fallback or add Action Node and start using it. QNA's are only required for editing the answers and adding them to the FAQs section.
Is permission-based Doc cog results possible so that only certain groups of people can search in a certain list of Docs / External KBs?
Yes, It is possible, User can add tags to the documents and pass the tag value as a variable in the doc cog action node while searching.
If a single document has different answers/responses wrt a user profile like CEO, HR, SDE etc, Can we filter and show just the answers related to the User Profile?
If the results are on a different page, page logic can be used to filter the results if answers are in a tabular structure, you can try adding the role of the user in the query itself, like
<query>: SDE”, eg. Annual leave entitlement?, SDE"
Why my documents are taking so long for indexing, is it stuck?
Doc cog uses queue base indexing flow which has a common queue among all the bots. A pending/queued status represents doc is still in the queue and waiting for indexing while the indexing status represents the doc is being indexed.
Is there any limit on documents uploading?
Yes, for a Tier 0 (Free Tier) bot there is a limit of a max of 50 total pages or a max of 5 documents and Tier 1 bot has a max 200 documents limit. Tiers other than T0 can have max of 500 pages per document.
Can I index my articles present on ServiceNow / Confluence / Salesforce etc.?
Yes, using Doc cog External KB integration it is possible to index the articles using the APIs.
Why my bot is showing Journey Suggestions (Did you mean) instead of Doc cog results in fallback?
A bot has a specific priority order of actions in the fallback case. Order: Journey -> FAQs -> Journey suggestion -> Doc cog -> Other fallback. So if the Journey suggestions are enabled and with good suggestion confidence, Journey suggestion will be triggered due to the priority order. You can try disabling the suggestion or increasing the confidence threshold of the suggestion.
Can I change the layout of the doc cog results cards?
Yes, but the default layout is recommended which helps us in analytics, improves accuracy and provides a better user experience. A layout that can be changed: Change vertical to horizontal cards, change the display name, remove tags, and remove the preview button.
API
How to get the exact status code as our API Event Data explorer while getting API responses in a journey?
Create a function after the API call and apply the below code snippet.
ymLib.args.apiResponse.statusCode
Journey(flow)
How do I link one flow to another flow for a bot?
Use Execute Flow to link another flow to a bot.