Web Bot Attributes

It is easy to customize the looks and functionality of the Web Bot, by modifying the values of the attributes in the HTML snippet. Let’s start with a default snippet generated when deploying Web Bot, and see how we can customize it.

<div id="smartbotstyles"></div><div id="smartbot360" picture="true" hidewindowmobile="true" hidewindow="false" autologoff="true" autostart="true" botkey="PHQ9" bot-title="SMARTBOT360"><script type="text/javascript" src="https://demo.smartbot360.com/react/static/js/main.js"></script>

An attribute has the form name=”value”, e.g., picture="true".

Here is the list of attributes:

  • botkey

    • api key for the bot; don’t change it

  • bottitle

    • bot title, displayed at the top of the Web Bot window

  • hidewindow

    • hides the bot when page is initially loaded if “true”

  • hidewindowmobile

    • hides the bot on load (for mobile only)

  • autologoff

    • logs out and closes if no messages are sent or received in 15 minutes; needed for HIPAA compliance

  • autostart

    • bot sends first message without the user sending any message

  • picture

    • allow user to send picture or other attachment

  • botwidth

    • percentage of browser's window width. example botwidth="20%", or botwidth="150px" for fixed width

  • isfullbotheight

    • set Web Bot window to full height, example isfullbotheight="true"

  • chaticon

    • use custom chat icon (icon to click to open window), example chaticon="https://placehold.it/image.png"

  • chatavatar

    • use custom chat avatar in messaging window (avatar that responds to messages), example chatavatar="https://placehold.it/icon.png"

  • embeddable

    • embed bot in Web page, instead of having it in bottom right corner. Example: embeddable="true"

  • customcolor

    • change color of messages and quickreplies. Example customcolor="#ffbbaa"

  • removelink

    • remove the smartbot360.com link located at the bottom of the Web Bot, e.g., removelink="true"

  • botheight

    • percentage of the browser's window height. example botheight="70%"

  • agentstatus

    • show agent status (offline or online) by setting agentstatus = "boolean". Show the estimated time for an agent to take over the bot conversation by setting agentstatus = "estimatedTime". Example agentstatus="boolean" or agentstatus="estimatedTime" or agentstatus="off". The formula for estimatedTime is (#onlineusers+1)*timeperuser/#onlineagents

  • timeperuser

    • set estimated agent time in seconds needed per user. Example timeperuser="70"

  • talktoagent

    • displays on the web-bot a "TALK TO AGENT" button, which inserts user to the agent queue. Example: talktoagent="true"

  • fontsize

    • change the font size of the web-bot. The available sizes are "small", "medium", "large", "x-large". Example: fontsize="large"