[{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/built-in-entities/","section":"","summary":"","title":""},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/what-is-an-intent/","section":"","summary":"","title":""},{"content":"Action Google Custom Search # Content\nLearn how to use the Google Custom Search action inside your bot to answer each of your users’ queries and enrich your fallbacks.\nThis action’s mission is to make a research on a previously set domain or web site, from your users’ query, and displays its answers with Cards.\nTo learn how to create your Google Custom Search engine, please refer to this link: https://support.google.com/customsearch\n🚨🚨 Be careful, Google Cusom Search is a paying service. Check out the pricing page before using it. 🚨🚨\n1. Google Custom Search action #The Google Custom Search action is accessible from the action panel of every step. In order to use it, you must click on “Integrations” and then drag and drop “Google Custom Search” inside the step panel.\nAs you drag and drop the action, the “Configure Google Custom Search” window opens.\n2. Google Custom Search configuration #The configuration panel includes several fields:\nGoogle API Key: JSON Custom Search API requires the use of an API key. To get the key, start by creating your Custom Search Engine. Then, you will find the Google API Key at this page:\nhttps://developers.google.com/custom-search/json-api/v1/overview\nFind this section and clic on « GET A KEY » Select the Custom Search Engine you’ve just created Then an Enable Custom API key is generated Copy the key and past it in your Google Custom Search API configuration Search Engine ID (AKA CCX or CSE ID): you may go on this page to configure your own search engine.\nhttps://support.google.com/customsearch/answer/2649143?hl=en\nHere, enter the domain or website your search engine has to be connected with, define the language and give your engine a name to find it easily.\nOnce you’re here, the “Configuration” panel opens. At the “details” section, clic on the “search engine id” to copy your engine’s ID:\nThen paste this ID inside the Google Custom Search panel:\nSearch Request: place here the syntax {{@message}}. This sends your user’s last message as a request to search by your custom search engine. But you can also insert any other entities, keywords or session value.\nScroll down the window and define how many cards you want your Google Custom Search to show:\n3. Google Custom Search uses #Once you completed all the fields, click on “Confirm“. The action appears in the step panel.\nAs a result, as soon as your user enters a request and triggers your Google Custom Search story, his message will be sent as a search request by your search engine on the domain or web site you’ve defined, and will appear as Cards as a result for his query, inside the scenario created to bring answer to your user:\n4. Build your conversation # Create a Google Custom Search story Create your scenario. The first question is to ask the user what he wants to search:\nThen, go to the “links to” tab, click on “add a connection”, set the “User response” as “Is set” and create a link to your Google Custom Search step:\nThen, on the next step named “Do a Google Search”, your Google Custom Search action will use the message of your user (the {{@message}}) as a request sent to your Custom Search Engine you’ve previously created!\nInclude the Google Custom Search in your fallback When your bot doesn’t understand the question, it sends the fallback answer. To go further than a basic fallback answer, you can customize your fallback for your bot to bring an answer even if it doesn’t understand!\nYou can include it in your step’s fallback to locally make a search in a specific step of your bot:\nYou can also include it as an answer directly into your general fallback, for every non-matched request of your users to trigger a reaserch on your previously set domain or web site:\nHere you’re done with the basics steps to use this cool feature.\nAre you ready to use it?\nIf you need more help, don’t hesitate to contact us!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/google-custom-search-action/","section":"","summary":"\u003ch1 id=\"action-google-custom-search\" class=\"relative group\"\u003eAction Google Custom Search \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#action-google-custom-search\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eLearn how to use the Google Custom Search action inside your bot to answer each of your users’ queries and enrich your fallbacks.\u003c/p\u003e\n\u003cp\u003eThis action’s mission is to make a research on a previously set domain or web site, from your users’ query, and displays its answers with Cards.\u003c/p\u003e\n\u003cp\u003eTo learn how to create your Google Custom Search engine, please refer to this link: \u003ca href=\"https://support.google.com/customsearch/answer/4513751?hl=en\u0026amp;ref_topic=4513742\u0026amp;visit_id=1-636682151511214155-445195145\u0026amp;rd=1\" target=\"_blank\" rel=\"noreferrer\"\u003ehttps://support.google.com/customsearch\u003c/a\u003e\u003c/p\u003e","title":"“Google Custom Search” action"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/0/","section":"0","summary":"","title":"0"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/actions/","section":"Categories","summary":"","title":"Actions"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/advanced-features/","section":"Categories","summary":"","title":"Advanced features"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/","section":"Categories","summary":"","title":"Categories"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/","section":"CKODA","summary":"","title":"CKODA"},{"content":"Connecter Facebook Messenger # Content\nHere is a step-by-step tutorial on how to connect a chatbot to your Facebook page.\nCreate a new bot #Create a chatbot on the CKODA app by clicking on the “Create a new bot” button.\nGive him a name #Then click the “Continue” button!\nSelect Messenger channel #After you create your project, select the Messenger channel.\nThis is recommended because it will allow you to have access to specific Messenger features, like Quick Replies or Cards.\nIf you didn’t select a channel at the beginning, you can choose one in the “Channels” tab of your platform. You can also add new channels and make it a multichannel chatbot.\nIf you click on the Facebook tab, you will see a form opening on the right.\nNext, log in to Facebook.\nCreate your developer account #(Pass this step if you already have one.)\nGo to https://developers.facebook.com/apps, and click on “Login” on the top right.\nFill out this form, then follow these steps:\nIf you have an account, create a new app.\nGive a name to your app, then click “Create App ID“.\nComplete and validate the process.\nSelect the Messenger product by clicking on “Set Up“.\nNow your app is created on Messenger!\nCreate the Page Access Token #To make the app accessible users, connect it to a Facebook page.\nIf your page is available, select it:\nIf you have to create a new page, click under the placeholder\nGenerate the Page Access Token:\nYour token has been generated, copy it:\nPaste it in the Page Acces Token field on the CKODA plateform:\nApplication secret #On the top of your ‘Facebook for Developers’ app page, enter settings.\nGo to Settings \u0026gt; Basic,\nIn front of the App ID, find the App Secret, click on “Show”:\nYou’ll be asked to file in your password and then the code appears:\nCopy the code:\nAnd paste it in the CKODA Channels configuration form in the “Application secret” field:\nSet up the Webhook verify token #Go back on the ‘Facebook for Developers’ page. On the webhook section, click “Setup Webhook”:\nThen select:\nmessages messaging_postbacks message_echoes In the CKODA app, go to the channel setting section and copy the link of your webhook:\nAnd paste it on the first field:\nThen generate a password Verify Token. Choose a password or generate it:\nCopy and paste it,\nIn the CKODA app “Webhook verify token” field: Next, click on “Activate integration”.\nOn the ‘Facebook for Developers’ go to the “Verify Token” field: Click on “Verify and save”.\nConnect your app to your Facebook page #Now that your webhook has been validated, click on “Select a Page” and select your page :\nAnd then “Suscribe” your webhook !\nBefore suscribing\nAfter suscribing\nGo back to your Facebook page settings # On the left, select the Messenger plateform tab:\nCopy the ID of your ‘Facebook for Developers’ app:\nYou can find it at the top of your ‘Facebook for Developers’ page in your app’s interface.\nPaste it in the field “Link Your App to Your Page”:\nAnd click “Link”:\nCongratulations, your app is linked to your page !\nConfigure your interface #On your facebook page, click on “Add a button“:\nSelect “Send Message“:\nThen click “Next”, and select “Messenger”:\nAnd click “Finish”:\nMove your cursor over the button and select “Test Button”:\nThen start chatting with your bot:\nThat’s it! Now you have a bot on your Facebook page.\nNote: For the moment, your chatbot will only be accessible to the people with a role in your Facebook app.\nIf you want to allow access to everyone, you will have to submit your app for review.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/connect-a-bot-to-facebook-messenger/","section":"","summary":"\u003ch1 id=\"connecter-facebook-messenger\" class=\"relative group\"\u003eConnecter Facebook Messenger \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#connecter-facebook-messenger\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eHere is a step-by-step tutorial on how to connect a chatbot to your Facebook page.\u003c/p\u003e\n\u003ch4 id=\"create-a-new-bot\" class=\"relative group\"\u003eCreate a new bot \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#create-a-new-bot\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\u003cp\u003eCreate a chatbot on the \u003ca href=\"https://app.clustaar.com/\" target=\"_blank\" rel=\"noreferrer\"\u003eCKODA app\u003c/a\u003e by clicking on the “\u003cem\u003eCreate a new bot\u003c/em\u003e” button.\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/76230367/e011080c67fae0dd59a95d44/Capture1.PNG\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e\n\u003ch4 id=\"give-him-a-name\" class=\"relative group\"\u003eGive him a name \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#give-him-a-name\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\u003cp\u003eThen click the “\u003cem\u003eContinue\u003c/em\u003e” button!\u003c/p\u003e","title":"Connect a Bot to Facebook Messenger"},{"content":"Connecter Google Assistant # Content\nHere’s a quick tutorial to explain how to connect your CKODA bot to Google assistant and use voice with your bots.\nDisclaimer: This tutorial requires some basic technical level.\nCreate a Google Assistant project #Before you start creating a bot in our platform, you need to create a Google Assistant project:\nGo inside Configure a Developer Project and Account Settings to learn how to create a Google project. To create a project, follow the steps “Configure an Actions Console project“. In the same link, refer to the section “Set activity controls for your account“. In your activity control, check if those features are activated. Once the project is created, we will configure some more steps and be set up in the CKODA app.\nGo into the project that you have just created, if it’s not already done. Click on “Overview”. Click on “App information”, then click on the Edit button. You should arrive on a new page where you will find the language of your bot.\nFill the “Assistant app name” and “Pronounciation” with the same content. Click on the “Next” button. Scroll down until you find “Sample invocations” — this sentence will trigger your application. Optional: Change the sentence or add a new invocation. Scroll to the bottom of the page and click the Save button. Disclaimer: You may receive an error message because you did not fill out all the fields. You can skip this part. But if you receive this message “Could not reserve your app name”, please change it. Find Project ID #Click on the button on the right of “Overview”, then Project settings\nThen copy or write the “Project ID” somewhere. You will need it later.\nDownload gaction #In order to activate your new project, you will need to download gactions software according to your OS version.\nDownload Google gaction\nDownload Notepad ++ or a code editor #Download Notepad++ or use any other code editor for the next steps.\nCreate a JSON file # Open Notepad++ application Create a new file by doing CTRL+N Then copy-paste the following text in the new file { \u0026#34;actions\u0026#34;: [ { \u0026#34;description\u0026#34;: \u0026#34;Default Welcome Intent\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;MAIN\u0026#34;, \u0026#34;fulfillment\u0026#34;: { \u0026#34;conversationName\u0026#34;: \u0026#34;CONVERSATION_NAME\u0026#34; }, \u0026#34;intent\u0026#34;: { \u0026#34;name\u0026#34;: \u0026#34;actions.intent.MAIN\u0026#34;, \u0026#34;trigger\u0026#34;: { \u0026#34;queryPatterns\u0026#34;: [ \u0026#34;INVOCATION_SENTENCE\u0026#34; ] } } } ], \u0026#34;conversations\u0026#34;: { \u0026#34;CONVERSATION_NAME\u0026#34;: { \u0026#34;name\u0026#34;: \u0026#34;CONVERSATION_NAME\u0026#34;, \u0026#34;url\u0026#34;: \u0026#34;URL_WEBHOOKS\u0026#34;, \u0026#34;fulfillmentApiVersion\u0026#34;: 2 } }, \u0026#34;locale\u0026#34;: \u0026#34;fr\u0026#34;} Save the file in the same folder where you put the gactions program by choosing the JSON format. Name the file “actions.xx.json”, where xx is your language code: “fr” for french, “en” for english. We are going to call it “actions.fr.json”. In this file, you will have to change some fields:\nCONVERSATION_NAME: You can change it, or keep it like this. INVOCATION_SENTENCE: Copy and paste the first invocation that you have configured “Ok Google ….”. locale: Change it by using your language code. URL_WEBHOOKS: Before you change it, we will create a CKODA bot and activate the Google Assistant channel. Create your bot #Go to the CKODA application and create a bot using the Google Assistant channel.\nActivate the channel #The next step is to activate Google channel and change URL_WEBHOOKS from your file to the one given by CKODA.\nSo the steps are:\nClick on Channels menu. Click on Google Assistant channel. Copy the given url and replace URL_WEBHOOKS in your actions.xx.json file. Copy the project ID from Google that you kept before and past it in “Project ID”. Click on the button Save changes. Click on Activate integration. Run gactions program #Now you are able to run gactions command.\nOpen a command prompt in your gactions folder: cmd on Windows.\nHow to open command prompt in Windows\nGo into the folder where you saved actions.xx.json and gactions program. Click on the path of your folder (red line in the picture above). Windows will show you the complete path: Copy it. Go back to your command prompt type “cd”, then press space bar and CTRL+V. Press ENTER key. You should have something like:\ncd C:\\Users\\... Terminal on macOS and Linux (follow the windows steps). Now we are going to run gactions program:\nCopy the line and edit it on Notepad++ or other code editor. gactions update –action_package actions.xx.json –project project_id\nReplace:\nactions.xx.json by the name of your file. project_id by the “Project ID” that you put in your CKODA app. Then:\nPaste (CTRL+V) in your command prompt. Press ENTER key case. After running the command Google will ask you to open a link\nCopy the link in your browser and open it. It will ask you to connect to your Gmail account (Just do it :-D). It will ask you to authorize ASSISTANT CLI, click on Authorize button. You should arrive in a page where Google gives you a code.\nCopy the code and paste the code in your command prompt by doing CTRL+V. Then press “Enter“. Check that Google says “Your app for the assistant for project …. was successfully updated …”. Go back to Google Action Console and click on Actions. Check if you have a row “Default Welcome Intent”. If you don’t, please check the previous steps. If you have it, just click on the Test button and you are good to go. Complete your CKODA bot #Go back to CKODA application to fill your bot with a story, intents and entities.\nDisclaimer: To make your bot work with Google assistant, please create a special intent that will trigger your story. To do so:\nCopy-paste your INVOCATION_SENTENCE (Ok Google ….) in the new intent and save it. Don’t put anything else in your intent. Put the intent as a trigger of your first step. Now you can complete your first step, and create other steps and intents in the same story. Ok, Google ! #How to try your bot:\nUse Google Action Console simulator. Go to Google Console Action and open your project. Click on the “Actions” menu on the left side, then on the TEST button. Press ENTER key next to your INVOCATION_SENTENCE (“Talk to assistant test”) or use the microphone by clicking on: Use your Google Home device or Google Assistant application (iOS, Android) by calling your app with the invocation sentence you configured. Now enjoy 😉!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/connect-a-bot-to-google-assistant/","section":"","summary":"\u003ch1 id=\"connecter-google-assistant\" class=\"relative group\"\u003eConnecter Google Assistant \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#connecter-google-assistant\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eHere’s a quick tutorial to explain how to connect your CKODA bot to Google assistant and use voice with your bots.\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eDisclaimer\u003c/strong\u003e: This tutorial requires some basic technical level.\u003c/p\u003e\n\u003ch2 id=\"create-a-google-assistant-project\" class=\"relative group\"\u003eCreate a Google Assistant project \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#create-a-google-assistant-project\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eBefore you start creating a bot in our platform, you need to create a Google Assistant project:\u003c/p\u003e","title":"Connect a bot to Google Assistant"},{"content":"Connecter Chatbot Webchat # Content\nCKODA WebChat Connection Offers Multiple Functions in Platform.\nConnecting your chatbot to CKODA Webchat is simple, and the connection will allow you to use the full potential of our platform.\nChoose CKODA website as main channel #To access all the powerful actions with our webchat, you simply choose it when creating a chatbot.\nIt is the first item in the list, with the green and blue logo.\nIt will give you access to useful actions, like quick replies or cards, to enrich the responses you build for your users.\nThe integration on your website is then straightforward.\nConnect CKODA Webchat to your website #Go to the channels tab in the left menu, and then click on Clustaar WebChat.\nIt will open a panel, with two tabs: “Configuration” and “Behaviour”.\n“Configuration” inputs #Below are the inputs of the “Configuration” panel:\nWidget title: This is the text displayed on the chat widget when the window is minimized and must not exceed 16 characters. Welcome message: This message is displayed at the top of the chat window when no message has been sent yet and must not exceed 135 characters.\nPrompt placeholder: Text inviting user to ask a question and must not exceed 400 characters.\nClose button label: Text displayed on the chat widget when window is maximized and must not exceed 16 characters.\nAll contents are written by default but you can modify them to customize your webchat.\n“Behaviour” tab #This tab contains two inputs:\nWelcome story: A story you can set to be triggered at the first opening of the chat window.\nDefault state: State of the chat window (minimized / auto-display) at user’s arrival on your website.\nMoreover, you can add a custom event by clicking on “Add custom event” button. This enables you to push a given story when a previously set event happens.\nThere is two types of events:\nURL loaded: The story will be triggered at the loading of the URL given inside the “URL” field.\n“Ignore anchors” means that if user’s URL contains the URL plus an anchor then the story will be triggered anyway.\n“Allow extra GET params” means that GET params (GTM tags, …) won’t be considered and the story will be triggered.\nEvent triggered: The story will be triggered when a specific event happens, previously defined inside a javascript document.\nChannel activation #Click on the Activate button.\nThen, copy the script below, and paste it in your website header on the web pages where you want the chat to appear.\nIt’s done, congratulations!\nYou can now tune your widget 🙂\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/connect-a-chatbot-to-clustaar-webchat/","section":"","summary":"\u003ch1 id=\"connecter-chatbot-webchat\" class=\"relative group\"\u003eConnecter Chatbot Webchat \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#connecter-chatbot-webchat\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eCKODA WebChat Connection Offers Multiple Functions in Platform.\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/61165038/13b262f1a226de8b5a79950f/webchat-bubble-250.png\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e\n\u003cp\u003eConnecting your chatbot to CKODA Webchat is simple, and the connection will allow you to use the full potential of our platform.\u003c/p\u003e\n\u003ch2 id=\"choose-ckoda-website-as-main-channel\" class=\"relative group\"\u003eChoose CKODA website as main channel \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#choose-ckoda-website-as-main-channel\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eTo access all the powerful actions with our webchat, you simply choose it when creating a chatbot.\u003c/p\u003e","title":"Connect a Chatbot to CKODA Webchat"},{"content":"Connecter Iadvize # Content\nIn CKODA platform #To connect your bot to iAdvize, you need to choose iAdvize channel in the channels of your app.\nTo do this, click “iAdvize” in “Channels” tab:\niAdvize configuration panel opens:\nIt contains 2 fields:\nWebsite(s) ID(s) #This ID can be directly recovered in iAdvize platform. To do this, click your logo and then ‘Projects’:\nThen, click the ‘edit’ button for the concerned project:\nYour project details opens. Click ‘Code to insert’:\nYour website ID is accessible in the ‘principal tag’ section. In fact, you must take the four last numbers of ‘idz.src’ and add them to ‘ha-‘.\nIn this example, our website ID is ha-6762.\nNow go back to CKODA platform, fill the 2 fields and once this is done, you can click ‘Activate’ to activate iAdvize integration with your bot.\nYou’ve done the CKODA configuration! Now let’s move on iAdvize configuration.\nIn iAdvize #Select ‘CKODA’ as your App #Go in ‘App’ menu and select ‘Setup’ for ‘CKODA Conversational AI’ app.\nThen select “Next” for all the 3 following steps.\nOnce this is done, you need to create a new user of ‘Bot’ type in the ‘Team’ section of iAdvize with:\nA name and a pseudo of your choice ‘CKODA Conversational AI’ in ‘Select a type of bot’. Your bot name in ‘Select a scenario from iAdvize Bot”. ‘Communication’ and ‘Expertise’ fields with the options of your choice Do not forget to set your bot language in ‘Location’. You’re now ready to build a powerful integration between iAdvize and CKODA and consequently ensure that all your user queries will be correctly answered!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/connect-a-chatbot-to-iadvize/","section":"","summary":"\u003ch1 id=\"connecter-iadvize\" class=\"relative group\"\u003eConnecter Iadvize \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#connecter-iadvize\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003ch2 id=\"in-ckoda-platform\" class=\"relative group\"\u003eIn CKODA platform \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#in-ckoda-platform\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eTo connect your bot to iAdvize, you need to choose iAdvize channel in the channels of your app.\u003cbr\u003e\nTo do this, click “iAdvize” in “Channels” tab:\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/170162017/ccae6fd45e6f49af6dc28698/image.png\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e\n\u003cp\u003eiAdvize configuration panel opens:\u003c/p\u003e\n\u003cp\u003eIt contains 2 fields:\u003c/p\u003e\n\u003ch4 id=\"websites-ids\" class=\"relative group\"\u003eWebsite(s) ID(s) \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#websites-ids\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\u003cp\u003eThis ID can be directly recovered in iAdvize platform. To do this, click your logo and then ‘Projects’:\u003c/p\u003e","title":"Connect a chatbot to iAdvize"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/connect-your-bot/","section":"Categories","summary":"","title":"Connect your chatbot"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/get-started/","section":"Categories","summary":"","title":"Conversational UX"},{"content":"Exemples Bonnes Formulations # Content\nBefore proceeding to this article, you should read “How to create good intents for your chatbot”.\nIn the formulations written below, entities written in italic mean that the parameter is not required.\nSometimes several intents will be created for the same answer. Separating formulations in intents allow you to manage your formulations in a clear way and gain time in the future for maintaining your intents. They all trigger the same story.\nExample 1 – Update on order # Answer:‘To receive an update on your order you may use the Request Update button from within your account. Please allow the seller up to 24 hours to provide a response.’\nEntities used:\n@purchase: purchase, order, package @track: track, follow\nWe built 2 intents, each one containing formulations with a different intention.\nfirst one: intention is to track the purchase second one: intention is to know when the purchase will be received. First intent formulations could be:I need to @track my @purchaseI want to @track my @purchaseHow can I @track my @purchase?\nHow do I @track my @purchase?\nHow to @track my @purchase?\nCan I @track my @purchase?\nIs there a way to @track my@purchase?\nCan you help me to @track my @purchase?\nI’d like to @track my @purchaseWhere do I @track my @purchase?\n**Second intent formulations could be:**Where is my @purchase?\nWhat is the timeline to get my @purchase?\nWhen will my @purchase arrive?\nWhen should I receive my @purchase?\nI’m waiting for my @purchase\nWhat is the expected delivery date for my @purchase?\nWhat is my @purchase status?\nExample 2 – Store locator #Answer:‘Use the store locator to find stores in your area. Then, visit each store’s page to see store hours, directions, news, events and more.’\nEntities used:\n@near: near, nearby, near by, around, close @nearest: nearest, closest\nWe built 2 intents:\nfirst one: user is asking for a store near to user location second one: user is asking for the nearest store. **First intent formulations could be:**I need to find a store @nearI want to find a store @nearHow can I find a store @near?\nHow do I find a store @near?\nHow to find a store @near?\nCan I find a store @near?\nIs there a way to find a store @near?\nCan you help me to find a store @near?\nI’d like to find a store @near\nWhere do I find a store @near?\nDo you have a store @near?\nIs there a store @near?\nFind me a store @near\n**Second intent formulations could be:**I need to find the @neareststore\nI want to find the @nearest store\nHow can I find the @nearest store?\nHow do I find the @nearest store?\nHow to find the @nearest store?\nCan I find the @nearest store?\nIs there a way tofind the @nearest store?\nCan you help me to find the @neareststore?\nDo you know which is the @neareststore?\nI’d like to find the @nearest store\nWhich store is the @nearest?\nDo you know which is the @neareststore?\nFind me the @nearest store\nExample 3 – Change account personal information # Answer:‘Your account information can be found in the Settings section of your account: to change any of your personal information, click any option and follow the steps provided.’ Entities used:\n@account_actions_verbs: change, update, modify, edit @account_actions_nouns: change, update, modification, edit @account: information, info, settings, details, account, profile\nWe decided to build 2 intents for this answer:\nfirst one is dedicated to formulations in which the action is told in the form of a verb second one for formulations in which action is told in the form of a noun. First intent formulations could be:I need to @account_actions_verbs my @accountI want to @account_actions_verbs my @accountHow can I@account_actions_verbs my @account?\nHow do I @account_actions_verbsmy**@account**?\nHow to @account_actions_verbs my**@accountx**?\nCan I**@account_actions_verbs** my @account?\nIs there a way to @account_actions_verbs my @account?\nCan you help me to @account_actions_verbs my @account?\nI’d like to @account_actions_verbsmy**@account**\nWhere do I @account_actions_verbsmy @account? Second intent formulations could be:\nI need to do a @account_actions_nouns tomy @accountI want to do a @account_actions_nouns to my @accountHow can I do a @account_actions_nounsto my @account?\nHow to do a @account_actions_nounsto my**@account**?\nCan I do a @account_actions_nounsto my @account?\nIs there a way to do a @account_actions_nouns to my @account?\nCan you help me to do a @account_actions_nouns to my @account?\nI’d like to do a @account_actions_nounsto my**@account**\nWhere do I do a @account_actions_nounsto my @account?\nDo an @account_actions_nounsto my**@account**\nUser @account@account_actions_nouns\nExample 4 – Use Password Recovery Tool #Answer:‘I suggest using the Password Recovery Tool for your account: https://www.google.com/accounts/recovery/’\nEntity used:\n@credentials: credentials, password, pass word, pwd, username, account, login @recover: recover, reset, find, retrieve\n@login: login, log in, authenticate\n3 intents were built, each one for a different use case:\nfirst one: user wants to recover his credentials second one: user has lost his credentials third one: user has difficulty to login **First intent formulations could be:**I need to @recover my @credentialsI want to @recover my @credentialsHow can I @recover my @credentialsHow to @recover my @credentials\nCan I @recover my @credentials?\nIs there a way to @recover my @credentials?\nCan you help me to @recover my @credentials?\nI’d like to @recover my @credentialsWhere do I @recovermy @credentials?\nI’m not able to @recovermy @credentialsI’m unable to @recover my @credentials\n**Second intent formulations could be:**I can’t remember my @credentialsI’m not able to remember my @credentialsI’m unable to remember my @credentialsI forgot my @credentialsI lost my @credentials\n@credentials are not working for meMy @credentials don’t work\nWhere is the @credentials Recovery Tool?\nI have a @credentials issue\nI have a @credentials problem\n**Third intent formulations could be:**I’m not able to @login\nI’m unable to @login\nI can’t @login\nIt is impossible to @login\nExample 5 – Change order #Answer:‘To cancel or change an order you’ll need to contact the seller and ask him to change it for you.’\n4 intents have been created:\nfirst one: when action is asked in the form of a verb and concerns the entire purchase second one: when action is asked in the form of a verb and concerns a particular item of the purchase third one: when action is asked in the form of a noun and concerns the entire purchase fourth one: when action is asked in the form of a noun and concerns a particular item of the purchase Entities used:\n@purchase_actions_verbs: change, update, modify, edit, cancel, delete @purchase_item_actions_verbs: change, update, switch, modify, edit, cancel, delete, remove, add @purchase_actions_nouns: change, update, modification, edit, cancel, deletion @purchase_item_actions_nouns: change, update, switch, modification, edit, cancel, deletion, removal, add @purchase: purchase, order, package First intent formulations could be:I need to @purchase_actions_verbs my@purchaseI want to @purchase_actions_verbs my @purchase\nHow can I @purchase_actions_verbs a pending @purchase?\nHow do I @purchase_actions_verbs a pending @purchase?\nHow to @purchase_actions_verbs my**@purchase**?\nCan I**@purchase_actions_verbs** a pending @purchase\nIs there a way to @purchase_actions_verbs a pending @purchase?\nCan you help me @purchase_actions_verbs a pending @purchase?\nI’d like to @purchase_actions_verbs a pending @purchase\nWhere do I @purchase_actions_verbs a pending @purchase? @purchase_actions_verbsan existing @purchase\nSecond intent formulations could be:I need to @purchase_item_actions_verbs something in my@purchaseI want to @purchase_item_actions_verbsan item in my @purchase\nHow can I @purchase_item_actions_verbs something in my @purchase?\nHow do I @purchase_item_actions_verbs an item in my pending @purchase?\nHow to @purchase_item_actions_verbs something in my**@purchase**?\nCan I**@purchase_item_actions_verbs** an item in my pending @purchase\nIs there a way to @purchase_item_actions_verbs something in my @purchase?\nCan you help me @purchase_item_actions_verbs an item in my pending @purchase?\nI’d like to @purchase_item_actions_verbs something in my pending @purchase\nWhere do I @purchase_item_actions_verbs an item in my pending @purchase?@purchase_item_actions_verbssomething in my existing **@purchase\nThird intent formulations could be:**\nI need to do a @purchase_actions_nounsto a @purchaseI want to do a @purchase_actions_nouns in my @purchase\nHow can I do a @purchase_actions_nounsto a pending @purchase?\nHow do I do a @purchase_actions_nounsto a pending @purchase?\nHow to do a @purchase_actions_nouns to my**@purchase**?\nCan I do a**@purchase_actions_nouns** to a pending**@purchase**?\nIs there a way to do a @purchase_actions_nouns to a pending @purchase\nCan you help me to do a**@purchase_actions_nouns** to a pending**@purchase**?\nI’d like to do a**@purchase_actions_nouns** to a pending**@purchaseWhere do I do a@purchase_actions_nouns** to a pending**@purchase**?\nDo a @purchase_actions_nouns to an existing**@purchase**\nFourth intent formulations could be:\nI need to do a @purchase_item_actions_nounsof an item to my @purchaseI want to do a @purchase_item_actions_nouns of something to my @purchase\nHow can I do a @purchase_item_actions_nouns of an item to my pending @purchase?\nHow do I do a @purchase_item_actions_nounsof something to my pending @purchase?\nHow to do a @purchase_item_actions_nouns of an item to my**@purchase**?\nCan I do a**@purchase_item_actions_nouns** of something to my pending**@purchase**?\nIs there a way to do a @purchase_item_actions_nouns of an item to my pending @purchase?\nCan you help me to do a**@purchase_item_actions_nouns** of something to my pending**@purchase**?\nI’d like to do a**@purchase_item_actions_nouns** of something to my pending**@purchaseWhere do I do a@purchase_item_actions_nouns** of an item to my pending**@purchase**?\nDo a @purchase_item_actions_nouns of something to my existing**@purchase**\nYou’re now ready to build invincible intents!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/examples-of-good-formulations/","section":"","summary":"\u003ch1 id=\"exemples-bonnes-formulations\" class=\"relative group\"\u003eExemples Bonnes Formulations \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#exemples-bonnes-formulations\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eBefore proceeding to this article, you should read “How to create good intents for your chatbot”.\u003c/p\u003e\n\u003cp\u003eIn the formulations written below, entities written in \u003cem\u003eitalic\u003c/em\u003e mean that the parameter is not required.\u003cbr\u003e\n\u003cstrong\u003eSometimes several intents will be created for the same answer. Separating formulations in intents allow you to manage your formulations in a clear way and gain time in the future for maintaining your intents. They all trigger the same story.\u003c/strong\u003e\u003c/p\u003e","title":"Examples of good formulations"},{"content":"Chatbot Bonjour Monde # A gentle tutorial to begin with the CKODA platform.\nHello!\nThis might be the first article you read, so welcome 🙂 We are delighted to have you on board.\nOur objective here is to help you create your first chatbot and discover the main functionalities of the brand new CKODA platform. We will cover the basic example of the “Hello World” chatbot.\nLet’s Get Started:\n1. Create Your First “Hello” Intent\nWhen you arrive on the platform, start by creating an Intent. In the Intent, you determine what the user is saying; you can start with “Hello”.\nWhat is an Intent?\nGo to the **“**Setup AI” tab of your platform, and create your first Intent.\nIn the text field “User says something like”, you must consider all the ways users can say the Intent, so the platform understands all of these phrases equal to the Intent. In the example below, we considered “Hey” and “Hi” as being equal to “Hello”.\n2. Use it to Trigger a Story\nThen, you must determine what the chatbot will answer, so here you’ll create a Story.\nWhat is a Story?\nGo to the “Stories” tab of your platform, and create your first Story.\nHere, we named the story “Hello”.\nThen, use your Intent to trigger your Story. This means when your Intent will be detected in a user message by our NLP* engine. The story will be triggered and start its first step.\nYou can then configure your first step: Just click on it, and drag and drop the actionsyou want the chatbot to take when the user says “Hello”.\nWhy not a text answer and a nice picture?\nEach action is explained in the tutorials below:\n“Send text” Action\n“Send Image” Action\n“Typing” Action\n“Send Email” Action\n“Pause Bot” Action\n“Set Session” Action\n“Replies” Action\n“Send Cards” Action\nClick on **“**Save”, and you’re done!\n3. Update Your Chatbot\nThe NLP* model for the chatbot needs to be trained every time you add an intent or an entity. It will automatically train itself every minute, but if you want to test a new intent right away, you need to retrain it.\nJust click on “Train bot” when you see it on the top, right corner under “Bot outdated”.\n4. Test Your Chatbot\nAll that is left to do is test your chatbot in our test console.\nTo properly test your chatbot, you can use the “Reset” button to cancel the current session and get out of the story. Just be sure you test your chatbot as a new user.\nAnd here you are, you literally took your first step on your CKODA platform!\nTo learn more, read our other articles, or go have fun on the platform.\nOf course, if you have any questions, don’t hesitate to contact us through our livechat!\n*NLP : Natural Language Processing\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/first-step-create-a-hello-world-chatbot/","section":"","summary":"\u003ch1 id=\"chatbot-bonjour-monde\" class=\"relative group\"\u003eChatbot Bonjour Monde \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#chatbot-bonjour-monde\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003eA gentle tutorial to begin with the CKODA platform.\u003c/p\u003e\n\u003cp\u003eHello!\u003c/p\u003e\n\u003cp\u003eThis might be the first article you read, so welcome 🙂 We are delighted to have you on board.\u003c/p\u003e\n\u003cp\u003eOur objective here is to help you create your first chatbot and discover the main functionalities of the brand new CKODA platform. We will cover the basic example of the “Hello World” chatbot.\u003c/p\u003e","title":"First Step: create a “Hello World” Chatbot"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/categories/conversational-ux/","section":"Categories","summary":"","title":"Getting Started with Chatbots"},{"content":"Creer Formulaire Contact # Content\nThe step-by-step tutorial: #The CKODA platform gives endless possibilities to the users. We are going to build a simple contact form with an email address, a fallback and the client message. We will also give customers the opportunity to modify their message before sending it (because here at CKODA we do things properly 👌), and we will create a confirmation message for your client.\nTo create a contact form, you will need to use Sessions and the email Entity that is built-in the CKODA platform. Please have a look at the two articles on the subject: here and here. And be sure to read thoroughly, as we added a little bonus just for you at the end 😉\n1. Email Address Intent #Create an email Intent if you haven’t done it yet. Use the built-in email Entity. We wrote a useful tutorial on Intents right here.\n2. Story: Email and Message #A. Email #Create your Story and the first step.\nClick on the new Step you just created and write your question.\nNow, click on “then” and add a connection. Set it on the email Intent you created at the beginning and link it to your next Step.\nEmail Fallback:\nYou can’t send a contact form if the text fields are not correctly filled out. We want it to be the same on ours, so we are going to create a Fallback on the email Step.\nType the Fallback message you want the user to see and choose how many times you want it to appear.\n💡 Tip: Remember to always set a Fallback message when you use the email Entity.\nLearn more about Fallbacks.\nDon’t forget to test your Story as you go:\nB. Message\nCreate a “Message**“** Step.\nLink it to your next Step use an “Is set” connection. . We called it “End”.\n3. Modify or Send #Click on the “End” Step you just created.\nFirst, we want the user to see their message to reread it, the {{@message}} function enables the chatbot to display the user’s previous message.\nLearn more\nThen, we ask the user if they want to send or modify their message. We use Quick Replies for this feature.\nMore information on Quick Replies here.\nSend: Link the “End” button to your final Step (we called it “Thanks”). You can create it directly. Modify: Link the “Modify” button to the previous Step, in this case “Message”.\nDon’t forget to set a Session on the user’s message or else the bot won’t remember it 😉\nKey: messagesent\nValue: {{@message}}\nHang in there — we are almost done! 😊\nNow, click on the “Thanks” step we just created with our “Quick Replies”:\n4. “Thanks” step and Message Confirmation #The CKODA chatbot can send emails with the “Email” action card. Send all the information that you created with Sessions in the email body.\nHere is a good formula: {{@session. (+the “key” you chose previously) }}\nLearn more\nMessage Confirmation : You want your client to receive a confirmation email ? You can do it with the user’s email you stored in the Session.\nWe use our Session feature in the “Send to” field.\nWell done! You just created a contact form! 👏\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-create-a-contact-form/","section":"","summary":"\u003ch1 id=\"creer-formulaire-contact\" class=\"relative group\"\u003eCreer Formulaire Contact \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#creer-formulaire-contact\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003ch2 id=\"the-step-by-step-tutorial\" class=\"relative group\"\u003eThe step-by-step tutorial: \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#the-step-by-step-tutorial\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eThe CKODA platform gives endless possibilities to the users. We are going to build a simple contact form with an email address, a fallback and the client message. We will also give customers the opportunity to modify their message before sending it (because here at CKODA we do things properly 👌), and we will create a confirmation message for your client.\u003c/p\u003e","title":"How to Create a Contact Form"},{"content":"Menu Persistant # Content\nDiscover how to easily create a persistent menu for your CKODA Webchat.\nSetting a persistent menu enables your users to access to your bot main functionalities anytime in the conversation.\nHowever, persistent menu configuration is optional, you can set your bot “Live” with no persistent menu set.\nConfigure your menu #To configure your bot persistent menu, you need to go to “Menu” tab of CKODA Webchat configuration panel.\nIn this page, one menu item is displayed by default and you can add up to 5 items.\nFor each item, you need to configure:\n“Label” field: this corresponds to the label which will be displayed in your webchat. It needs to be clear and concise. “Custom event / URL” dropdown: this is the desired trigger type.\nFor example, if you want to trigger the story “Menu” on click on this item, select “Custom event”.\nOn the contrary, if you want to trigger a particular URL, select “URL” option. if “Custom event” selected:\n“Trigger event” field. On click, all the existing events and corresponding triggered stories are displayed. Events displayed here correspond to events declared in the “Behaviour” tab of your webchat.\nIf no existing event suits you, you can create a new event by clicking on “Create a new event” button, at the bottom of you events list. On click on this button, an event creation modal opens. Fill your event name and set the story to be triggered to Create your event.\nif “URL” selected:\n“URL” field: Copy and paste the desired URL here When your menu configuration is over, you can either move to another tab of your CKODA Webchat configuration, or directly “Save” the modifications you have done.\nUse your menu on the webchat # To unfold the menu, click the menu icon. You can then select the desired item. On click:\nif the trigger is a custom event: the corresponding story will be triggered in the conversation. if the trigger is an URL: the corresponding URL will open in a new tab. An item “Reset conversation” which does not belong to your menu will remain: it allows to reset the whole conversation with the chatbot.\nFire up your configuration panel! 😉\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-create-a-persistent-menu/","section":"","summary":"\u003ch1 id=\"menu-persistant\" class=\"relative group\"\u003eMenu Persistant \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#menu-persistant\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eDiscover how to easily create a persistent menu for your CKODA Webchat.\u003c/p\u003e\n\u003cp\u003eSetting a persistent menu enables your users to access to your bot main functionalities anytime in the conversation.\u003c/p\u003e\n\u003cp\u003eHowever, persistent menu configuration is optional, you can set your bot “Live” with no persistent menu set.\u003c/p\u003e\n\u003ch2 id=\"configure-your-menu\" class=\"relative group\"\u003eConfigure your menu \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#configure-your-menu\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eTo configure your bot persistent menu, you need to go to “Menu” tab of CKODA Webchat configuration panel.\u003c/p\u003e","title":"How to create a persistent menu"},{"content":"User Request # Content\n⚠️ This feature is not accessible by default. Do not hesitate to contact us ([email protected]) to discuss your project and benefit from this feature.\nRequest creation and configuration #User request feature consists in a particular configuration in your platform that will automatically create a user request each time your user reaches a specific step of a story.\nTo make this happen, you need to add a ‘User request’ action in the chosen step of the chosen story.\nFirst, drag and drop this action from the action panel to the step content:\nThe action is then displayed in the step content. It contains 2 fields to fill:\n“Assignee”: you can select the collaborator (with either Administrator or Support Agent rights) of your choice from the select list – optional. This means that all the requests created in this step will be assigned to this person by default. However, the assignee can also be set / modified once the request has been received. “Request Description”: Will be the content of the request and corresponds to its description. You can write “{{@message}} ” to recover user last message and add some text if needed. Once this action has been configured, you can “Save” your step and then access to “User requests” page of your “Inbox” tab to access and manage all the requests received.\nRequests management #Requests lists #Go to the “Inbox” tab of your platform and then click “User requests” to access the list of all the requests received. The screen is split in 2 views:\n“All requests”: all the requests received by the bot, whoever is the assignee “My requests”: all the request that have been assigned to me From these lists, you can:\nuse filters to solely display requests corresponding to the criterias you have set directly modify the assignee and / or request status click a request to display its details Request details #Once you clicked a request, a specific page is displayed. It contains:\nthe request title: by default set to the name of the step where the request has been created – editable name of story where request has been created request description extract of conversation history before request creation user attributes retained before request creation “create intent” button, to use requests received to continuously improve the bot button to access the entire conversation history button to take control of the conversation If needed, you can take control of the conversation to talk live with the user, provided that user is online. How to take control of a conversation?\nYou are now ready to automatically create requests, always provide an accurate answer to your users and benefit from these requests to efficiently improve your bot!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-create-and-manage-user-requests/","section":"","summary":"\u003ch1 id=\"user-request\" class=\"relative group\"\u003eUser Request \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#user-request\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003e⚠️ This feature is not accessible by default. Do not hesitate to contact us (\u003ca href=\"/cdn-cgi/l/email-protection#bad9d5d4cedbd9cefad9d6cfc9cedbdbc894d9d5d7\"\u003e[email protected]\u003c/a\u003e) to discuss your project and benefit from this feature.\u003c/p\u003e\n\u003ch2 id=\"request-creation-and-configuration\" class=\"relative group\"\u003eRequest creation and configuration \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#request-creation-and-configuration\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eUser request feature consists in a particular configuration in your platform that will automatically create a user request each time your user reaches a specific step of a story.\u003c/p\u003e","title":"How to create and manage user requests"},{"content":"Creer Bonnes Intents # Content\nIf you are reading this article it means that you have already worked on the platform and want to make your Bot more efficient in detecting your clients needs when talking to the Bot.\nIf you don’t know what a NLP Engine is or are unfamiliar with Intents please refer to Timothée’s article: Discover what is an intent\nFor starters here are a few basic principles 👩‍🏫\nSemantic diversity Balanced number of intent formulations Use entities for endless variations of intentions How to write good intent phrases ? 💡 #How many formulations per intents? #It’s important to have a balanced number of formulations per intents. A minimum of 5 or 6 formulations is required per intent but you can add as many as you like as long as all the intents have a balanced number of phrases in each of them ⚖️\nDon’t forget that the Bot learns what you feed him, so the more you will give it intent formulations, and the more he will be precise.\nDon’t forget: If two intents are similar and one has more intent formulations than the other the engine will promote the answer of the intent with the most formulations.\nThe same goes in the way you write your intent formulations, if you use a certain type of wording, try and repeat the wording in all the intent phrases you think it would be used.\nHere is an example with two intents :\nReimbursement intent\nI want to be reimbursed\nI would like to be reimbursed\nHow can I be reimbursed\nClosing account intent I want to close my account\nI would like to close my account\nHow can I close my account\nShould I train the bot with short or long phrases ? #Well it depends on what are the type of phrases your user’s use if you think your user’s will use short phrases try short phrases. If they use long phrases try long phrases 😉\n📯 Note : The bot will only understand one intent per phrase. He won’t understand “I want to be reimbursed, close my account and a nice cup of hot chocolate with vanilla chantilly please”.\nWhat about spelling mistakes ? #The NLP should be able to manage minor spelling mistakes.\nThe CKODA platform handles a few languages, queries are sent to the NLP engine without accents nor upper and lower cases, so it is not necessary to write the same wording by varying them. It is the same for feminine/masculine and singular/plural words.\nHow does the priority of intentions work? 📈 #Priority always outweighs matching probabilities when recognizing intentions.\nWhen an intent is detected, the most likely intention is always matched unless an intention has a higher priority.\nImagine we have two intentions:\n“You’re super nice” with normal priority and matching method in NLP.\n“Nice” with high priority and matching method in Contains.\nIf the user says “you’re super nice”, the second intention will take over the first one. Whereas if both intentions have the same priority, the first intent will match.\n1️⃣ #Low priority\n2️⃣ #Medium priority\n3️⃣ #High priority\nWhat you can do when creating a bot is set the smalltalk (i.e hello, yes, no) priority level to low. Those are formulations that, even if they are present in the sentence, must pass after others.\nFor example:\n“Hello you, I would like to change my password”\nWe want to be sure that it will always be the “password forgotten” intent that will be chosen and never the “hello” intent. This can be secured by setting a lower priority on “hello”.\nHow to use entities? 💬 #If you don’t know what are entities please refer yourself to Timothée’s article right here.\nEntities have a great purpose : They avoid writing exactly the same sentence with an important word that changes to describe the same concept.\nExemple :\n@payment_option: payment option, payment method, credit card, cc, debit card, card, cash\n@change: change, update, switch, modify, edit\nI want to @change my @payment_option\nhow do I @change @payment_option\nI’d like to @change my @payment_option\nCan I @change my @payment_option\nHow to @change my @payment_option\nIs there a way to @change my @payment_option\n🎁 Bonus Tip 🎁\nYou can use use the “Analyze” function on the top right of the CKODA WebChat Stream in the platform to see your intent scoring :\nTo see more concrete examples of good formulations, visit this article.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-create-good-intents-for-your-chatbot/","section":"","summary":"\u003ch1 id=\"creer-bonnes-intents\" class=\"relative group\"\u003eCreer Bonnes Intents \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#creer-bonnes-intents\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eIf you are reading this article it means that you have already worked on the platform and want to make your Bot more efficient in detecting your clients needs when talking to the Bot.\u003c/p\u003e\n\u003cp\u003eIf you don’t know what a NLP Engine is or are unfamiliar with Intents please refer to Timothée’s article: \u003ca href=\"https://helpdesk.clustaar.com/en/knowledge-base/what-is-an-intent/\" target=\"_blank\" rel=\"noreferrer\"\u003eDiscover what is an intent\u003c/a\u003e\u003c/p\u003e","title":"How to create good intents for your Chatbot?"},{"content":"some images dont appear!!!\nComment Utiliser Une Entite # Content\nAn Entity represents a concept, or a subject, that can be used in a sentence. It can be used to handle different values for an important concept, or for the chatbot to retain information during the conversation.\nThere are two kinds of entities in the CKODA Platform: Built-in and User defined.\nUser-defined entities #You can create your own entities according to your own needs. You can allow your chatbot to recognize words or expressions.\nYou should use an entity when you need to:\nWrite several formulations with one, in an intent (factorisation); Force the presence of a concept for the matching of an intent (like an essential key-word); Use the value of a session variable. Factorisation #You can use this to easily maintain several formulations in an intent. It can be useful for concepts or actions.\nConcept\nAction\nA single entity can be used in several intents.\n⚠️⚠️ When using an entity, the sentence must remain coherent: don’t mix adjectives, verbs and nouns in one entity. ⚠️⚠️\nDon’t hesitate to create many different entities. It’s better than to create one “catch-all” entity: in a context, two words can be synonyms, but not in the other.\nTwo entities can also share values/synonyms and be used in different contexts.\n“Required” parameter #An intent does not use the entity directly. The intent will create a parameter to represent an entity, whose value can be stocked in a session. Those parameters are very important because you can change them yourself, to have two different versions of one entity in the same intent. For example, one “Required”, the other not.\nBy default, the parameter of an entity is on “Synonym”. This means this value has the same weight as any other word of the formulation.\nIt can also be “Required“. This means one of the values/synonyms of the entity must be present in the user query to match the intent.\n⚠️⚠️ A non-necessary word must never be “required”, or else it can stop the intent from matching when it should. ⚠️⚠️\nIn this example, “contact” and “customer service” are essential words (Required), but “mail” is not because (Non-required) people could say: “I want to contact your customer service” or say “by phone” instead of “via email”.\nA few tips on how to use the “Required” option:\nI use my entities for synonyms, but if it’s not present, the intent should still match\nSynonym\nI want to anticipate informations a user could give me before I even ask (see the article about values)\nNot Required\nI need this word to be present in the question\nRequired\nI don’t need the concept to be present in the question, but if it’s absent, the sentence loses its meaning\nSynonym\nHere is the basis of the entity concept. To go further, you can check out these articles:\nBuilt-in entities How to use the value of an entity Was this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-use-an-entity/","section":"","summary":"\u003cp\u003esome images dont appear!!!\u003c/p\u003e\n\u003ch1 id=\"comment-utiliser-une-entite\" class=\"relative group\"\u003eComment Utiliser Une Entite \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#comment-utiliser-une-entite\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eAn Entity represents a concept, or a subject, that can be used in a sentence. It can be used to handle different values for an important concept, or for the chatbot to retain information during the conversation.\u003c/p\u003e\n\u003cp\u003eThere are two kinds of entities in the CKODA Platform: \u003ca href=\"https://helpdesk.clustaar.com/en/knowledge-base/built-in-entities/\" target=\"_blank\" rel=\"noreferrer\"\u003eBuilt-in\u003c/a\u003e and User defined.\u003c/p\u003e","title":"How to use an entity?"},{"content":"Utiliser Valeur Entite # An entity’s value can be used to jump directly to the right step, without having to ask another question to the user.\nWe will use an example to show you how this works.\nHere, we have an intent “Customer service”, containing the entity “contact” in required and “contact_channel” in non-required.\nHere is the entity “contact_channel”\nAll right, buckle up, this is where it gets interesting.\nWe want the chatbot to understand “I want to contact you” and go to a step asking which contact channel they prefer.\nHowever, if they already said which channel, we don’t want to ask again.\nSo, I constructed my story like this:\nIn the first step, not only did I put the question “Which channel do you prefer?”, but I also put a Jump to action, before this question.\nThis jump will avoid asking the channel question if the user already provided the information.\nIn the configuration of the Jump To, I put three conditions, depending on the value given to the parameter “contact_channel”.\n⚠️⚠️In the “jump to” configuration, remember you use the parameter’s name, not the entity’s name. ⚠️⚠️\nIf the entity is present in the user’s question, the information will be taken into account, and used to jump directly to the right step.\nIsn’t it great?\nYou can also use the values of the entities to re-use in the conversation. In the same context, we could say this.\nThis allows you, for example, to check with your users on the information they gave you. You could have to do that in a contact form.\nI hope this was useful, don’t hesitate to contact us if you have more questions about this feature. You might, it’s not that trivial! 😉\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/how-to-use-an-entitys-value/","section":"","summary":"\u003ch1 id=\"utiliser-valeur-entite\" class=\"relative group\"\u003eUtiliser Valeur Entite \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#utiliser-valeur-entite\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003eAn entity’s value can be used to \u003ca href=\"https://helpdesk.clustaar.com/en/knowledge-base/how-to-use-the-jump-to-action/\" target=\"_blank\" rel=\"noreferrer\"\u003ejump directly to\u003c/a\u003e the right step, without having to ask another question to the user.\u003c/p\u003e\n\u003cp\u003eWe will use an example to show you how this works.\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/76852668/8b9e148e18a803ccd7fb97dd/image.png\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e\n\u003cp\u003e\u003cem\u003eHere, we have an intent “Customer service”, containing the entity “contact” in required and “contact_channel” in non-required.\u003c/em\u003e\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/76851855/ecebad96c71553d068cf6696/image.png\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e","title":"How to use an entity’s value"},{"content":"Lexique # Here is a small dictionary of all the words you need to know to become a CKODA Platform Pro !\nAction : This word refers to all the types of content the bot can perform. These are explained and detailed in the “Explore Action” Collection you can find here.\nAPI (Application Programming Interface) : Interface used to connect the CKODA Platform with another application in order to benefit from its services.\nChannel : The interface to which your channel will be connected. You can learn how to deploy your bot on the desired channel on these tutorials.\nDashboard : The menu item which displays the important datas of your bot. You can access to your intents and entities directly from there.\nEntity : An Entity represents a concept, or a subject, that you can use in a sentence. It can be used to handle different values for an important concept, or for the Chatbot to retain information during a conversation.\nIt can also be used as a safeguard, to prevent intent matching if the use message does not contain a targeted entity. To learn more about this concept, read this tutorial.\nFallback : The fallback corresponds to the bot’s behavior in case it does not understand a user’s message.\nThere are three levels of fallbacks :\nThe general fallback The story fallback The step fallback This tutorial will help you understand fallbacks and how to configure them.\nIntent : An intent gathers all the possibilities for a user to state an intention. The chatbot will then recognize the intention and answer properly. After reading this tutorial, you will know everything about intents 😉\nLink : A link determines the following of a step depending on defined conditions. A step can be linked either to a different story or to a step.\nNLP (Natural Language Processing) : This is the capacity of the CKODA chatbots to understand human language. Our NLP algorithm allows your bot to understand messages accurately regardless of common mispellings.\nFor example, if the user says “Helllo”, the bot will understand that the user wanted to say “Hello”.\nPriority : It is an intent’s degree of importance. This is useful in case several intents match a question asked by the user. In this case, an intent with a high priority will take over another with a smaller priority.\nStep : A step is a part of a story which defines what the bot will do. The step menu is composed of three tabs:\nStory : A story is a scenario, based on your user’s answers. It has to be necessary defined as soon as you wish to go further than a simple question-answer chatbot.\nIt is composed of steps, linked to each others. To discover how to build a story you can take a look here 😉\nWebhook : A webhook is a connector which allows you to handle data and build functionalities outside the platform. To learn more about webhooks, let’s go to our tutorial here !\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/lexicon/","section":"","summary":"\u003ch1 id=\"lexique\" class=\"relative group\"\u003eLexique \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#lexique\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003eHere is a small dictionary of all the words you need to know to become a CKODA Platform Pro !\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eAction :\u003c/strong\u003e This word refers to all the types of content the bot can perform. These are explained and detailed in the “Explore Action” Collection you can find \u003ca href=\"https://helpdesk.clustaar.com/en/article-categories/actions/\" target=\"_blank\" rel=\"noreferrer\"\u003ehere\u003c/a\u003e.\u003c/p\u003e\n\u003cp\u003e\n\n\n\n\n\n\n  \n  \n\u003cfigure\u003e\u003cimg src=\"https://downloads.intercomcdn.com/i/o/64430329/835d5dffaa652ac606710e30/image.png\" alt=\"\" class=\"mx-auto my-0 rounded-md\" /\u003e\n\u003c/figure\u003e\n\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eAPI\u003c/strong\u003e (Application Programming Interface) : Interface used to connect the CKODA Platform with another application in order to benefit from its services.\u003c/p\u003e","title":"Lexicon"},{"content":"Traduction Manuelle # Content\nManual content translation is a tool that allows you to export all your chatbot text content into an XSLS file in order to translate it in an optimized way, and consequently easily create a version of your chatbot in several different languages.\nFirst step: Clone your bot #The first step is to clone your “original” bot, in other words the one you want to translate into one or more different languages.\nTo do this, simply use the “Clone this bot” button, available in the menu of your bot.\nWe clone our “CKODA FR” chatbot because we want to create an EN version of it.\n⚠️ The cloned bot will be in “Free trial”. Please contact us to benefit from the manual content translation tool.\nSecond step: Export bot content #Once your bot has been cloned, you can export its content. You will then obtain an XSLX file with all your bot content, allowing you to translate everything efficiently.\nGo to the menu of the bot you just created and click “Export text content”:\nWe export the content of our English CKODA bot.\nThe exported contents are the original contents. You will be able to translate them and then import the file. In this way, the original content will be overwritten and replaced by the translated content, and you will obtain a fully translated bot.\nAs you click “Export text content”, a modal opens, offering you several options:\n1) Export content for translation :\n– “Yes“: you are doing a translation. In this case, the entity values will be exported as synonyms.\n– “No“: you are not doing a translation, but creating a similar bot in the same language, for another product for example.\n2) Content :\n– “Bot-content“: text content intended for end-user\n– “Technical content“: technical contents (element names, session values, user attributes and “contains” conditions”)\n– “All content“: text contents + technical contents\nHere the export is for translation (translation of the CKODA FR bot into English) and I want to translate bot contents that are intended for end-users\nOnce the export is finalized, you can download the generated file by clicking the “Download file” button. You will then obtain an XLSX file with several columns:\n“text“: original text – do not modify “translation“: your translation – only column to fill in “description“: element to which the text belongs and what it corresponds to – do not modify “url“: element URL – do not modify “type“, “id“, “action_type“, “attribute“: technical data – do not modify On the 1st line:\n– “est-ce que vous parlez @langues:langues” is the original text\n– “do you speak @languages:languages” is my translation\n– the description explains that it is a formulation, from the intent named “Parlez-vous…?”\nFor the 2nd line, I chose not to add any translation.\n⚠️ Translation is optional:\nif you’re doing a translation: the occurrences with no translation for contents having several occurrences (intent formulations or entity synonyms for example) will be removed. otherwise: occurrences with no translation will keep their original value. Once you have translated all the texts necessary for the proper working of this new bot, go back to its menu and select “Import text content”. A dialog box will open, allowing you to import your modified XLSX.\nThen click “Import” and the content of your bot will be automatically replaced by the translations added to the file.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/manual-content-translation/","section":"","summary":"\u003ch1 id=\"traduction-manuelle\" class=\"relative group\"\u003eTraduction Manuelle \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#traduction-manuelle\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eManual content translation is a tool that allows you to export all your chatbot text content into an \u003cem\u003eXSLS\u003c/em\u003e file in order to translate it in an optimized way, and consequently easily create a version of your chatbot in several different languages.\u003c/p\u003e\n\u003ch2 id=\"first-step-clone-your-bot\" class=\"relative group\"\u003eFirst step: Clone your bot \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#first-step-clone-your-bot\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eThe first step is to clone your “original” bot, in other words the one you want to translate into one or more different languages.\u003c/p\u003e","title":"Manual content translation"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/tags/","section":"Tags","summary":"","title":"Tags"},{"content":"Prendre Controle Conversation # Content\n⚠️ This feature is not accessible by default. Do not hesitate to contact us ([email protected]) to discuss your project and benefit from this feature.\nHow to influence bot behaviour depending my Support team availability? #Configure availability slots #As a bot Administrator, you can define availability slots in the “Support” tab of the “Settings” section.\nA week is displayed. This week is a template, which means that all the availability slots defined will repeat all over the weeks. Moreover, it concerns the whole Support Agent team.\nTo add a new slot, click the desired time of the day and then extend the period if needed. You can also drag and drop it wherever you need.\nIn case of a punctual event making the Support team unavailable, you can define a “Temporary unavailability”.\nTo do this, click “Activate” in “Temporary unavailability” section. A modal will open, where you can define the period needed (hours and minutes), starting from now. Once your period has been defined, click “Activate”:\nthe unavailability period displays in the Calendar You can access the remaining time both in the “Temporary unavailability” section and in the header support tag. Warning # You cannot define a period that goes beyond the current day. Availability and unavailability periods have an impact for “jump to” conditions (see below) only. In fact, take control can be done whatever the support availability is. Use “Support team” jump to conditions #New conditions are possible for “Jump to” actions: “Support team” “is online” / “is offline”.\nThis allows you to configure your bot’s behaviour depending on Support team availability. This way, if Support team is not available at request creation, you can redirect user towards a specific story for an asynchronous human takeover.\nHow to take control of a conversation in app? #Human take control is possible from a user request, provided that:\nyou benefit from either Administrator or Support Agent rights user who created the request is online (user status is specified live at the top of user request) In fact, to start a new live conversation with the user, you only need to:\nclick “Take control” button, at the bottom of the concerned request: live conversation then opens in “live conversation” panel on the right of the screen. directly talk to the user, by writing your message in the text zone and then send it using “send” button on the right of this zone messages sent and user responses will appear progressively in the conversation panel You can consequently both navigate through your bot and handle several live conversations in the mean time.\nIf needed, you can easily access to the concerned user request by clicking “See associated User Request” at the bottom of a live conversation:\nMoreover, do not hesitate to select “All live conversations” view to access the list of all the live conversations currently happening, all agents considered.\nWhat does it look like for my end-user? #The functioning is very clear and transparent for end-user.\nIn fact, from the moment when an agent takes control of the conversation, the bot is paused and user is notified by:\na banner “A support agent is online” at the top of the conversation, meaning that an agent is online and has the control of the conversation a small text when the agent takes control and another small text when agent releases control These texts cannot be modified. They are displayed either in English or in French, depending on end-user browser’s language:\nif browser is in French: texts are in French else: texts are in English You are now ready to take full advantage of this new functionality and ensure that your users will never end a conversation without obtaining the answer they needed!\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/take-control-of-a-conversation/","section":"","summary":"\u003ch1 id=\"prendre-controle-conversation\" class=\"relative group\"\u003ePrendre Controle Conversation \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#prendre-controle-conversation\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003e⚠️ This feature is not accessible by default. Do not hesitate to contact us (\u003ca href=\"/cdn-cgi/l/email-protection#fb9894958f9a988fbb98978e888f9a9a89d5989496\"\u003e[email protected]\u003c/a\u003e) to discuss your project and benefit from this feature.\u003c/p\u003e\n\u003ch2 id=\"how-to-influence-bot-behaviour-depending-my-support-team-availability\" class=\"relative group\"\u003eHow to influence bot behaviour depending my Support team availability? \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#how-to-influence-bot-behaviour-depending-my-support-team-availability\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003ch4 id=\"configure-availability-slots\" class=\"relative group\"\u003eConfigure availability slots \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#configure-availability-slots\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\u003cp\u003eAs a bot Administrator, you can define availability slots in the “Support” tab of the “Settings” section.\u003c/p\u003e","title":"Take control of a conversation"},{"content":"","date":null,"permalink":"https://helpdesk.ckoda.ai/en/true/","section":"True","summary":"","title":"True"},{"content":"Tutoriel 101 # Content\nThe objective of this article is to take you by the hand, if you want it so. 😊\nThis is a step by step guide of how to start in the CKODA Platform.\nIf you don’t feel like reading, you can also find this video step by step guide.\nCreate a chatbot in the platform #When you arrive in the CKODA Platform, we offer a fresh chatbot for you: Your First Chatbot. You can go check it out, it will present the basic features of the Platform and some cool things you can do with it.\nBut for now, let’s focus on creating a new chatbot.\nFirst, choose the name of your chatbot, and its language.\nThen, choose the channel:\n⚠️\nWhen choosing the channel, remember that each channel offer specific functionalities. Some are free (CKODA Webchat, Messenger), some require an account on another software (Intercom, Twilio).\nDepending on the objective of your chatbot, you will not choose a different channel.\nTo get started, we suggest choosing the CKODA Webchat. It’s free, offers the main features needed to build a chatbot (cards, buttons…) and can be plugged into any website in a few seconds.\nMore about channels\nThen, you can import items:\nIf you chose, you can import items from an existing bot. However, if you’re reading this article, you may not have an existing chatbot. 😉\nYou can also import pre-built intents, entities and stories from one of our templates to hit the ground running.\nYou can also chose not to import anything and Skip directly to the bot builder.\nCreate your first story #When you arrive in the bot builder, everything is empty, so you’ll need to create a first Story by clicking on Create your First Story.\nYou can name it “Hello”. No matter what your bot project is, you will always need a “Hello” story!\nMore about Stories\nYou will arrive in the Story building part of the platform.\nClick on the First step to start editing your story\nBy clicking on the first step you will open the Step configuration panel.\nOn the left of the panel, you will see actions that you can drag\u0026amp;drop in the panel.\nDiscover actions\nThis is where you chose, at any step of your scenario, what your chatbot will do: answer with text, images, cards; pause; remember information; send an email, etc…\nIn this tutorial, we suggest you use three actions:\nText: to say “Hello”; Typing: to give your user some time to read and make the bot more human; Replies: to ask “How are you?” and suggest answers with buttons. The next steps #Create the next steps #In the CKODA platform, you usually create the next steps on the go. While you’re in the first step, you will start thinking of what happens next.\nFor example, when you create your buttons (Replies), you will need to say where the user will go by clicking on this button, therefore creating a new step.\nHere, we asked “How are you?” so we are going to give the user two options:\n“Good”, directing them to a new step called “Good” “Bad”, sending them to the step… “Bad” When the two buttons are created, it will look like this:\nThat way, you will have created the next two steps of your scenario.\nConfigure the next steps #Then, you can click on each step to add actions.\nFor example, we’ll open the step “Good” and show the bot is happy that you are doing good 😊\nDrag\u0026amp;Drop a “Text” action and add the text you want.\nYou can do the same with the step “Bad”.\nTrigger your story #Now that you have created your first Story, you will need to trigger it. The trigger is usually a message from the user, what we call an Intent.\nMore about intents\nSo you need to create an Intent to trigger your story. Here is how you do it:\nGo in the “Triggers” zone at the top of your story Click on “Intents”, then on “Create a new intent” The “Steps” triggers show you what other steps lead to your story. They will appear along the way, if you create links between stories.\nBuild your intent #When you click on “Create an intent”, the intent configuration pannel will open. Here are the two first and most important things you’ll need to do to calibrate your intent:\nName your intent You need to ask yourself “when do i want this story to be triggered ?”. In this example, the Story “Hello” needs to be triggered by the intent “Hello”.\nWrite a few differents phrasings Here, you will put different ways of saying “Hello” so the chatbot has a chance to understand it whichever way people say it.\nIn the case of a more complex intent like “contact customer support”, you will need to input a few different phrasings :\nI want to contact your customer support\nI would like to speak to a human\nCan I be put in contact with your team ?\nThen, click on the “Create” button, at the bottom of the intent panel.\nTest your chatbot #Now that you have created a very basic scenario, you can try it in the test console on the right of your screen.\nAnd here you go, you have your first story. Then you can keep expanding the story you built, or create new ones.\nYou can create new intents and discover entities, which are one of the many great features of the CKODA platform, making it more complex, and allowing you to build really valuable chatbots!\nDiscover entities\nAnd of course, don’t hesitate to contact us if you have any question or want to see a demo of everything you can do with the CKODA Platform!\nGet a demo\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/tutorial-101/","section":"","summary":"\u003ch1 id=\"tutoriel-101\" class=\"relative group\"\u003eTutoriel 101 \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#tutoriel-101\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eThe objective of this article is to take you by the hand, if you want it so. 😊\u003c/p\u003e\n\u003cp\u003eThis is a \u003cstrong\u003estep by step guide of how to start in the CKODA Platform\u003c/strong\u003e.\u003c/p\u003e\n\u003cp\u003eIf you don’t feel like reading, you can also find this video \u003ca href=\"https://www.youtube.com/watch?v=UFrO1iajBUE\u0026amp;list=PLG4FKgsn5Ho6uF8ShL1OuwD-pAAJ7kCCk\" target=\"_blank\" rel=\"noreferrer\"\u003estep by step guide\u003c/a\u003e.\u003c/p\u003e\n\u003ch2 id=\"create-a-chatbot-in-the-platform\" class=\"relative group\"\u003eCreate a chatbot in the platform \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#create-a-chatbot-in-the-platform\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eWhen you arrive in the CKODA Platform, we offer a fresh chatbot for you: Your First Chatbot. You can go check it out, it will present the \u003cstrong\u003ebasic features\u003c/strong\u003e of the Platform and some cool things you can do with it.\u003c/p\u003e","title":"Tutorial 101"},{"content":"Tuto 102 # Content\nIn this tutorial, we will guide you through the step by step construction of a form. After that, you will be able to deploy your first qualification chatbot in no time!\nFirst you need to create a Bot on the platform with the CKODA webchat, to understand the basics please refer to this tutorial: Tutorial 101 : Create a Chatbot\nRight, you created your first chatbot by following Tutorial 101 now you want to see how a chatbot can really add value to your website. 🙂\nUse Case #Let’s say you have a SaaS product and you want a chatbot to qualify the futur customers on your website.\nWhat do we need ?\nA – Create The Form # Company name The Company Sector Job title of the customer Maybe he wants to leave a message ? Email address Send all this info to your beloved sale’s team ([email protected] “wink wink” 👀 ) B – Integrate the chatbot # Create a Welcome Story Integrate the chatbot Okay, let’s start! 🧐\nA – Create The Form #Create the story:\nBy now you should already know how to create a story if you completed Tutorial 101. Here we are calling it “Customer Qualification Form“.\nCreate an intent for your story:\nWhat is an intent?\nCreate a second intent with the email entity, you will need it for later.\nClick on the “@” and choose “email“\nBuilt-in entities\nWell done! Now we can start building the story.\n1 – Step Company Name #Enter your story and start by modifying the First Step.\nClick on the “First step” step.\nRename the step and add the text that you wish with a “Text” action. Then click on “Set reaction…” to add a condition and create the following step.\nSet up the “If case” with “User response” “Is set“.Click on the “Links to” case and on “+Create a new step“**.**Name the step.\nClick on “Save“\n2 – Step Company Sector #Now click on your new step. We called it “Company Sector“.\nHere we are going to ask our future customer what is his business sector, for this question we are going to use buttons with the “Replies” action.\nBut first, we have to set a session value for the previous step. Remember, we asked our customer for the name of his company, and we want to remember this information wo we can send it to our sales team.\nUse the Session Value action of the bot builder.\nSet up the Session Value like this :\nKey: company\nValue: {{@message}}\nThe key is the name of the variable that you can re-use and the value is the information you want to retain. {{@message}} saves the last message of the user.\nNow, on to the next part of the step. We created 5 buttons by clicking on **+add a quick reply.**On the first button we created a new step called “Job title“\nWe want to keep this information so we are going to set up a Session Value in each button.\nDiscover “Sessions”\nClick on “Save Custom Variable….“\nVariable : sector\nButton Value : Healthcare/Retail/Education/Finance/Others\nLink each button to the same next step (Job title)\nSave your step.\n3 – Step Job title #Click on the Job Title step you just created.\nNow you can ask the job title of your customer :\nClick on “Set reaction to…“\nSet up your conditions on “user response” “is set” (IF) and create a new step by clicking on the “Links to” case.\nWe called the step “Number of employees“\nClick on Save.\n4 – Step Message #Click on the Message step you just created\nHere we are going to ask the user why he is interested in our product:\nClick on “Set reaction to…“\nSet up your conditions on “User response” “is set” (IF) and create a new step by clicking on the “Links to” case.\nWe called the step “Email“\nClick on “Back“\nSet up the Session Value like this:\nKey : jobtitle\nValue : {{@message}}\nClick on “Save“\n5 – Step Email #Click on the Email step you just created\nClick on “Set reaction to…“\nSet up your conditions on “User response” “Matches intent” (IF) and click on the “Select intent” case.\nChoose “Email“, it’s the intent we created at the beginning, remember? 😉\nCreate a new step by clicking on the “Links to” case.\nWe called the step “Send information“.\nClick on “add a fallback message“.\nHere we are going to create a Fallback message in case the customer didn’t write his email properly. What is a fallback\nWrite a text to notify the error and set how many times you want the fallback message to be seen by the user.\nClick on “Back“\nSet up the Session Value like this :\nKey: message\nValue: {{@message}}\nClick on “Save“.\n6 – Step Sending the information #Click on the “Send Information” step you just created\nAt this stage, you can thank the user for the information he gave you. That’s common courtesy. 😊\nNow we have to send all this information to the user, for this we are going to use the email bloc:\nRight, so now i hope you noted all the Session Values you created 😉\nSend to: the email address you want the information to be sent to Title: make it clear for the receiver Message: Here you have to display all the Session values you retained\nSession Values\nCompany name: {{@session.company}}\nCompany sector: {{@session.sector}}\nJob Title: {{@session.jobtitle}}\nMessage: {{@session.message}}\nEmail: {{@session.email}}\nIf you complete the form in the webchat this is what it looks like:\nAnd here is the email you should receive:\nB – Integrate The Chatbot #1 – Create a Welcome Story #Now that you created the Chatbot maybe you can create a Welcome Story to greet the user of your chatbot!\nThe welcome story is the story that the Bot will launch when you open the webchat.\nHere we called the scenario “Welcome Story“\nNow click on “First Step“\nHere we ask the user what he wants to do. Try to encourage him to use your Chatbot.\nNow name the button, here we called it “Get in touch!“\nLink it to the story you just created\nWe also added a second button in case the user wouldn’t want to get in touch with you.\nHere we linked it to a new step but don’t hesitate to create a new story or give the possibility to the user to explore another side of your chatbot.\nNow you can “save” your step.\n2 – Integrate the chatbot #Now we have to integrate the chatbot.\nClick on “Channels” and on CKODA Webchat.\nHere you can set up your webchat.\nCopy the script\nPaste it in your html file like this in the header ( )\nSave your file!\nGo on your website and you will see the chatbot appear!\nYes, it was that simple! 😉\nThank you for reading this tutorial! And well done if you managed to complete it! 👏\nYou can out this Bot in our “Template” section :\nDon’t hesitate to contact us if you have any question or want to see a demo of everything you can do with the CKODA Platform!Book a demo 🎁\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/tutorial-102/","section":"","summary":"\u003ch1 id=\"tuto-102\" class=\"relative group\"\u003eTuto 102 \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#tuto-102\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eIn this tutorial, we will guide you through the \u003cstrong\u003estep by step construction\u003c/strong\u003e of a form. After that, you will be able to deploy your first qualification chatbot in no time!\u003c/p\u003e\n\u003cp\u003eFirst you need to create a Bot on the platform with the CKODA webchat, to understand the basics please refer to this tutorial: \u003ca href=\"https://helpdesk.clustaar.com/knowledge-base/tutoriel-101/\" target=\"_blank\" rel=\"noreferrer\"\u003eTutorial 101 : Create a Chatbot\u003c/a\u003e\u003c/p\u003e","title":"Tutorial 102"},{"content":"Sessions Et User Attributes # Content\nSessions and User attributes allow you to store \u0026amp; display information within the conversation.\nWhat’s the difference between Session and User attributes? #A Session is limited in time, and is usually defined by a Story. You can also extend a Session if you jump from one Story to another through Steps.\nOn the contrary, User Attributes persist beyond the lifetime of a story. They are useful to retain information about your user, such as his name or his email for example.\nMore about Stories\nDuring a Session, the chatbot is able to remember information — whether it is contained in an entity, or if you set it yourself.\nRefer to our previous article on how to use Entities:\nHow to use Entities\nSet Sessions to Retain Information about the Conversation #“Set Session” is an action your chatbot can take, it is in the same step menu as “message” or “image”.\nThis action will not send a message to the user. It will simply tell the chatbot to remember a certain piece of information or the user reached a certain point in the conversation.\nIn the example above, we asked in the previous step “Where do you live?”; the user answered “Paris”.\nWe can set the Session so the chatbot remembers the user lives in Paris.\nYou can also use Quick Replies (buttons) :\nSet User Attribute to Retain User Information #In the same way as “Set Session”, “User attribute” is an action that:\nyou can drag \u0026amp; drop into your step from the step menu. is silent: it won’t send any message to the user. In this example, we added a User attribute to retain the first name of the user talking to the bot. This means that, when user will come back and talk to the chatbot, the bot will remember his first name and then be able to skip this particular step.\nDisplay Session Values and User attributes #Basic use #This variable will be accessible in the next Step via text, email and set Session actions under the following syntax:\nSession Value:\n{{@session.City}} User attribute:\n{{@user.FirstName}} These variables also can be integrated in “normal text”:\n{{@user.FirstName}}, we are really glad you live in {{@session.City}}, such a great city! Last user message #The {{@message}} syntax allows you to get the content of the user’s last message. You can use it via text, email, set Session and User attribute.\nSupport question from user {{@user.FirstName}} from {{@session.City}}:{{@message}} Manage default value #If you are not sure if a value has been set, you can provide a default value in order to avoid an empty message.\nSession value:\nHello {{@session.City || \u0026#34;there\u0026#34;}} User attribute:\nHello {{@user.FirstName || \u0026#34;there\u0026#34;}} You can provide several default values; the first existing one will be used.\nHello {{@user.FirstName || @session.email || \u0026#34;there\u0026#34;}} Usage Examples #To remember if a user passed through one Step or another #For a quiz, you can set Sessions for the chatbot to remember if the user answered correctly to each question (Step: “false” or “correct”).\nTo retain information about the user #If your chatbot asks questions on a form, the first question could be:\n“Are you a man or a woman?”.\nThe chatbot could remember this information and:\nsend it to you in an email at the end of the form. don’t ask the question again to the user next time he will talk to the chatbot To save messages from the user along the conversation #Using the function {{@message}}, you can set a Session to retain specific messages along the conversation. This way, you will be able to reuse the message; for example, in an email to your customer service.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/what-are-sessions-and-user-attributes/","section":"","summary":"\u003ch1 id=\"sessions-et-user-attributes\" class=\"relative group\"\u003eSessions Et User Attributes \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#sessions-et-user-attributes\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eSessions and User attributes allow you to store \u0026amp; display information within the conversation.\u003c/p\u003e\n\u003ch2 id=\"whats-the-difference-between-session-and-user-attributes\" class=\"relative group\"\u003eWhat’s the difference between Session and User attributes? \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#whats-the-difference-between-session-and-user-attributes\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h2\u003e\u003cp\u003eA Session is limited in time, and is usually defined by a Story. You can also extend a Session if you jump from one Story to another through Steps.\u003cbr\u003e\nOn the contrary, User Attributes persist beyond the lifetime of a story. They are useful to retain information about your user, such as his name or his email for example.\u003c/p\u003e","title":"What are Sessions and User Attributes?"},{"content":"Stories Et Steps # In the CKODA app, a Story is a scenario. You will need it as soon as you want to go further than a simple question and answer chatbot.\nYou will then be able to create scenarios based on your users’ answers.\nThe Story is composed of Steps and links between those Steps, which we will present to you in a second.\n⚠️⚠️ Be careful to create your stories wisely. It is not possible to go directly into one specific step inside a story. Thus, everytime you think you might need to go directly to a certain step, create a separate story! ⚠️⚠️\nHow to Create a Story In the CKODA platform, a Story is the first thing you create. Begin by imagining a “Welcome” scenario.\nWhen the conversation starts, your chatbot can’t just answer: “Oh, hello”, and leave it at that. You need to offer something. Whether it’s a little quiz or a menu presenting the functionalities, you need to create a Story that will guide the user and on board him or her.\nIf this is your first story, just click on “Create your first story” in the “Stories” menu.\nIf you have already created a Story, click on “Create a new story”.\n2. Define Your Triggers\nThe first thing to do is define what will “trigger” your Story. It can be triggered by one or several Intents, or by a Step from another Story.\nAs usual, you can create a new Intent directly from here, and it will open the Intent creation tab.\nOnce you defined your triggers, you can start building your Story with Steps linked together.\n3. Create Steps\nWhen you click on a Step, you will be able to easily define what the bot will do. You have three important propositions :\nGeneral Action: What the bot will do when the step is triggered. Just drag and drop your actions in the order you want the bot to make them. Then: The conditions you will determine to link steps together. Fallback: The reaction of the bot if the user’s answer does not match any of the conditions (see below on the 2nd picture) you had imagined. The Fallback is situated in the “Then” tab. 4. Link Steps Together\nYou have two ways to approach the creation of a Story. You can either directly create all the steps, and then link them together. Or you can create a step, imagine the next one, and create it on the go.\nIt all really depends of what you have in mind when you start.\nYou have two ways to link steps together:\nFrom the “Then” tab of your step window. Directly in the step window for specific actions, like quick replies or cards. Conditions between your steps are defined by user responses.\nYou can use different functionalities:\nMatches intent: Here, you can use an Intent. Contains: If your user’s answer contains a certain word or expression. Match Regex: set up a “custom condition”, more info here. Matches exactly: If you are sure of what your users will answer, like “yes” or “no”. “\u0026lt;” “\u0026lt;=” “\u0026gt;” “\u0026gt;=”: Use those conditions with numbers(ex: “5\u0026gt;”) Is set: This one is special. It’s used if you choose to connect two steps depending on a session value. Is number: If your user’s answer is a number. More about Sessions\nIf you use “Matches intent….”, you must link the condition to an Intent. As usual, you can create an Intent directly from your step.\nSpecial Case: Quick Replies for CKODA Webchat and FB Messenger\nEach CKODA integration allows you to use specific actions. For CKODA Webchat and FB Messenger, you can create Quick Replies.\nYou can directly link the “buttons” from the step window , so you don’t have to go through the whole “Then” process. You can choose “Create a step” or “Create a new story” from here.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/stories-et-steps/","section":"","summary":"\u003ch1 id=\"stories-et-steps\" class=\"relative group\"\u003eStories Et Steps \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#stories-et-steps\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003eIn the CKODA app, a Story is a scenario. You will need it as soon as you want to go further than a simple question and answer chatbot.\u003c/p\u003e\n\u003cp\u003eYou will then be able to create scenarios based on your users’ answers.\u003c/p\u003e\n\u003cp\u003eThe Story is composed of Steps and links between those Steps, which we will present to you in a second.\u003c/p\u003e","title":"What are Stories and Steps?"},{"content":"Quest Ce Quun Fallback # Content\nThe Fallback is essential to a working chatbot. It is what happens when the chatbot doesn’t understand, which can happen sometimes — even with the amazing CKODA NLP 🙂\nIn this article, we will explain to you the different levels of Fallbacks in the CKODA platform, and how to create and use them.\nThere are three levels of Fallbacks:\nThe General Fallback Message The Story Fallback The Step Fallback 1. The General Fallback #This is the classic Fallback. It will answer when you are not in the middle of a Story.\nYou create it like a Story, and it can be composed of several Steps.\nMore about Stories\n2. The Story Fallback #If your user is in a Story and you don’t want him or her to get out of it (or if the chatbot does not understand something), you can set a specific Fallback for the Story.\nIt is created like a Step.\nMore about Steps\n3. The Step Fallback #To complete the three levels of a Fallback, we have added a Fallback at the Step level. This allows you to make sure the user gives the information you need at a given moment. For example, if you need an email address to go forward with a scenario and the user doesn’t give it, your chatbot will be able to politely ask again (or not) — you decide 🙂\nYou can set it in the “Then…” section at the bottom of your Step, and create it like a step with drag and drop actions.\nChatbot Flexibility #Sometimes you may need the chatbot to get out of the Step if the user’s response does not match anything you had imagined. We have added a button so you can allow the chatbot to match other Intents outside the current Story (or not) — you decide.\nIf you drag\u0026amp;drop the Text action the “Fallback max attempts” placeholder will appear, set it as you like. It gives you the possibility to decide how many times you want your fallback message to appear.\nWas this article helpful? #Yes No\nNeed Support?\nCan’t find the answer you’re looking for? Don’t worry we’re here to help!\nMore help\n","date":null,"permalink":"https://helpdesk.ckoda.ai/en/articles/what-is-a-fallback/","section":"","summary":"\u003ch1 id=\"quest-ce-quun-fallback\" class=\"relative group\"\u003eQuest Ce Quun Fallback \u003cspan class=\"absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100\"\u003e\u003ca class=\"group-hover:text-primary-300 dark:group-hover:text-neutral-700\" style=\"text-decoration-line: none !important;\" href=\"#quest-ce-quun-fallback\" aria-label=\"Anchor\"\u003e#\u003c/a\u003e\u003c/span\u003e\u003c/h1\u003e\u003chr\u003e\n\u003cp\u003e\u003cstrong\u003eContent\u003c/strong\u003e\u003c/p\u003e\n\u003cp\u003eThe Fallback is essential to a working chatbot. It is what happens when the chatbot doesn’t understand, which can happen sometimes — even with the amazing CKODA NLP 🙂\u003c/p\u003e\n\u003cp\u003eIn this article, we will explain to you the different levels of Fallbacks in the CKODA platform, and how to create and use them.\u003c/p\u003e\n\u003cp\u003eThere are three levels of Fallbacks:\u003c/p\u003e","title":"What is a Fallback?"}]