botbook/book/chapter-05-gbdialog-reference.md
2020-08-20 08:57:18 -03:00

3.3 KiB

.gbdialog Reference

Using Conversational BASIC

The following file types are loaded from a .gbdialog package: .vbs, .vb, .basic and .bas.

General Bots BASIC reference

Instruction / Usage Description
HEAR variable Hears something from the person into a variable for later use.
confirm variable (Comming soon) Waits for confirmation like 'yes', 'y', 'yeah' and return true or false
TALK message Talk the specified message to the person.
GENERATE A PASSWORD Creates a new password into the system variable password for later use.
CREATE A BOT FARM USING params Deploys a new bot farm to the cloud.
WAIT seconds Wait a number of seconds before continuing the conversation.
variable = GET CELL "file.xlsx", "A1:A1" (Comming soon) Gets the value of the cell specified in range address
SET CELL "file.xlsx", "A1:A1", 42 (Comming soon) Gets the value of the cell specified in range address
variable = GET "https://server/query" (Comming soon) Gets the value of the cell specified in range address
POST "https://", data (Comming soon) Gets the value of the cell specified in range address
wait seconds (Comming soon) Wait a number of seconds before continuing the conversation.

How To

Using POST data

You can use POST passing a variable as the second param in the POST call. The example bellow shows how to call POST using an object that is returned from the Excel file.

Given the Excel file with the following contents and saved to the standard .gbdialog folder:

tokenId token comment
29187 AAMkAGEzMWIxMmI5 Prod1
98739 jZWYtNGQ3My1iNmM Prod2

The Word bellow will invoke POST call by using line contents as object attributes:

obj = FIND "dados.xlsx", "tokenId=29187"
POST "https://server/query", obj
' obj here is {tokenId: 29187, token: "AAMkAGEzMWIxMmI5", comment: "Prod1"}
  • OAuth2 is being implemented and no modification to previous calls will be necessary as this configuration will be an administrative conversation to get the token setup.

Generate a password for the person



talk "Let's generate a very dificult to guess password for the new bot:"
generate a password
talk "Your password is *" + password + "*. Keep it on a safe place only acessible to you."


Get the list of cloud subscriptions


hear one of subscriptions with email, password into subscriptionId
talk "The subscription selected was: " + subscriptionId