Set up a bot scenario

Want to use iAdvize smart bots in your conversational strategy? Here is how to configure the steps in the “Scenario” section using different types of cards.


1. Configure the scenario of your bot


1.1 Select your type of message




  • Rich Message* card creation: Send a message without waiting for an answer in return. It can be text or more visual content.
    • This card also allows you to add a hypertext link by clicking on the icon new-chatbot-builder-carte-04-FR.png
      • You must enter a message before validating the card, otherwise, the scenario will not be saved.

NB: Rich contents* include attached videos, images, carousel
    • Next step : 3 actions are proposed after each Message :
      • Continue to step
      • Transfert to a routing rule (with an alternative to transfer option )
      • End conversation



Option: For each transfer that your bot will do, you will be able to configure an alternative to transfer in case there is no availability. The alternative action can be: a transfer, forwarding to another card or closing the conversation. 



1.2 Open-ended question card

Ask a question where the user will be able to write the answer

  • Ask your question in the "what do you want to ask" section.
  • The bot will wait for the visitor's response before proceeding to the next stage of the scenario and will record the data collected temporarily, depending on the name or the email you have defined here.
  • It will be possible to re-use this data in the successive stages of the scenario by calling it via the tag {data_name}.


1.3 Multiple choices question

Ask a question where the user will be able to choose between different options.

  • Add the question
  • Configure your multiple choices and actions
  • Add choices with the button “+ Add a choice”
  • You can delete a choice with the trash icon


1.4 NLU Question

Ask a question and detect the user intent.

  • Add an open question
  • Chose an intent
  • Define an alternative in case of detection failure. This is triggered if the visitor’s answer is not understood by the bot. Want to know more about how intents work? Please read this article: Intents Manager



1.5 Connection card

Send or request information from your API.

  • Choose an API connection and its version
  • Possible alternative: the alternative in case of API request failure action is triggered if the API request fails
    Do you want to know more about how the API connection works?
    Click on this article:
    Connect your bots to your apps


You can edit a card by clicking on new-chatbot-builder-editcard-05-EN.png, on the top right side of the card.

You will be able to 1) rename the card, 2) move up or 3) move down, 4) duplicate it or 5) delete it.


    • 1) Rename card: you can rename the scenario card in order to have a simpler reading of your bot scenario. This also will help you in the Automation report when you will analyse in detail the bot scenario.
    • 2) Move up: move the card up in the scenario creation. This will not affect the execution order of your bot scenario
    • 3) Move down: move the card down in the scenario creation. This will not affect the execution order of your bot scenario
    • 4) Duplicate: Duplicate a card with all the parameters, including the list of intent if you are duplicating an “Intent detection question” card
    • 5) Delete: delete the selected card from your scenario


2. Creation and use of variables

You can give names to variables qualified by open questions. This variable name can then be used in a future scenario step for rich messages.




There are 4 types of variables that can be automatically added to the visitor’s profile using bots :

To do so, you have to name the variables exactly like that :

  • Firstname => “visitor_firstname”
  • Lastname => “visitor_lastname”
  • Email => “visitor_email”
  • Phone number => “visitor_phone”


NB: to re-use the data of a variable in the successive stages of the scenario, you have to call it via the tag {data_name}


3. Verify that you don’t have configuration errors 

Check the error panel on the top right side.


If you have errors displayed, you can solve them by clicking on each error

Then, save your bot by using the Save button.