AtBot Logic
AtBot is a no-code bot building service that allows you to create conversational UIs quickly without any programming experience.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | AtBot Support |
URL | https://admin.atbot.io/Docs |
support@atbot.io |
Connector Metadata | |
---|---|
Publisher | H3 Solutions Inc. |
Website | https://www.atbot.io |
Privacy policy | https://admin.atbot.io/privacy |
Categories | AI;Productivity |
The AtBot Logic connector is used to create bot skills for bots built in the AtBot service. Using the actions in the connector, you can create complex conversational skills for your bots and connect them to other services by using additional connectors. AtBot is free to try in Microsoft Teams, with a premium version available to build custom bots on additional platforms. Visit the AtBot website for more information.
In order to use the free version of AtBot, you must have a Microsoft Teams account and have downloaded the AtBot bot from the app store.
To use the premium version where you can build your own custom bots, you must sign up for AtBot Premium. When you sign up for Premium, you will be give $25 credit to try out the service.
You will always log in to the AtBot connector using an Microsoft Entra ID Work or School account.
We have depricated the LUIS support in the keyword trigger. Please use LUIS Intent Vectors to create skills that recognize natural language.
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
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. |
Register chat bridge between two or more conversations |
This operation is used to initiate a chat bridge between two or more users. |
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 Event |
This operation is used to a send an event to the bot client. |
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. |
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
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 |
Returns
- response
- object
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 |
Returns
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
- response
- array of MemoryItem
This operation is used to ask the user for choice list input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
Choice Values
|
choices | True | object |
Provide the choice array object. |
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
|
Listen for voice response
|
listenForInput | boolean |
If this is a Teams call, this property determines whether the bot listens for a voice response. If no, or not a Teams call the bot will not immediately listen for a voice response. |
Returns
This operation is used to ask the user for choice input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
|
Listen for voice response
|
listenForInput | boolean |
If this is a Teams call, this property determines whether the bot listens for a voice response. If no, or not a Teams call the bot will not immediately listen for a voice response. |
Returns
- Body
- BotResponse_Choice
This operation is used to ask the user for datetime input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
Returns
- Body
- BotResponse_Date
This operation is used to ask the user for NLP input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
Returns
This operation is used to ask the user for bot memory input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
Returns
- Body
- BotResponse_Memory
This operation is used to ask the user for people picker input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
|
Listen for voice response
|
listenForInput | boolean |
If this is a Teams call, this property determines whether the bot listens for a voice response. If no, or not a Teams call the bot will not immediately listen for a voice response. |
Returns
- Body
- BotResponse_People
This operation is used to ask the user for input.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
Returns
- Body
- BotResponse
This operation is used to initiate a chat bridge between two or more users.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
User Name
|
chatUserName | True | string |
Display name of the chat user. |
Initiation Message
|
chatInitiationMessage | string |
Message to send to this user when the chat bridge is established. |
|
Reply Activity
|
activityJson | True | string |
The reply activity for the chat user. |
End Chat Command
|
endBridgeCommand | True | string |
The keyword command to send to the bot to end the chat bridge. |
Idle Timeout
|
idleTimeoutDuration | True | integer |
The duration (in minutes) of idle activity to trigger a timeout. |
Returns
- Body
- BridgeOutcome
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
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 | True | dynamic |
Returns
- Body
- BotReplyResponse
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 |
---|---|---|---|---|
Adaptive Card Set
|
cards | True | object |
Provide the card set object. |
Display Style
|
displayStyle | True | string |
Select the display style to use. |
Reply Activity
|
activityJson | True | 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
- Body
- BotReplyResponse
This operation is used to a send an event to the bot client.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Reply Activity
|
activityJson | True | string |
Reply Activity from the bot |
Event JSON
|
eventObject | True | object |
The JSON object to be sent in the chat event. |
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 |
Show in chat
|
showInChat | boolean |
If this is a Teams call, show this message in chat. Otherwise, the bot will only speak the message. |
|
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 |
|
Message ID
|
messageId | string |
(Optional) ID of a previous message in the same conversation to replace. If supplied, the bot will replace an existing chat message with this message. |
Returns
- Body
- BotReplyResponse
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 Listing
|
teamIDStr | True | object |
The channel listing output. |
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
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
This operation is used to update a card sent to a tab.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Adaptive Card
|
card | True | object |
Provide the card to use as the update. |
Reply Activity
|
activityJson | True | string |
Reply Activity from the bot. |
Returns
- Body
- BotReplyResponse
When a keyword is used |
This operation triggers when the given keyword(s) are used by the bot. Supply multiple keywords in semi-colon delimited format. |
When an intent vector is recognized |
This operation triggers when the given LUIS intent vector is recognized by the bot. |
This operation triggers when the given keyword(s) are used by the bot. Supply multiple keywords in semi-colon delimited format.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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. |
|
(Deprecated) LUIS API Key
|
luisApiKey | string |
(Deprecated) Provide AtBot with your LUIS API Key. This parameter is deprecated. Please use the Intent Vector trigger for LUIS use going forward. |
|
(Deprecated) LUIS App
|
luisAppId | string |
(Deprecated) Pick your LUIS app. This parameter is deprecated. Please use the Intent Vector trigger for LUIS use going forward. |
|
(Deprecated) LUIS Intent
|
luisIntent | string |
(Deprecated) Pick the LUIS intent to use. This parameter is deprecated. Please use the Intent Vector trigger for LUIS use going forward. |
Returns
This operation triggers when the given LUIS intent vector is recognized by the bot.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
filters
|
filters | array of string | ||
headers
|
headers | object | ||
properties
|
properties | object | ||
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
Name | Path | Type | Description |
---|---|---|---|
Message Id
|
id | string |
Id of the message created from the reply. Used to update the message. |
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. |
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. |
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. |
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. |
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. |
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. |
Name | Path | Type | Description |
---|---|---|---|
Bot Memory Save Result
|
text | string |
The result of the save to bot memory. |
Name | Path | Type | Description |
---|---|---|---|
Bot Memory Delete Result
|
text | string |
The result of the delete from bot memory. |
Name | Path | Type | Description |
---|---|---|---|
Conversation Id
|
id | string |
Id of the conversation created from the start group conversation. Used to update the conversation. |
Message Id
|
messageId | string |
Id of the message created from the start group conversation. Used to update the message. |
Reply Activity
|
activityJson | string |
Activity Json. |
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. |
Name | Path | Type | Description |
---|---|---|---|
Outcome
|
outcome | string |
The outcome of the bridge. |
Bridge Closed By
|
bridgeClosedBy | string |
The user that closed the bridge. |
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. |
This is the type 'object'.