GaggleAMP’s Microsoft Teams integration makes it even easier for Gaggle Members to receive notifications of new content and to share content to their networks. Members will have the ability to customize how frequently they receive notifications and can even schedule content directly from Microsoft Teams.
Setting up Your Microsoft Teams Integration as a Manager
From the Manager dashboard within the GaggleAMP platform, navigate to the image or initials in the right hand corner and select Gaggle Settings. Next, select ‘Integrations’ on the secondary navigation bar and scroll down to the Microsoft Teams integration.
Select ‘Link Microsoft Teams Account.’ This will bring up a page that asks you to authenticate your Microsoft account. Once you have passed along valid credentials, Microsoft will gather your authorization for the integration.
Note: In order to facilitate the integration, the Microsoft account you provide here must have administrative privileges over the MS Team “team” your Gaggle Members will use to facilitate the integration.
After you have clicked ‘Accept,’ you should see the GaggleAMP integrations page. Notice that the ‘Link Microsoft Teams Account’ has now been updated to ‘Unlink Microsoft Teams Account.’ If at any time you need to unlink your Microsoft Teams account, you will simply need to navigate back to this page and select the button to unlink your account.
Finalize Manager Setup
- Download the "GaggleAMP_Teams_App.zip" file from this document and save it to your computer's desktop (or other location of your preference)
- Visit https://admin.teams.microsoft.com/policies/manage-apps
- Click '+ Upload' and upload the GaggleAMP app bundle (zip file) downloaded in step 1
- Enable the app for the team by setting its status to 'Allowed'
- Delete the "GaggleAMP_Teams_App.zip" file from your computer
Your Member’s Set-Up Experience
Before a Gaggle Member can set up their connection to Microsoft Teams, make sure your Gaggle Manager has followed the steps above to integrate GaggleAMP to Microsoft Teams.
Note: GaggleAMP’s integration with MS Teams can be leveraged via the MS Teams web app, mobile app, and desktop client. We include screenshots of the web applications, but the logic and flow are the same across each of these platforms.
Installing the GaggleAMP Microsoft Teams App
After the Gaggle Manager has configured the Gaggle integration to Microsoft Teams, each Member must link their Microsoft Teams account to their GaggleAMP profile.
To do so, the Gaggle Member should first access their Microsoft Teams account. Select the three dots, as shown below. This will then open the ability to search for ‘GaggleAMP’ in the available applications. Once found, select ‘GaggleAMP’ and choose ‘Add.’
Configuring the GaggleAMP Teams App
Once you have added GaggleAMP to your Microsoft Teams account, it’s time to configure the set-up.
The GaggleAMP app will introduce itself in your team’s chat window and it will look a little like this:
Note: If the GaggleAMP app does not introduce itself with the message you see here, it means the Gaggle Manager has not yet completed the set-up of the Microsoft Teams “team” and needs to complete that step.
Go ahead and click on the portion of the message that says ‘Add Microsoft Account to GaggleAMP.’
Note: Should the initial click fail, simply click that link again.
Clicking on ‘Add Microsoft Account to GaggleAMP’ will trigger the GaggleAMP authentication page. Here you will pass your GaggleAMP credentials. If your credentials are correct, you will see the following screen:
Upon successful verification of your GaggleAMP credentials, you will be redirected to your connected social accounts on the GaggleAMP platform. Here you will see that the Microsoft account has been linked.
Note: If at any point you need to verify this link, or remove the connection, simply select your image (or initials if you did not add an image) in the top right corner of GaggleAMP, then select ‘Account Settings,’ and on the navigation bar select ‘My Social Accounts.’
Using the GaggleAMP Microsoft Teams App
Now that your GaggleAMP account and Microsoft Teams account are connected, it’s time to start performing some activities!
The GaggleAMP Microsoft Teams app works on a command-response structure, meaning that when you give the app a command, it will give you a response. So, for example, when you pass the command ‘help,’ you will see the response from the app is a list of other activities you can do.
Here are some of the commands and what they present:
Using the command ‘Show Activities’ will result in showing the first five Activities available to the Member in GaggleAMP. In the instance you have more than five Activities pending in GaggleAMP, you may need to run this command more than once to display new Activities. These Activities display with the soonest ‘Activity expiration date’ appearing at the top of the Activities list.
An Activity shown in this view will look similar to this:
Each Activity card will have three different options you can do: perform the activity, schedule the activity, or refuse the activity.
Note: Depending on the type of Activity shown, the ‘perform the activity’ button will look slightly different and will read with prompts such as: “Click to Comment,” “Share on LinkedIn,” “Like Tweet,” “ReTweet,” or other variations that match the network the activity is being performed on.
Selecting the ‘perform the activity’ function will cause that activity to be done immediately. But if you do not want that activity performed right now, the ‘Schedule’ activity will come in handy.
Clicking ‘Schedule’ will show a dropdown menu that allows you to schedule when the activity will be performed. Once you make your selection, be sure to choose ‘Schedule’ before moving on to the next activity or this will not be scheduled.
Note: If you would like this activity to follow your pre-selected preferences, select ‘Based on My Preferences.’ For more on setting your preferences, visit How Do I Adjust My Gaggle Settings?
Lastly, selecting the ‘Refuse’ button will simply remove the Activity from your feed without it being performed.
Passing this command shows your current in-Teams notification schedule. When new Activities are available in GaggleAMP and are unseen by you, the GaggleAMP Teams bot will notify you according to this schedule. Conveniently, the command and options for changing this setting are also displayed.
Change Notification Setting to Daily
Selecting this prompt will allow you to change the setting for your Microsoft Teams account. Here you can enter any of the following prompts to change when or how often you receive notifications from Microsoft Teams.
Using the ‘help’ command at any time will display the list of valid commands for interacting with the GaggleAMP bot.
Frequently Asked Questions
If a Member views an activity from within the GaggleAMP platform, will they see that activity on Microsoft Teams?
When the “show activities” command is passed, the GaggleAMP bot will display up to five activities available to you at that moment, even those you’ve already viewed on the GaggleAMP website or mobile app.
That said, the GaggleAMP bot will only actively notify you (per your notification schedule) of newly available activities that have not yet been displayed to you on any GaggleAMP platform.
Are all activities available on Teams?
In short, no, but if it shows up in Teams, it can be performed, scheduled, or refused from Teams.
The GaggleAMP integration with Microsoft Teams will allow your Members to seamlessly perform simple actions, such as ‘Like a Tweet’, ‘Share on LinkedIn’, scheduling these to be performed at a later time or date, and adding comments to ‘Comment on LinkedIn’ activities.
I noticed in the Microsoft Teams permissions these three items in which we’d be granting the GaggleAMP permission to access: Read all users’ basic profiles, view your basic profiles, and maintain access to data you have given it access to. What is this all about?
- View information about a user’s identity, like your name in Microsoft Teams or other information supplied on your user profile
- Allow you to recall Activities from your Gaggle Manager in Microsoft Teams and allow you to schedule these activities or perform these activities directly to your connected social media profiles.
The above permissions are granted per user, that is each user authorizes the above permissions. Members are asked only for the permission to connect their Microsoft Teams instance to their GaggleAMP Account; Gaggle Managers are asked to accept the above permissions when integrating GaggleAMP to Microsoft Teams.
This information is used to:
- Notify members for new activities by direct messaging.
- Perform activities from within Microsoft Teams by clicking command buttons in the bot direct messages.
Does GaggleAMP work with the free version of Microsoft Teams?
Yes, we do! Keep in mind the free version limits the number of apps you can connect to 10 so as long as we’re one of those 10, you’re good!
If you have any additional questions about the integration setup, please reach out to your Customer Success Manager.
My security officer at my company would like to know more about the permissions granted. Is there anything I can send them?
Of course! GaggleAMP accesses Microsoft Teams through the API. Below is a summary of the Microsoft Graph identifications that are delegated to GaggleAMP, along with a brief description of the identifications. It also identifies which areas require admin consent.
Should your security officer have additional questions, please reach out to your Customer Success Manager and we can relay your questions or put our security officer in touch with yours.