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/ |
| 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 |