Display KB in a Microsoft Teams app
closed
Mike Rand
The current Document360 app does not include the ability to display the KB home page. It integrates with search very well, but to drive adoption I would like to pin the app to the left-hand navigation in Microsoft teams to make it easily accessible to my internal team. My request is that either the app is updated with this functionality or that Microsoft Teams is whitelisted so that a custom app can access the KB page and display it in a custom app. This isn't currently possible as a frame-ancestors error is thrown. Thanks!
Log In
D
D360 Product Management
closed
Thiru
Thank you very much Mike Rand and Marsha Hippensteel for collaborative spirit to get this detailed analysis and exploration in Ms Teams app.
Mike Rand
Hi Marsha, glad you found a way to get the API key to work! On the left hand nav, we opted for a workaround solution. What we did was create our own webpage that mimics the KB Home page (basically just a title and a few cards that point to the top level sections in the KB itself) and launches the actual KB in a new browser window. We then wrapped our webpage (hosted in Azure) into a Teams custom app and attached that to the left hand nav. It's a decent workaround, would still be better to not have to go out to a browser, but so far it's helping with adoption of our KB.
Marsha Hippensteel
Hi Mike. If you have a few minutes, could you email me at marshahippensteel@yahoo.com sometime? We tried to connect to MS Teams when this integration was released (it's on the toolbar), but it keeps asking for the API key to be re-entered. Would love to hear how you've had better success with this...
Mike Rand
Marsha Hippensteel: Hi Sorry for slow reply. We too are getting the API key needs to be re-entered. My IT Director will be looking into it. Will reply here if we get to a successful resolution.
Marsha Hippensteel
Mike Rand: Hi Mike! Thanks for the update! (I thought maybe you'd made it past that part--ha!)
I just looked at this again today. Interestingly, I found an option that seems to have worked for now. (This made for a much longer reply than I expected, but hope it helps!)
Previously, when it would prompt for a key to be re-entered, I was re-entering the key using the Add API Key option. (Screenshot attached.) And it would work for a limited amount of interaction, and then not.
As you can see in that screenshot, it's not prompting me for a key in that window anymore! What I did instead was discover another option to enter the key, and that seems to have worked.
- Right click the "D" on your MS Teams toolbar
- Select Settings
- Paste in your key
- Click Submit
Then when I left click on the "D", I'm able to enter a search term, and select an article to share via the Chat I'm in.
Note: So this effort allows us to send an article to someone via Teams Chat. And when they click on the Open Article button, it opens in their default browser and they have to log in to the KB to see it (if your KB is permission-controlled). This is for only one KB (i.e., can't enter multiple keys to search multiple KBs), so that's an issue for us. I think we have a few people on our team who might be willing to mess with the API key for one KB or another to use this, to share KB info. with others/their team members this way. Our team managers, etc. But I don't see 10s or 100s of employees all using this...those are the people who want the info. from the KB for themselves, not to share in a Chat to others!
FYI: When this integration was released, I asked our IT if they could "push" the Document360 app to Teams for everyone at our company. (To have it as a left panel app choice, like you want, and so the API key only has to be entered once!) They said they can't. So each of our employees would have to search for the app themselves in Teams, and then enter the API key to add it. We didn't announce this internally then, because it wasn't working the way we hoped.