Only owners and admins see and manage notifications. If you lack the right, for example after a role change with the page open, it says: “Only admins and owners can manage notifications.” More about roles under Team and roles.
Which messages arrive
There are four messages. When you add a channel, you choose which of them it gets, at least one.
Channels that were created before this selection existed keep getting all messages, including the new group Expired. Channels with a narrower choice keep it. Each message names the offer’s title, the recipient and a link “Open in HocDoc”. The amount is included if the offer has an offer value above 0. The messages are in German. The amount is the offer value (see Recipient’s choice).
Set up a channel
1
Get the webhook address
In Slack, you create an app with “Incoming Webhooks”, add a webhook for the channel and copy the address. It begins with
https://hooks.slack.com/services/. In Teams, open “Workflows” in the channel, choose the template “Send webhook alerts to a channel” and copy the address.2
Open the dialog
Open Settings, then the Integrations tab. In the Notifications card, choose Add channel.
3
Enter service and address
Under Service, choose Slack or Microsoft Teams. Paste the address under Webhook address. Under Description (optional) you write, for example, the channel’s name. Under Messages you choose which messages the channel gets: Sent, Opened and Accepted. At least one must be chosen, otherwise it says: “Please choose at least one message.” This cannot be changed later. Choose Add. Afterwards it says “Channel added.”
4
Send a test message
In the channel’s row, choose Send test message. The button only exists for an active channel. Afterwards it says: “Test message sent. The result is in the delivery log.” In your channel, this appears: “Test message from HocDoc. This channel will now receive messages about offers.”
Slack: get the webhook address
In Slack you need your own app with an incoming webhook.1
Create a new app
Open api.slack.com/apps and choose “Create New App”. Choose “From scratch”, enter a name (for example HocDoc) and pick your workspace. Choose “Create App”.
2
Switch on webhooks
Choose “Incoming Webhooks” on the left and switch on “Activate Incoming Webhooks”.
3
Add a webhook for the channel
Choose “Add New Webhook to Workspace” at the bottom. Pick the channel and then “Authorize”. You only see a private channel if you are a member.
4
Copy the address
Copy the address under “Webhook URLs for Your Workspace”. It begins with
https://hooks.slack.com/services/. Treat it like a password.5
Paste it into HocDoc
In HocDoc, choose Add channel and paste the address (see above). Then send a test message.
Teams: get the webhook address
Teams uses the Workflows app (Power Automate) for this. The old Office 365 connectors no longer work, and HocDoc rejects their addresses.1
Open the channel
In Teams, open the team and the channel that should receive the messages.
2
Open Workflows
Next to the channel, choose “More options (…)” and then “Workflows”. Alternatively, open the Workflows app in the left bar of Teams.
3
Pick the template
Search for the template “Send webhook alerts to a channel” and select it.
4
Save
Pick the team and channel, then choose “Save”.
5
Copy the address
On the workflow’s page, copy the webhook link. The host ends in
.environment.api.powerplatform.com or .logic.azure.com.6
Paste it into HocDoc
In HocDoc, choose Add channel and paste the address (see above). Then send a test message.
HocDoc sends Teams a message with an Adaptive Card (version 1.2). According to Microsoft, the Workflows template displays this format. The workflow runs under the account that created it. If that account leaves the company, a co-owner should be added.
Rules for the address
- The address must match the chosen service. For Slack it must begin with
https://hooks.slack.com/services/, otherwise it says: “That is not a Slack address. It must start with https://hooks.slack.com/services/.” - For Teams only the address of a workflow (Power Automate) works. HocDoc rejects the address of a classic connector: “That is not a Teams address. A workflow address (Power Automate) is expected, not one from a classic connector.”
- Only https on the standard port 443 applies, without credentials and without an IP address.
- The same address can only be created once per workspace: “This channel already exists in this workspace.”
The address is a secret
Whoever has the address can write to your channel. HocDoc therefore does not show it again after saving. The list and the delivery log only show the name of the address and its end. Editing an address or the chosen messages is not possible: delete the channel and create it anew.Manage channels
The card says how many channels you have (“2 of 5 channels added.”). As long as there is none, it says “No channel yet”. Each channel shows the service, description, the chosen messages (“Messages: …”), status, “Last message on” with date and time or “Nothing sent yet”, for a failure “Last failure on” and “Added on” with the person who added it. Times are in the workspace’s time zone. The status is Active, Paused or Paused automatically. Each channel has a button: for an active channel Send test message, for a paused one Resume. Through the menu next to it you reach Pause (only for an active channel) and Delete. The effects:
If several messages to a channel finally fail in a row, HocDoc pauses it on its own, as with the endpoints of webhooks. The channel then shows “Paused automatically on” with the number of failed messages. Check the address and then choose Resume.
On an automatic pause, the workspace’s owner and all admins get an email, in the language of their account, with a link to the settings. One email comes per pause. A pause you trigger yourself sends no email.
Limits
- A workspace has at most 5 channels, Slack and Teams together. The channels do not count toward the 5 endpoints of webhooks. Once the limit is reached, it says: “The limit is reached. Delete a channel to add a new one.”
- An account creates webhooks or channels in at most 20 workspaces. Once that is reached, it says: “You have already created webhooks in 20 workspaces. First delete the entries in a workspace where you no longer need them.”
- Delivery, retries and pause are the same as for webhooks. The result of every message is in the Delivery log, including that of the test message.
- HocDoc rejects too many tests in a short time: “Too many tests in a short time. Please try again in a few minutes.”