JSPM

botfactory-conversation

3.5.1-d86aa61c-5f0f-4b5e-9f18-059465f9fcc0
    • ESM via JSPM
    • ES Module Entrypoint
    • Export Map
    • Keywords
    • License
    • Repository URL
    • TypeScript Types
    • README
    • Created
    • Published
    • Downloads 16
    • Score
      100M100P100Q76836F
    • License ISC

    Package Exports

    • botfactory-conversation
    • botfactory-conversation/dist/bundle.js

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (botfactory-conversation) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    BotFactory conversation

    Component to interact with Bot Factory bots from Senior X Platform.

    This component is started in any website, you only need to create a HTML element and paste de script bellow changing the variables. If needed, change de optional params.

    Use as a lib (NPM)

    Currently, to use as library format you need a Font Awesome 5 Pro license added to your project.

    In this format you will always need to manually update this package on your project. In the package.json file, add ~ before the version number to auto-increment that inside of the same major. Eg.: ~3.0.2

    Install the production dependency: npm i botfactory-conversation

    Add in your HTML:

    Use any identifier.

    <div id="botfactory-container"></div>

    Typescript

    import { BotFactoryConversation } from 'botfactory-conversation'
    
    const config = {
      appKey: '1at2b34ka56-789012-4616-141515fsa-fb3a315k277f7b',
      element: document.getElementById('botfactory-container'),
      restUrl: 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/'
    }
    const BotFactory = (<any>window).BotFactory as BotFactoryConversation
    BotFactory.init(config)

    Javascript

    Example in ES7 syntax. To ES5 use require()

    import { BotFactoryConversation } from 'botfactory-conversation'
    
    const config = {
      appKey: '1at2b34ka56-789012-4616-141515fsa-fb3a315k277f7b',
      element: document.getElementById('botfactory-container'),
      restUrl: 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/'
    }
    const BotFactory = (<any>window).BotFactory
    BotFactory.init(config)

    Use from CDN

    <script>
      ;(function (d, s, id) {
        var js,
          fjs = d.getElementsByTagName(s)[0]
        if (d.getElementById(id)) {
          return
        }
        js = d.createElement(s)
        js.id = id
        js.src =
          'https://cdn.tecnologia.senior.com.br/platform/botfactory/conversation/production/bundle.js'
        fjs.parentNode.insertBefore(js, fjs)
      })(document, 'script', 'botfactory-sdk')
      ;(function () {
        window.onload = function () {
          window.BotFactory.init({
            appKey: '1at2b34ka56-789012-4616-141515fsa-fb3a315k277f7b',
            restUrl: 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/',
            autoOpen: true
          })
        }
      })()
    </script>

    Development

    To generate and make available a production bundle (bundle.js), use the following commands:

    webpack
    node server.js

    API

    Lifecycle methods

    Method Description Declaration
    init Starts the conversation component init(config, callback?): void
    destroy Close and destroy conversation component component destroy(): void

    init()

    Pass some properties to the conversation component on your page. Inside the script tag, use:

      window.BotFactory.init({
        appKey: 'your-app-key',
        autoOpen: true,
        width: 500,
        height: 900
        ...
      });
    Property Type Required Default value Description
    appKey String Yes undefined Represents the key from the bot service.
    restUrl String Yes https://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/ Environment address to use services. Even if there's a fallback value (padrão), it's fundamental to supply that.
    username String No undefined A value to identify the user who talks to the bot.
    autoOpen Boolean No false If true, does the conversation box auto open and starts the conversation
    mode 'user' | 'monitor' | 'readonly' No user Toggle between conversation modes: conversation or monitoring (Monitoring mode is only available to administrators.
    development Boolean No false When in development mode, allow termination conversation with a bot, otherwise, it's only available to minimize de conversation box.
    width Number No 400 Measures in pixels which indicate the width from conversation box.
    height Number No 600 Measures in pixels which indicate the height from conversation box.
    fullScreen Boolean No false Conversation box in full-screen mode.
    showFullScreenButton Boolean No true Allow users to toggle between full-screen mode or window.