Slack and Microsoft Teams¶
There are three levels of chat integration:
| What | Licence | Page |
|---|---|---|
| Alerts, reminders and the daily briefing in a channel | Core (free) | Notifications |
| Finding messages from the search field | Team | Workplace search |
| Announcements in a channel, the Slack command and the Teams app | Team | this page |
Announcements in a channel¶
When you publish an announcement, choose Also post to … and one of the Slack or Microsoft Teams notification channels. Waylight posts the announcement once, with a link back to it. Editing it later does not post again unless you choose Post update. No extra access to Slack or Teams is needed beyond the channel's webhook.
Slack command¶
With the slash command /waylight people search the start page without
leaving Slack: /waylight vpn answers with the top results as a message only
the person asking can see.
Slack sends the command to a public address, so this needs a request from the internet to your instance. That is off by default and kept apart from the normal API:
- The command is received at its own path,
/hooks/slack/command, which is disabled until you set it up. Nothing else becomes reachable. - Every request is verified with your app's signing secret and rejected if it is older than five minutes.
- If your instance is not reachable from the internet, expose only this path through your reverse proxy or a tunnel, for example a Cloudflare Tunnel or Tailscale Funnel with a path rule (reverse proxy).
Set it up in the internal Slack app of the workplace search:
- Under Slash Commands create
/waylightwith the request URLhttps://<public-address>/hooks/slack/command. - Copy the Signing Secret from Basic Information to Settings → Integrations → Slack → Slash command.
The Slack user is matched to a Waylight member through their connected account, so results follow that member's permissions. Someone who has not connected Slack gets a link to do so. Answers arrive within Slack's three second limit or follow shortly after.
Microsoft Teams app¶
Waylight as a tab in Microsoft Teams: a personal tab for each person and a channel tab for a team, both showing the start page.
- Settings → Integrations → Microsoft Teams → Download app package creates a package for your instance.
- A Teams admin uploads it in the Teams admin center under Manage apps → Upload new app, or allows custom apps for a pilot group.
- People add Waylight from the apps list, or pin it in a channel.
With single sign-on through Microsoft Entra ID the tab opens signed in, without a second login. Waylight allows itself to be shown inside Teams only for the Teams addresses, not for other sites. The tab only works where the instance is reachable from the person's device, for example in the office network or through a VPN.