botbook/book/chapter-07-gbot-reference.md

# General Bots Administration

## Instance custom params

## Commands

General Bot can be controlled by the same chat window people talk to, so
here is a list of admin commands related to deploying .gb* files.

| Command         | Description                                                                                                     |
|-----------------|-----------------------------------------------------------------------------------------------------------------|
| deployPackage   | Deploy a KB package. Usage **deployPackage** [package-name]. Then, you need to run rebuildIndex.                |
| undeployPackage | Undeploy a KB. Usage **undeployPackage** [package-name].                                                        |
| redeployPackage | Undeploy and then deploys the KB. Usage **redeployPackage** [package-name]. Then, you need to run rebuildIndex. |
| setupSecurity   | Setup connection to user directories.                                                                           |
| syncBotServer   | Updates the cloud with the latest version from GitHub BotServer repository.                                     |
| rebuildIndex    | Rebuild Azure Search indexes, must be run after **deployPackage** or **redeployPackage**. | Now it is called automatically |
| /publish [package]  | Deploy the package to the bot storage. When ommited, the command will publish the package named <botId>.gbkb by default. |

# Config.xlsx (.gbot) Configuration
  
| Name                        | Description|
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Admin Notify E-mail         | E-mail used to notify administrators. |
| Avatar Logo                 | Bot logo URL.                                                                                      |
| Can Publish                 | Comma separeted list of mobile numbers that can publish directly. |
| Description                 | Description of the Bot.                                                                            |
| Enable Audio Hearing        | TRUE if the Bot can hear.                                                                          |
| Enable Audio Talking        | TRUE if the Bot can talk.                                                                          |
| Enable Spelling Checker     | TRUE if everything input by user should be spell checked.                                          |
| Enable Worldwide Translator | TRUE if the Bot should be polyglot.                                                                |
| Default User Language       | Language (eg.: en or pt) that user will be presented by the Bot.                                   |
| Default Content Language    | Language (eg.: en or pt) that content files in .gbkb, .gbdialog and so on are written.             |
| Language Detector           | TRUE if Bot should get the language automatically.                                                 |
| NLP Score                   | Number between 0 and 1 that will be used to classify text to use NLP neural network. |
| Search Score                | Number between 0 and 1 that will be used to consider Full Text Search as content retrieval method. |
| Transfer To                 | Comma separeted list of mobile numbers that Bot will use to tranfer chats from WhatsApp.           |
| WhatsApp Admins             | Comma separeted list of mobile numbers that will be admin. |
| Feedback Improve.Message    | Message to user when the Bot was unable to find something. |
| Keep Text                   | Comma separeted list of words that should be keep intact between Bot understanding process.                                                                                                                                                  |
| Start Dialog                | Name of .docx (without the Extension) that will be used as Dialog entry point.                                                                                                                                             |
| HelloGoodX                  | TRUE if Bot should give hello. |
| XRM Key                     | String key of HubSpot (currently) API. |
| WhatsApp Group Name         | WhatsApp group name that this Bot belongs to. | 
| WhatsApp Group Shortcuts |   Space separeted list of triggers in text that will active Bot in groups.|
  
  
## Enviroment Variables Reference

| Name                   | Sample Value                                     | Description |
|------------------------|--------------------------------------------------|-------------|
| ADDITIONAL_DEPLOY_PATH | D:\data\gbai                                     | Deploy folder to look for packages (Just one folder). 
| ADMIN_PASS             | E732+!#xJ3a_*!                                   | Administration password for the conversational interface.
| CLOUD_SUBSCRIPTIONID   | 622e5037-f7f1-49f6-a9c4-28babbb0fs               | Cloud subscription ID used to deploy new bots.
| CLOUD_LOCATION         | westus                                           | Cloud location used to deploy new bots.
| CLOUD_GROUP            | newassistant                                     | Cloud group used to deploy new bots.
| CLOUD_USERNAME         | someone@domain                                   | Cloud username used to deploy new bots.
| CLOUD_PASSWORD         | <use a password generator>                       | Cloud password used to deploy new bots.
| MARKETPLACE_ID         | 9c90ff1c3-101b-4f0d-85cd-4bada2226fe3            | Martplace identifier associated to the boot bot.
| MARKETPLACE_SECRET     | nzrNUUG6214%raqzYWQ8(+%                          | Martplace password associated to the boot bot.
| STORAGE_DIALECT        | mssql                                            | The bot database dialect configuration value. Can be MSSQL or SQLITE.
| STORAGE_SERVER         | newassistant-storage-server.database.windows.net | The bot database server name configuration value.
| STORAGE_NAME           | newassistant-storage                             | The bot database name configuration value.
| STORAGE_USERNAME       | sahaaksfqiehke                                   | The bot database security username configuration value.
| STORAGE_PASSWORD       | <use a password generator>                       | The bot database security password configuration value.
| STORAGE_SYNC           | true                                             | If the bot server should sync database before running.
| PRIVACY_STORE_MESSAGES | true                                             | If the bot server should store message logs in the database

## How to

### Move to production (Azure)

* Update bot endpoint;

## Bot Analytics

## Cloud Internals