AtBot Logic

AtBot Logic, is a business bot that services the Microsoft cloud.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

AtBot Logic is a bot in Teams that you train using Flow.

Here are some tips for using the AtBot Logic Flow Connector:

  • Each flow created that uses the AtBot Logic trigger will train the AtBot Logic bot to run that flow in Teams. This is called a skill in AtBot Logic.
  • You log into AtBot Logic using your Office 365 Azure AD credentials.
  • You will need to log into the same account in Flow and the AtBot Logic bot in Teams in order to load the proper skills.
  • The AtBot Logic actions can only be used in a flow that was triggered by the AtBot Logic trigger. There is a special property called ReplyActivity that comes from the trigger to allow the AtBot Logic bot to maintain state with flow.
  • Support for engaging AtBot Logic from PowerApps is not supported yet, but is coming soon!
  • For more information about AtBot Logic visit https://atbot.io/

By signing up for AtBot Logic, you agree to H3 terms of service and privacy statement.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Delete from bot memory

This operation is used to remove a piece of information from memory in the bot.

Generate Adaptive Card

This operation is used to a generate an adaptive card to be used later to display a list or carousel of cards.

Get adaptive card response from User

This operation is used to ask the user for input via adaptive card.

Get Bot Memory Items by Type

Get all Bot Memory Items by Type.

Get choice list response from User

This operation is used to ask the user for choice list input.

Get choice response from User

This operation is used to ask the user for choice input.

Get datetime response from User

This operation is used to ask the user for datetime input.

Get intent vector response from User

This operation is used to ask the user for NLP input.

Get memory response from User

This operation is used to ask the user for bot memory input.

Get people response from User

This operation is used to ask the user for people picker input.

Get response from User

This operation is used to ask the user for input.

Save to bot memory

This operation is used to save a piece of information to memory in the bot.

Send Adaptive Card reply

This operation is used to a send an adaptive card reply to the activity that triggered the flow.

Send Adaptive Card Set reply

This operation is used to a send an adaptive card set reply to the activity that triggered the flow. The set can be in either List or Carousel form.

Send reply

This operation is used to a send a reply to the activity that triggered the flow.

Start a new group conversation

This operation is used to start a new group conversation in a channel.

Start a new private conversation

This operation is used to start a new private conversation with a user.

Update an adaptive card sent to a tab

This operation is used to update a card sent to a tab.

Delete from bot memory

This operation is used to remove a piece of information from memory in the bot.

Parameters

Name Key Required Type Description
User Principal Name
user True string

The user to save the memory item against.

Memory Type
type True string

The type of memory.

Value
value True string

The memory item value.

Returns

Generate Adaptive Card

This operation is used to a generate an adaptive card to be used later to display a list or carousel of cards.

Parameters

Name Key Required Type Description
Selected Adaptive Card
selectedCard True string

Select the adaptive card.

content
content dynamic

Select the adaptive card.

Get adaptive card response from User

This operation is used to ask the user for input via adaptive card.

Parameters

Name Key Required Type Description
Selected Adaptive Card
selectedCard True string

Select the adaptive card.

webHook
webHook dynamic

Select the adaptive card.

Returns

The outputs of this operation are dynamic.

Get Bot Memory Items by Type

Get all Bot Memory Items by Type.

Parameters

Name Key Required Type Description
User Principal Name.
user True string

Provide the User Principal Name.

Memory Type
type True string

Provide the type of memory to list.

Returns

Get choice list response from User

This operation is used to ask the user for choice list input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for choice list input.

Icon URL
icon string

Enter an absolute url to an icon to display for each choice item.

Message
message True string

Enter the message to send to the user.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

Get choice response from User

This operation is used to ask the user for choice input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for choice input.

Message
message True string

Enter the message to send to the user.

Choice Values
choices True string

Provide each choice on a separate line.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

Get datetime response from User

This operation is used to ask the user for datetime input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for datetime input.

Date Scope
dateScope True string

Select the scope of the date value.

Message
message True string

Enter the message to send to the user.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

Get intent vector response from User

This operation is used to ask the user for NLP input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for NLP input.

Message
message True string

Enter the message to send to the user.

LUIS Intent Vector
intentVector True string

Pick your LUIS Intent Vector.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

The outputs of this operation are dynamic.

Get memory response from User

This operation is used to ask the user for bot memory input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for bot memory input.

Message
message True string

Enter the message to send to the user.

Memory Type
type True string

Provide the type of memory to list.

Reply Activity
activityJson True string

Reply Activity from the bot.

Icon URL
icon string

Enter an absolute url to an icon to display for each choice item.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Target User
targetUserMemory string

Optionally specify the UPN of the user the bot should pull memory items from. If left blank, it will pull memory items from the user that initiated the skill. In the case of a group conversation started from the bot, it will pull memory items from the user authenticated in Flow.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

Get people response from User

This operation is used to ask the user for people picker input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for people picker input.

Message
message True string

Enter the message to send to the user.

Mode
mode True string

Ask the user to select one or many people.

Search String
searchstr string

Optionally provide a starting search string.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Allow Branching
allowBranching string

Allow the user to trigger branching skills before providing a response.

Returns

Get response from User

This operation is used to ask the user for input.

Parameters

Name Key Required Type Description
filters
filters string

This operation is used to ask the user for input.

Message
message True string

Enter the message to send to the user.

Reply Activity
activityJson True string

Reply Activity from the bot.

Accept Response From
acceptResponseFrom string

Accept response from specific user or any user.

Returns

Save to bot memory

This operation is used to save a piece of information to memory in the bot.

Parameters

Name Key Required Type Description
User Principal Name
user True string

The user to save the memory item against.

Memory Type
type True string

