Teams Bot
Learn how to connect TeamsBot to Engini
Getting Started with Teams Bot
Prerequisites
- A Teams Account
Connecting Engini to Teams Bot
- Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking here.
- Click on the "New Integration" option located at the top bar.
- Choose “Teams Bot” option from available applications:
- Enter the following details in the “New Integration” form:
- Connection name - Choose a significant name.
- Teams Bot Id - Insert the unique Id of you account.
- Teams Bot Key - Insert the unique Key that you retrieved from you account.
- Sign In with Microsoft
- Save Settings - When you finish Click Save Settings
Triggers
Adaptive card button click
Triggered when a user clicks a button inside an Adaptive Card sent by the Teams bot. It allows the bot to process the action and respond accordingly.
- Button - This field defines the specific button from the Adaptive Card that will trigger the action when it is clicked by the user.
Command Received
This trigger fires when a user sends a command to the Teams bot (usually starting with / or a short keyword).
- Command Name - This field defines which command should activate the workflow.
Help message received
Triggered when the user asks for help (for example by typing “help”). The bot can then return guidance or instructions on how to use it.
Message Received
Message received triggers the workflow whenever a user sends any message to the Teams bot, enabling free-text and conversational interactions.
Actions
Post Reply Action
Post reply is a bot action that sends a response back to the user after an action is performed.
- Message - Choose the text you want from the bot to sends back to the user.
- Add Attachments - Attachments allow the bot to include rich content such as cards, images, or files in its reply, in addition to plain text.
- Choose from the drop-down the attachment type you want to send (for example: card, file, image).
- Click on the empty field to the right to open the tooltip with all available options and properties.
- You can populate the attachment in one of the following ways (depending on the attachment type):
- Static value – a fixed value (such as text, URL, or JSON).
- Property value from a previous activity – select a file, card, or content returned earlier in the workflow.
- Expression – build the attachment dynamically using functions, previous activity properties, and/or static values.
- Repeat these steps for each attachment you want to include in the reply.
Note: It works only with a Teams Bot trigger, because the trigger identifies the user and provides the Azure User ID needed to know who to reply to.
Send adaptive card
Sends an Adaptive Card to the Teams chat. Adaptive Cards allow rich interactive content such as buttons, forms, and structured information.
- Adaptive card builder – Defines the Adaptive Card content and structure (such as layout, text, buttons, and inputs) that will be sent to the user.
- Start With Container - Acts as a logical grouping element for your card. It allows you to aggregate multiple elements (like text blocks and images) into a single boundary. This is used to apply consistent padding, background colors, or border styles to a specific section of the card, ensuring a clean and organized visual structure.
- Start With Column Set - Defines a horizontal layout by dividing the card width into multiple columns. This is essential for creating complex side-by-side designs, such as placing a profile picture next to a block of descriptive text or aligning data points in a grid-like format.
- All Templates – Provides a gallery of ready-to-use card structures designed for common business scenarios (e.g., Expense Approvals, Input Forms). Selecting a template automatically populates the builder with a professional layout, which can then be customized with specific data, saving time and ensuring UI consistency.
- Save (Disk Icon) – Commits the current design and structure to the activity definition. Clicking this icon converts your visual layout into the underlying JSON schema required by Microsoft Teams. This step is mandatory to ensure that the modifications made in the designer are applied to the "Adaptive Card" field in the main action window.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Send Teams Message
Send Teams message sends a message (with optional attachments) to a Teams chat, channel, or directly to a specific user if a User ID is provided.
- Message - Choose the text you want from the bot to sends back to the user.
- User ID - Insert the unique user's Id, the one you want to send the message.
- Add Attachments - Attachments allow the bot to include rich content such as cards, images, or files in its reply, in addition to plain text.
- Choose from the drop-down the attachment type you want to send (for example: card, file, image).
- Click on the empty field to the right to open the tooltip with all available options and properties.
- You can populate the attachment in one of the following ways (depending on the attachment type):
- Static value – a fixed value (such as text, URL, or JSON).
- Property value from a previous activity – select a file, card, or content returned earlier in the workflow.
- Expression – build the attachment dynamically using functions, previous activity properties, and/or static values.
- Repeat these steps for each attachment you want to include in the reply.