Connectors Reference

LiveTiles Bots

Let people focus on the work that matters most. Automate mundane, repetitive tasks. Create personal, team, enterprise and external assistants with a range of abilities. This connector allows LiveTiles Bots customers to easily connect a flow to their bot, in order to allow users to trigger the flow through a Conversational User Interface.

 

Status: Production

Tier: Premium

Version: v1

 

Actions:

Name

Summary

GetSchema (string bot, string key)

Get Flow Ability Schema

ListFlows (string bot)

List Flows

ListBots ()

List Bots

PromptString (string resumptionToken, PromptStringParameterBody body)

Prompt String

PromptNumber (string resumptionToken, PromptNumberParameterBody body)

Prompt Number

PromptForm (string resumptionToken, PromptFormParameterBody body)

Prompt Form

PromptBoolean (string resumptionToken, PromptBooleanParameterBody body)

Prompt Boolean

PromptChoice (string resumptionToken, PromptChoiceParameterBody body)

Prompt Choice

PromptFile (string resumptionToken, PromptFileParameterBody body)

Prompt File

PostMessage (string resumptionToken, PostMessageParameterBody body)

Post Message

FlowComplete (string resumptionToken)

Flow Complete

 

Triggers:

Name

Summary

IntentRecognized (IntentRecognizedParameterSubscription Subscription)

When an intent is recognized

 

Objects:

Name

Summary

GetSchemaResponse

 

IntentRecognizedParameterSubscription

 

ListBotsResponseItem

 

ListFlowsResponseItem

 

PostMessageParameterBody

 

PromptBooleanParameterBody

 

PromptChoiceParameterBody

 

PromptFileParameterBody

 

PromptFormParameterBody

 

PromptNumberParameterBody

 

PromptStringParameterBody

 

 

Actions:

GetSchema

Summary: Get Flow Ability Schema

Description: Returns the JSON schema for the Flow ability in the Bot Designer.

 

Syntax:

LiveTilesBots.GetSchema (string bot, string key)

 

Parameters:

Name

Type

Summary

Required

Related Action

bot

string(uuid)

(Bot)

The bot to list abilities

True

key

string

(Subscription Key)

The subscription key to the flow ability

True

 

Returns:

          Type:GetSchemaResponse

 

ListFlows

Summary: List Flows

Description: Returns a list of Flow Abilities available on this bot.

 

Syntax:

LiveTilesBots.ListFlows (string bot)

 

Parameters:

Name

Type

Summary

Required

Related Action

bot

string(uuid)

(Bot)

The bot to list abilities

True

 

Returns:

          Type:array of (ListFlowsResponseItem)

 

ListBots

Summary: List Bots

Description: Returns a list of available bots.

 

Syntax:

LiveTilesBots.ListBots ()

 

Returns:

          Type:array of (ListBotsResponseItem)

 

PromptString

Summary: Prompt String

Description: Prompts the bot user for a string input.

 

Syntax:

LiveTilesBots.PromptString (string resumptionToken, PromptStringParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptStringParameterBody

 

 

True

 

Returns:

 

PromptNumber

Summary: Prompt Number

Description: Prompts the bot user for a number input.

 

Syntax:

LiveTilesBots.PromptNumber (string resumptionToken, PromptNumberParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptNumberParameterBody

 

 

True

 

Returns:

 

PromptForm

Summary: Prompt Form

Description: Prompts the bot user for a form input.

 

Syntax:

LiveTilesBots.PromptForm (string resumptionToken, PromptFormParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptFormParameterBody

 

 

True

 

Returns:

 

PromptBoolean

Summary: Prompt Boolean

Description: Prompts the bot user for a bool value.

 

Syntax:

LiveTilesBots.PromptBoolean (string resumptionToken, PromptBooleanParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptBooleanParameterBody

 

 

True

 

Returns:

 

PromptChoice

Summary: Prompt Choice

Description: Prompts the bot user with a choice variable.

 

Syntax:

LiveTilesBots.PromptChoice (string resumptionToken, PromptChoiceParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptChoiceParameterBody

 

 

True

 

Returns:

 

PromptFile

Summary: Prompt File

Description: Prompts the bot user for a file variable.

 

Syntax:

LiveTilesBots.PromptFile (string resumptionToken, PromptFileParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PromptFileParameterBody

 

 

True

 

Returns:

 

PostMessage

Summary: Post Message

Description: Posts a message back to the bot user.

 

Syntax:

LiveTilesBots.PostMessage (string resumptionToken, PostMessageParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

body

PostMessageParameterBody

 

 

True

 

Returns:

 

FlowComplete

Summary: Flow Complete

Description: Finish the current flow and allow the user to ask something else

 

Syntax:

LiveTilesBots.FlowComplete (string resumptionToken)

 

Parameters:

Name

Type

Summary

Required

Related Action

resumptionToken

string

(Conversation Resumption Token)

The token used to navigate back to the correct bot conversation.

True

 

Returns:

 

Triggers:

Trigger IntentRecognized

Summary: When an intent is recognized

Description: This operation triggers when the related intent is recognized in the bot's LUIS model.

 

Syntax:

LiveTilesBots.IntentRecognized (IntentRecognizedParameterSubscription Subscription)

 

Parameters:

Name

Type

Summary

Required

Related Action

Subscription

IntentRecognizedParameterSubscription

 

 

True

 

Returns:

 


 

GetSchemaResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

IntentRecognizedParameterSubscription

Summary:

Description:

 

          Properties:

Name

Type

Summary

bot

string

Bot

 

key

string

Flow

 

callbackUri

string

 

 


 

ListBotsResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

 

 

id

string(uuid)

 

 


 

ListFlowsResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

 

 

key

string

 

 


 

PostMessageParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

message

string

 

The Message back to the user.

attachments

array of (AttachmentsItem)

 

 

 

AttachmentsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

contentType

string

 

The content type of the message back to the user.

content

Content

 

 

contentUrl

string(uri)

 

The URL of the message back to the user.

 

Content

Summary:

Description:

 

          Properties:

Name

Type

Summary

 


 

PromptBooleanParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

The user prompt for this value.

callbackUri

string

 

 


 

PromptChoiceParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

The user prompt for this variable.

options

array of (OptionsItem)

 

 

callbackUri

string

 

 

 

OptionsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

display

string

 

The display value for this option.

value

string

 

The value of this option.

 


 

PromptFileParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

The user prompt for this field.

contentTypes

array of (string)

 

 

callbackUri

string

 

 


 

PromptFormParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

The user prompt for this field.

callbackUri

string

 

 

title

string

 

Field title.

formFields

array of (FormFieldsItem)

 

 

 

FormFieldsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

fieldType

string

 

The type of the field.  Values: [Text, Number, Choice, DateTime, Boolean]

name

string

 

Field name.

label

string

 

The display name of the field.

isRequired

boolean

 

Is this a mandatory field?

isMultiline

boolean

 

Allow multiple lines of text.

minLength

number

 

Minimum field length.

maxLength

number

 

Maximum field length.

isMultiSelect

boolean

 

Allow multiple choices to be selected.

choices

array of (ChoicesItem)

 

 

 

ChoicesItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

display

string

 

 

value

string

 

 

 


 

PromptNumberParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

prompt

callbackUri

string

 

 


 

PromptStringParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

prompt

string

 

prompt

callbackUri

string