The Bot Platform (Preview)

Connect The Bot Platform's bots to any application, send messages to bot users, set attribute values using your existing bots at The Bot Platform

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      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	The Bot Platform Support
URL	https://thebotplatform.com/contact/
Email	hello@thebotplatform.com

Connector Metadata
Publisher	The Bot Platform
Website	https://thebotplatform.com
Privacy policy	https://thebotplatform.com/privacy-policy/
Categories	Communication;Website

The Bot Platform connector will let you use data from your Power Automate flows to send messages to users in the bot, create new attributes and set values for existing attributes. The connector leverages our API to perform all these actions, without you having to setup API calls manually, instead just use the connector to perform API actions faster.

Prerequisites

You will need an account at The Bot Platform

How to get credentials

After logging in to The Bot Platform CMS, go to the bot you want to connect. Click on 'API Access' in the sidebar menu and create a new integration app. You will be provided with a client ID and secret key, enter this information in Power Automate where you are using your connector to authenticate the bot with Power Automate.

Get started with your connector

After logging into your account, go to the bot you want to integrate and click on 'API Access' to obtain your client ID and Secret key. After obtaining this information, create a new Power Automate Flow, you will be prompted to enter the client ID and secret key there. After entering this information, a pop up will appear asking for permission to access the bot. Hit 'Allow' and you are all set!

Known Issues & Limitations

• Currently users can only be identified via email address to be able to communicate information back to the bot.
• You cannot send an image url using the simple text message operation.

Common errors and remedies

For bots installed on Microsoft Teams, you cannot send a message to a user who has not previously interacted with the bot. The workaround would be to send a broadcast to the user from within the platform first before using the connector to send a message.

FAQ

For more information regarding our use cases, visit our Dev Docs page

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Client Id - Your The Bot Platform clientId	string	Please enter your client Id.	True
Your The Bot Platform Client Secret	securestring	Please enter the client secret.	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a user attribute	Setup a new attribute in your bot
Send a simple text message to a bot user	Send a message to a bot user using text
Set an attribute value	Set an attribute value via the users email address

Create a user attribute

Operation ID:

CreateUserAttribute

Setup a new attribute in your bot

Parameters

Name	Key	Required	Type	Description
Attribute name	name		string	Provide a name for your attribute
is pii?	is_pii		string	is it personally identifiable information?

Returns

Name	Path	Type	Description
UserAttribute	data	UserAttribute	User attribute

Send a simple text message to a bot user

Operation ID:

SimpleTextMessage

Send a message to a bot user using text

Parameters

Name	Key	Required	Type	Description
text	text		string	Enter your text message here
email address	recipient		string	email address of recipient

Returns

Name	Path	Type	Description
External Activity	data	ExternalActivity

Set an attribute value

Operation ID:

SetUserAttribute

Set an attribute value via the users email address

Parameters

Name	Key	Required	Type	Description
email address of the user who's attribute is being set	emailaddress	True	string	email address
Attribute ID	id	True	string	Existing attributes in the bot
value	value		string	attribute value

Definitions

ExternalActivity

External Activity

UserAttribute

User attribute

User attribute

UserAttribute