Microsoft Teams
Table of Contents
Getting started
Install
The easiest way to find the Ghost Inspector app for Microsoft Teams is with a direct link. That will open Microsoft Teams and take you straight to the correct app.
You can also find it manually if you open Microsoft Teams, click “Apps” in the bottom-left of the screen, and then search “Ghost Inspector”.
Click “Add to a team”, search for your team or channel, select it, then click “Set up a connector”.
After waiting a moment you should see our app load in the Microsoft Teams window. You may be asked to sign in to Ghost Inspector if you aren’t currently signed in.
There’s a chance the app might not immediately load in which case you’ll end up on the list of “connectors” like this.
This seems to be a bug in Microsoft Teams that sometimes happens. Find the “Ghost Inspector” connector in the list and click the “Configure” button to pick up where you left off and continue installing the app.
When you see the list of organizations you belong to, click “Connect” on whichever organizations you want to receive notifications from. You can select just one organization or as many as you want. Then click “Save”.
Now the Ghost Inspector app for Microsoft Teams is installed, but it won’t do anything until you configure it.
Configure
Open Ghost Inspector to the dashboard.
As a reminder, notifications can be configured at the organization, suite, and/or test level, depending on what makes sense for your particular use-case. Let’s assume you want to configure Microsoft Teams notifications at the organization level.
Go to your settings, find the appropriate organization in the sidebar, and click “Notifications”.
Along with the other notification types (email, webhooks, et cetera) you should see Microsoft Teams.
Each Microsoft Teams channel you integrate with Ghost Inspector will have a separate notification configuration. This one is for the “General” channel. Configure it however you like and click “Save” at the bottom.
Now you’ll receive result notifications in your Microsoft Teams channel!
Send notifications to multiple channels
Microsoft Teams integrations happen at the channel-level. That means once you’ve installed our app in a channel, if you want a different channel to also receive notifications, you’ll need to repeat the installation process for that other channel.
Update which organizations a channel can receive notifications from
If you add a new Ghost Inspector organization later or you made a mistake and need to change which organizations a channel can receive notifications from, you can do that within Microsoft Teams.
Find the team you want in the sidebar, hover over it and click the ellipses, then choose “Connectors”.
Click “Configured” in the sidebar to narrow down the list and find “Ghost Inspector”. The button next to it might say “Configure” or “Add” but don’t click it. No matter what it says, click where it says “X configured” to expand the dropdown and click the “Manage” button. Then you can connect or disconnect whichever organizations you like from the channel.
Remove the integration
Removing the integration is done within Microsoft Teams and follows the same steps as updating the integration. When you are on the management screen click “Remove” instead of “Save”.
You don’t have to do anything else within the Ghost Inspector app itself—when you remove the integration within Microsoft Teams the notifications will automatically be removed inside Ghost Inspector.
Legacy integration
We shipped our official integration with Microsoft Teams on March 5th, 2021. If you were using an integration prior to that then you were using the unofficial integration that Microsoft created to promote Teams.
If you are happy with the legacy integration you don’t have to do anything. We don’t expect Microsoft will remove it any time soon, if ever.
That said, the legacy integration is pretty rudimentary compared to the official integration and if you migrate over you’ll see much more useful result information in your channels.
Comparison to the official integration
Here’s a comparison of the information shown in the legacy integration and the official integration.
| Legacy integration | Official integration |
|---|---|
| ✅ Test/suite name | ✅ Test/suite name |
| ✅ Status | ✅ Status |
| ✅ View result link | ✅ View result link |
| ❌ Status counts | ✅ Status counts |
| ❌ Failure details | ✅ Failure details |
| ❌ Start URL | ✅ Start URL |
| ❌ Browser details | ✅ Browser details |
| ❌ Screenshots | ✅ Screenshots |
Also as we (or Teams) adds new features the official integration will continue to improve but the legacy intergration will not.
Migrating to the official integration
The first step in migrating to the offical integration is to install it following the steps listed above.
Once you’ve installed the official integration and connected it to an organization in Ghost Inspector the next step is to turn on the new notifications and disable the old notifications.
The legacy integration works by leveraging our generic webhook notifications. When you installed the legacy integration on a channel you were given a special webhook URL which you used to configure your Ghost Inspector notifications.
As a reminder, notifications can be configured at the organization, suite, and/or test level. And each channel you installed the legacy integration on has its own webhook URL. Depending on how you designed your notifications in Ghost Inspector, you may need to visit a few different notification settings screens in order to complete the migration.
On each notification settings screen, remove the appropriate webhook, enable the appropriate Microsoft Teams notification, and click “Save”.
Finally, you may remove the legacy integration from each channel you installed it on.
Troubleshooting
I can’t find the Ghost Inspector app in Microsoft Teams
If you can’t find the Ghost Inspector app when you search for it, try using this direct link. If when you click that link you get an error message saying the app can’t be found, then that’s most likely because your Microsoft Teams account has a policy restricting third-party apps.
To fix that, go to the App Permission Policies screen in the Microsoft Teams Admin Center. Click the “Global (Org-wide default)” policy (or whichever policy is appropriate).
Then change “Third-party apps” from “Block…” to “Allow specific apps” or “Allow all apps”. Then click “Save”.
Now you should be able to find the Ghost Inspector app in Microsoft Teams.