Brightidea for Microsoft Teams


Brightidea can be integrated with Microsoft Teams in a few different ways:

  • Capture ideas directly in Microsoft Teams using the app
  • Post rich updates to Teams using the Rules Engine
  • Embed recordings hosted in Microsoft Stream in idea details

Read on to find out what is right for you and your organization!

Table of Contents

Brightidea for Teams App

Brightidea offers an official app for Microsoft Teams that can be accessed via search in the app catalog within Teams, or online from Microsoft AppSource.

The Teams app is designed to help you quickly save ideas directly from Teams conversations without leaving the chat. Ideas can be saved from channel messages, replies, or private chats.

With the app you will be able to:

  • Capture ideas directly from messages in Teams
  • Add idea details and attachments from Teams
  • Establish a link from submitted ideas back to original conversations
  • Preview ideas from their URLs in Teams chats

Coming soon:

  • Admin-only: submit ideas on behalf of other users from their messages
  • Admin-only: create accounts for unregistered users via submission process

Installation

  • Search the app gallery for "Brightidea" and click the card for app details

mceclip1.png

  • From the app details screen, review the app capabilities and permissions, then click the "Add" button to install the app to your Teams instance

mceclip2.png

  • The app will be installed and the Brightidea bot will immediately send you a welcome message with further guidance

Note: We recommend installing the app from the official in-product marketplace or from AppSource to ensure your installation always stays current. The latest package file is also provided for standalone or custom installation. See instructions here: Standalone Installation for Microsoft Teams App

Logging into the Teams App

You must have a Brightidea account to use the main functionality of the app. The first step is to log into your account. 

Coming soon: there will be an optional step for admins to log into Microsoft Graph in order to access details about other users in order to submit on their behalf. 

  • If you are not continuing directly from the installation steps above, navigate to the "Chat" tab in Teams, and find the Brightidea bot chat
  • From the welcome message, click "Log in"
    • If you can't find this message simply send a chat to the bot, "Log in"

mceclip3.png

  • Now you will be prompted to login into Brightidea and select an affiliate to connect to. If your site has SSO enabled you will be prompted to log in using SSO.

Screen_Shot_2021-03-12_at_2.55.20_PM.png

  • Coming Soon: Once you are successfully logged into Brightidea, the bot will send a message to optionally log into Microsoft Graph
    • Access to Graph allows the app to match users between Teams and Brightidea
    • This secondary sign in is necessary & recommended for Brightidea administrators to submit on behalf of other users

Note:

  • Log out at any time by sending a chat to the bot, "Log out"
  • Log in at any time by sending a chat to the bot, "Log in"
  • View help tips and instructions by sending a chat to the bot, "Help"
  • Review the welcome message by sending a chat to the bot, "Welcome"
  • App installation and/or Microsoft Graph may require administrator approval depending on organization policies (see special instructions below)

Using the Teams App

The Brightidea app is accessed directly from the message you want to submit as an idea.

  • From any message, hover & click the ellipsis button for the menu, then select More Actions > Send to Brightidea

mceclip4.png

  • You will be prompted to select an activity to submit the idea to
    • The list of available activities will be based on your administrative and general access in Brightidea

mceclip7.png

  • Click "Next"

From the submission form:

  • Choose from the selected activity's available categories (required)
  • Enter a short but descriptive title for the idea (required)
  • The description will be automatically pulled from the selected message, and can be edited if needed from this screen (required)
  • If the message contains any attachments or images, those will be shown at the bottom of the form and can optionally be included as links on the submission
    • The attachments will still be hosted by Microsoft and thus maintain permission enforcement
    • A link to each attachment will be appended to the idea description

mceclip9.png

  • Click "Submit"
  • Once the idea is submitted, a confirmation card will be inserted as a reply to the original message, but will not be automatically sent
    • Click the "Send" button or hit "Enter" to share the confirmation card with team or chat members
    • Hit "Backspace" or "Delete" to remove the confirmation card

In Brightidea:

  • Attachments will be listed by their file name and linked in the description of the submitted idea
  • The description will also contain a link back to the original Teams chat
  • Description can be edited and enhanced, and additional submission questions can be completed

Screen_Shot_2021-03-12_at_3.48.36_PM.png

With the app installed, pasting a link to an idea in the "compose message" area will automatically insert a rich preview.

  • The card can be removed by clicking the "X" icon

mceclip10.png

 

Coming Soon: Administrator Features

As a Brightidea admin, the app will soon give you access to additional functionality. You must sign into Graph to access the features below.

Submit on Behalf

  • From another user's message click More Actions > Send to Brightidea
  • After selecting an activity, you will be able to submit either from your account on on the author's behalf

mceclip14.png

  • Accounts will be matched based on the email address the author is using in Teams (this is why Graph access is needed)
  • When submitting on behalf of users, the "new idea submitted" emails will be sent according to pipeline setup, so submitters may be notified outside of Teams

Unregistered Submission

  • If the submit-on-behalf user does not yet have an account in Brightidea, it will be automatically created when the idea is submitted

Notes on Microsoft Graph

  • Microsoft Graph is the gateway that allows the Brightidea app to access data from Microsoft 365, including user information such as name and email
  • At this time, the Brightidea app does not make use of Graph
    • The next app update will provide additional administrator functionality as described above, and will require a Graph connection to access this functionality
    • Graph authorization will enable admins to "submit on behalf" of other users by attempting to match their email address between the two services
    • New Brightidea accounts will be able to be created from users' email addresses reported by Graph
  • Depending on your organization's policies:
    • Access to Graph by employees or 3rd party apps may be disabled
    • The first user to access Graph through the Brightidea app may be prompted to request admin approval 
    • Admins may grant permission and approval through their Azure AD v2 portal if they are not notified directly

Screen_Shot_2021-03-12_at_5.29.43_PM.png

Other Ways to Integrate Brightidea with Teams

Using Webhooks and Rules to Post to Teams

The "HTTP Request" rule action can be paired with an "Incoming Webhook" connector in Teams to automatically post updates to Teams when certain triggers & conditions are satisfied in Brightidea.

See HTTP Requests with Rules Engine (AKA Outgoing Webhooks) for detailed setup instructions.

For example, you may want to post to a Teams channel when:

  • New ideas are submitted
  • Ideas are selected for implementation (or any other status)
  • Ideas become stale (too long without a status change)
  • New comments or votes are received

 

mceclip5.png

 

mceclip13.png

 

Embedding Microsoft Streams Videos

Microsoft Stream videos and recordings can be embedded in the idea description.

  • In Streams, copy the embed code

 

mceclip11.png

  • In Brightidea, edit the idea description and click the "Video" button in the editor
  • Paste the embed code in the popup and click "insert"
  • You will see a preview of the video
  • Click save

mceclip12.png

 

See Embedding external videos on View Idea page for more details on this feature. 

 

Important Things to Know

  • Coordinating with your Microsoft IT admin(s) will make for a smooth app installation experience 
    • Installation of Teams apps may be disabled by organization policies & permissions
    • Teams apps and related policies are managed by IT admins in the Microsoft Teams admin center 

Screen_Shot_2021-03-16_at_4.18.31_PM.png

  • Using administrator features in the Teams app requires authentication with Microsoft Graph. Graph access may be limited or prevented by organization policies, so request approval through the sign in flow and/or contact your Microsoft administrator for details
    • If approval cannot be granted you will be limited to submitting ideas from your own account. You can then reassign the submitter in Brightidea if necessary
  • In the Teams app, when submitting on behalf of an unregistered user, a new account will be created during the submission process
  • It is best to consult Microsoft documentation and support for installing the app for other users
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments