Create an Incoming Webhook on Office 365 Group
To begin, go to the Office 365 group that you would like to connect to Slack. Click on the Connectors button.
From the list of connectors, click the Add button next to Incoming Webhook.
You will now be asked for some cosmetic choices for how the connected messages will be displayed within the group. Fill in the Name textbox. You can also choose to override the default image used for each conversation. All of the connected messages will show up as conversations in the group with Incoming Webhook as the sender. The messages themselves will be embedded in that conversation and will use the name and image chosen here. When you are satisfied with your choices, click the Create button.
The settings will be saved, and you will be given a URL. This URL will be needed to configure Slack to send messages to the group. When you have saved this URL somewhere safe, you can click the Done button.
A conversation will be posted to the group stating that the Incoming Webhook connector has been added to it.
Create an Outgoing Webhook on Slack
With the Incoming Webhook URL saved, go to the Slack channel that you wish to connect to your Office 365 group. Click on the cogwheel button near the top of the page to access the Channel Settings.
From the Application Settings menu, click on the Add an App or Custom Integration menu item to go to the App Directory.
The App Directory contains all of the apps that may be added to Slack. Use the search box to find the Outgoing Webhooks app.
The Outgoing Webhooks app page will list the various teams that you have joined in Slack at the bottom of the page. If your team isn't listed, click the Sign in to Another Team link to login for that team. Once the team you desire is listed, click the Install button next to it.
You will be asked to confirm the addition of the Outgoing Webhooks Integration to your team on Slack. Click the Add Outgoing Webhooks Integration button.
Confirming the installation of the app will bring you to the Settings page for the app. I won't go over all of these settings, but I encourage you to explore them further using the links in the References section at the end of this blog. The settings we are interested in can be found in the Integration Settings section. Scroll down to it.
For the Channel field, choose the channel that you would like to monitor for messages. You can include Trigger Words if you like to filter what messages are sent, but I have decided to pass all messages to the Office 365 group. Add the Incoming Webhook URL that you saved earlier to the URL field. The field allows multiple URLs if you would like to send to more than one webhook. Fill in the Name field and customize the icon if desired. When you are finished, click the Save Settings button.
A message will be posted to the channel stating that you have added an integration.
Test the Webhooks
With both applications properly configured, you are now ready to test the connection. To do so, simply post a message in the Slack channel.
Within the Office 365 group, you should see a New Activity notification appear on the Conversations button near the top of the page to indicate that new conversations have been added to the group. Click on the Conversations button to see the new conversations.
You should see a conversation with the test message embedded within it using the name and image that you chose during the configuration process.
References
If you have any questions about this blog or would like to discuss Office 365 Group Connectors in more detail, I can usually be found in the SharePoint Community chat room during the week. You can also reach me on Twitter.
- What is a Webhook?
- Office 365 Connectors for Groups Walkthrough
- Enhancing Your Office 365 Groups Using Custom Connectors and Cards for Groups
- Office 365 Connectors for Groups
- Outgoing Webhooks
by Paul Choquette via Everyone's Blog Posts - SharePoint Community
No comments:
Post a Comment