Create a New Crawler Session

Start a crawler session to begin mapping conversation all flows in your chatbot. This article guides you through the setup process.

1. Navigate Using the Left Pane: On the left navigation pane, head to Botium Tools & Settings > Test Data Wizard > Crawler Wizard.
2. Project Name: Choose an appropriate name and enter it as the project name.
3. Namespace: This step is optional
   Tip: Botium Namespaces allow you to group together Test Projects, Test Results, Test Sets, Chatbots and Crawler Projects under one common namespace. This is particularly useful for testing multiple chatbot implementations across different brands or product offerings that your business might have.
4. Connect to Chatbot: Select the Bot you wish to run the crawler session on. The dropdown menu provides a list of all the bots you have connected to your Botium account.
5. Conversation Entrypoints: This step is optional - These are the messages that the crawler uses to start the conversations. By default the crawler is going to start with hello and help entry points.
   Tip: If the chatbot has automatic welcome messages, those will be used as entry points unless you specify more with the Number of Welcome Messages parameter in the next step.

   Note: For each start message that you include in your Crawler Project, parallel jobs will be started with each message to begin the crawl.
6. Number of Welcome Messages: This step is optional - Some chatbots initiate the conversation without user interaction. In this case, you need to specify how many welcome messages will be sent by the bot.
   Note: If you don’t have a start message, the crawler will try to find quick replies and buttons in the welcome messages and start the conversations from there.
7. Create Project: Click Create Crawler Project to build the project. You will then be taken to the Execution tab
   
   
8. Execution: Next you will be taken to the Execution tab where you can verify your entries and set further Advanced criteria before running the crawler. All of these settings are optional.
   Tip: At this point it is considered best practice to set the 'Wait for Chatbot Messages' response time to a minimum of 500ms to ensure that you capture your bots responses successfully.
   • Maximum Conversation Depth: This is the depth of the conversation in the conversation flow . This is set to five by default.(One depth is a user-bot message pair.)
   • Generate Utterances Lists: Botium will generate Utterance Lists for each conversation step (recommended)
   • Merge Utterance Lists and User Examples: All text messages are saved as utterances. The crawler can recognize non-unique utterances and merge them into a single utterance.
   • Exit Criteria: If the text or payload of any quick reply or button matches any of the exit criteria, the conversation is stopped and marked as successfully ended.
   • Ignore Buttons: Ignore any buttons where the text or payload match any of the specified ignore button expressions.
   • Botium Agent: If you have Botium Agents installed and connected to Botium, you can select a specific agent here on which to run the crawler jobs.
9. Save: To save your crawler configuration, click the SAVE button.
10. Start First Crawler Session: To begin crawling, first click the OVERVIEW button at the top of the page and then click the START FIRST CRAWLER SESSION button.
    
    
    Note: The crawler will now begin crawling through your bot. While the crawler is running, it will be indicated in the top left corner of the screen. Each Convo and utterance will appear underneath as they become available.