Partilhar via


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

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

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

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