The type of memory.

Title
title True string

The memory item title.

Value
value True string

The memory item value.

Returns

Send Adaptive Card reply

This operation is used to a send an adaptive card reply to the activity that triggered the flow.

Parameters

Name Key Required Type Description
Selected Adaptive Card
selectedCard True string

Select the adaptive card.

content
content dynamic

Select the adaptive card.

Returns

Send Adaptive Card Set reply

This operation is used to a send an adaptive card set reply to the activity that triggered the flow. The set can be in either List or Carousel form.

Parameters

Name Key Required Type Description
Display Style
displayStyle string

Select the display style to use.

Reply Activity
activityJson string

Reply Activity from the bot.

Show In Tab
showInTab boolean

Display this card set in a tab instead of inline chat.

Tab Button Label
deepLinkButtonLabel string

Button label for displaying in a tab.

Tab Button Message
deepLinkMessage string

Message to send with the button when displaying in a tab.

Returns

Send reply

This operation is used to a send a reply to the activity that triggered the flow.

Parameters

Name Key Required Type Description
Reply Text
message True string

The message to reply to the user with.

Reply Activity
activityJson True string

Reply Activity from the bot

Custom Channel Data
customChannelDataJson string

Custom Channel Data Json for the message (only supported in Direct Line)

Signal Response JSON
signalResponse string

Signal Response JSON string

Returns

Start a new group conversation

This operation is used to start a new group conversation in a channel.

Parameters

Name Key Required Type Description
Target Bot
EnterpriseBot True string

Select the bot.

Channel Name
channelId True string

The channel to post the conversation to. Type in the name.

Conversation Text
message True string

The message to start the conversation with.

Returns

Start a new private conversation

This operation is used to start a new private conversation with a user.

Parameters

Name Key Required Type Description
Target Bot
EnterpriseBot True string

Select the bot.

Conversation Text
message True string

The message to start the conversation with.

User
user True string

User principal name (UPN).

Returns

Update an adaptive card sent to a tab

This operation is used to update a card sent to a tab.

Parameters

Name Key Required Type Description
Reply Activity
activityJson string

Reply Activity from the bot.

Returns

Triggers

When a registered intent is used

This operation triggers when the given LUIS intent vector is used by the bot.

When an intent is used

This operation triggers when the given LUIS intent is used by the bot.

When a registered intent is used

This operation triggers when the given LUIS intent vector is used by the bot.

Parameters

Name Key Required Type Description
filters
filters string

This operation triggers when the given LUIS intent vector is used by the bot.

Trigger Description
triggerDescription True string

Description shown in the bot help dialog.

Bot Trigger Type
triggerType True string

Select the type of trigger.

LUIS Intent Vector
intentVector string

Pick your LUIS Intent Vector.

Allow Branching
allowBranching string

Allow the user to trigger branching skills while answering followup questions.

Returns

The outputs of this operation are dynamic.

When an intent is used

This operation triggers when the given LUIS intent is used by the bot.

Parameters

Name Key Required Type Description
filters
filters string

This operation triggers when the given LUIS intent is used by the bot.

Trigger Description
triggerDescription True string

Description shown in the bot help dialog

Bot Trigger Type
triggerType True string

Select the type of trigger.

Keywords
keywords string

Enter custom keywords that will trigger the Flow.

LUIS API Key
luisApiKey string

Provide AtBot with your LUIS API Key.

LUIS App
luisAppId string

Pick your LUIS app.

LUIS Intent
luisIntent string

Pick the LUIS intent to use.

Returns

The outputs of this operation are dynamic.

Definitions

BotReplyResponse

Name Path Type Description
Message Id
id string

Id of the message created from the reply. Used to update the message.

BotResponse

Name Path Type Description
Response Text
text string

The response the user entered.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

files
files array of object
File Name
files.name string

The file name.

File Type
files.content-type string

The file type.

File Bytes
files.bytes byte

The file bytes.

BotResponse_Date

Name Path Type Description
Response Date
text date-time

The response datetime the user entered.

Response Date UTC
text_UTC date-time

The response datetime the user entered, in UTC format.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

BotResponse_Choice

Name Path Type Description
Response Choice
text string

The response choice the user entered.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

BotResponse_ChoiceList

Name Path Type Description
Selected Choice List Title
title string

The selected choice list title.

Selected Choice List Subtitle
subtitle string

The selected choice list subtitle.

Selected Choice List Value
value string

The selected choice list value.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

BotResponse_People

Name Path Type Description
people
people array of object
User Principal Name
people.upn string

The user principal name.

User Id
people.userid string

The user Id.

Full Name
people.fullname string

The user full name.

Email
people.email string

The user email.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

BotResponse_Memory

Name Path Type Description
Memory Item Title
title string

The title of the memory item.

Memory Item Value
value string

The value of the memory item.

Cancellation Notice
cancelNotice boolean

This flag will be True if the user responds with a cancellation keyword.

Responding User
respondingUser string

The user responding to the bot.

Response_SaveBotMemory

Name Path Type Description
Bot Memory Save Result
text string

The result of the save to bot memory.

Response_DeleteBotMemory

Name Path Type Description
Bot Memory Delete Result
text string

The result of the delete from bot memory.

BotGroupConversationStartResponse

Name Path Type Description
Message Id
id string

Id of the message created from the reply. Used to update the message.

Reply Activity
activityJson string

Activity Json.

BotConversationStartResponse

Name Path Type Description
Message Id
id string

Id of the message created from the reply. Used to update the message.

Reply Activity
activityJson string

Activity Json.

MemoryItem

Name Path Type Description
Memory Item Title
title string

The title of the memory item.

Memory Item Value
value string

The value of the memory item.