> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hocdoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications and connections

> Set up messages about your offers in Slack or Microsoft Teams. Plus the state of the planned connections to HubSpot and Pipedrive.

HocDoc can send messages about your offers to a Slack or Teams channel. This way your team sees right away when an offer goes out, is opened for the first time or is accepted. You set this up in the settings. For this you need the address of an incoming webhook in Slack or Teams.

The **Notifications** card exists on all plans. It says: "Messages about offers in Slack or Microsoft Teams."

> [!NOTE]
>
> 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](https://docs.hocdoc.com/en/guides/team-and-roles.md).

## Which messages arrive

There are four messages. When you add a channel, you choose which of them it gets, at least one.

| Message | When it arrives |
| - | - |
| **Offer sent** | An offer was sent, also a resend. |
| **Offer opened** | The recipient opens the offer for the first time. Later opens trigger nothing. |
| **Offer accepted** | The offer is accepted. |
| **Offer expired** | The validity of the offer runs out. There is no email for this. Choice: group **Expired**. |

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](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md#recipients-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](https://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.

> [!NOTE]
>
> 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/](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:

| Action | Effect |
| - | - |
| **Send test message** | Sends the test message. |
| **Pause** | As long as the channel is paused, nothing goes to it: "Paused on" with a date. |
| **Resume** | The channel gets messages again. |
| **Delete** | After confirmation in the "Delete channel" dialog, the channel gets no more messages. This channel's delivery log is deleted too. This cannot be undone. |

If several messages to a channel finally fail in a row, HocDoc pauses it on its own, as with the endpoints of [webhooks](https://docs.hocdoc.com/en/guides/settings.md#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."

## Connections to HubSpot and Pipedrive (coming soon)

In the settings, in the **Integrations** tab, is the **Connections** card. It says: "Connect HocDoc to services you already use. Sending, first opening and acceptance then show up there." There you see **HubSpot** and **Pipedrive** with the status **Coming soon**. There is no button to connect yet.

The plan is for HocDoc to create a contact, a deal and notes for each offer and to set the deal to won on acceptance. When this will be released is not yet fixed. As soon as it is, this page will describe the setup.

All roles see the card. Until then, you set up notifications with Slack or Teams or connect your own systems through [webhooks](https://docs.hocdoc.com/en/guides/settings.md#webhooks) and the [API](https://docs.hocdoc.com/en/api/introduction.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.