> ## 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.

# Benachrichtigungen und Verbindungen

> Nachrichten zu deinen Angeboten in Slack oder Microsoft Teams einrichten. Dazu der Stand der geplanten Verbindungen zu HubSpot und Pipedrive.

HocDoc kann dir Nachrichten zu deinen Angeboten in einen Slack- oder Teams-Kanal schicken. So siehst du im Team sofort, wenn ein Angebot rausgeht, zum ersten Mal geöffnet oder angenommen wird. Du richtest das in den Einstellungen ein. Du brauchst dafür in Slack oder Teams die Adresse eines eingehenden Webhooks.

Die Karte **Benachrichtigungen** gibt es in allen Tarifen. Sie sagt: „Nachrichten zu Angeboten in Slack oder Microsoft Teams.“

<Note>
  Nur Inhaber und Admins sehen und verwalten Benachrichtigungen. Fehlt dir das Recht, zum Beispiel nach einem Rollenwechsel bei offener Seite, steht: „Nur Admins und Inhaber dürfen Benachrichtigungen verwalten.“ Mehr zu den Rollen unter [Team und Rollen](/guides/team-und-rollen).
</Note>

## Welche Nachrichten kommen

Du bekommst drei Nachrichten. Du kannst sie nicht einzeln abwählen.

| Nachricht | Wann sie kommt |
| - | - |
| **Angebot versendet** | Ein Angebot wurde versendet, auch ein erneuter Versand. |
| **Angebot geöffnet** | Der Empfänger öffnet das Angebot zum ersten Mal. Spätere Öffnungen lösen nichts aus. |
| **Angebot angenommen** | Das Angebot ist angenommen. |

Jede Nachricht nennt den Titel des Angebots, den Empfänger und einen Link „In HocDoc öffnen“. Der Betrag steht dabei, wenn das Angebot einen Angebotswert über 0 hat. Die Nachrichten sind deutsch. Der Betrag ist der Angebotswert (siehe [Wahl des Empfängers](/guides/annahme-und-zertifikat#wahl-des-empfängers)).

## Kanal einrichten

<Steps>
  <Step title="Adresse des Webhooks holen">
    In Slack legst du eine App mit „Incoming Webhooks“ an, fügst für den Kanal einen Webhook hinzu und kopierst die Adresse. Sie beginnt mit `https://hooks.slack.com/services/`. In Teams öffnest du im Kanal „Workflows“, wählst die Vorlage „Send webhook alerts to a channel“ und kopierst die Adresse.
  </Step>

  <Step title="Dialog öffnen">
    Öffne **Einstellungen**, dann den Reiter **Integrationen**. In der Karte **Benachrichtigungen** wählst du **Kanal hinzufügen**.
  </Step>

  <Step title="Dienst und Adresse eintragen">
    Wähle bei **Dienst** **Slack** oder **Microsoft Teams**. Füge die Adresse bei **Adresse des Webhooks** ein. Bei **Beschreibung (optional)** schreibst du zum Beispiel den Namen des Kanals. Wähle **Hinzufügen**. Danach steht „Kanal angelegt.“
  </Step>

  <Step title="Testnachricht senden">
    Wähle in der Zeile des Kanals **Testnachricht senden**. Den Knopf gibt es nur bei einem aktiven Kanal. Danach steht: „Testnachricht gesendet. Das Ergebnis steht im Zustell-Log.“ In deinem Kanal erscheint: „Testnachricht von HocDoc. Dieser Kanal bekommt ab jetzt Nachrichten zu Angeboten.“
  </Step>
</Steps>

### Regeln für die Adresse

* Die Adresse muss zum gewählten Dienst passen. Bei Slack muss sie mit `https://hooks.slack.com/services/` beginnen, sonst steht: „Das ist keine Slack-Adresse. Sie muss mit [https://hooks.slack.com/services/](https://hooks.slack.com/services/) beginnen.“
* Bei Teams geht nur die Adresse eines Workflows (Power Automate). Die Adresse eines klassischen Connectors lehnt HocDoc ab: „Das ist keine Teams-Adresse. Erwartet wird die Adresse eines Workflows (Power Automate), nicht die eines klassischen Connectors.“
* Es gilt nur https auf dem Standard-Port 443, ohne Zugangsdaten und ohne IP-Adresse.
* Dieselbe Adresse lässt sich nur einmal je Workspace anlegen: „Diesen Kanal gibt es in diesem Workspace schon.“

### Die Adresse ist ein Geheimnis

Wer die Adresse hat, kann in deinen Kanal schreiben. HocDoc zeigt sie deshalb nach dem Speichern nicht mehr an. In der Liste und im Zustell-Log stehen nur der Name der Adresse und ihr Ende. Eine Adresse bearbeiten geht nicht: Lösche den Kanal und lege ihn neu an.

## Kanäle verwalten

Die Karte sagt, wie viele Kanäle du hast („2 von 5 Kanälen angelegt.“). Solange es keinen gibt, steht dort „Noch kein Kanal“. Jeder Kanal zeigt Dienst, Beschreibung, Status, „Letzte Nachricht am“ mit Datum und Uhrzeit oder „Noch nichts gesendet“, bei einem Fehlschlag „Letzter Fehlschlag am“ und „Angelegt am“ mit der Person, die ihn angelegt hat. Zeiten stehen in der Zeitzone des Workspace.

Der Status ist **Aktiv**, **Pausiert** oder **Automatisch pausiert**. An jedem Kanal steht ein Knopf: bei einem aktiven Kanal **Testnachricht senden**, bei einem pausierten **Fortsetzen**. Über das Menü daneben erreichst du **Pausieren** (nur bei aktivem Kanal) und **Löschen**. Die Wirkung:

| Aktion | Wirkung |
| - | - |
| **Testnachricht senden** | Schickt die Testnachricht. |
| **Pausieren** | Solange der Kanal pausiert ist, geht nichts an ihn: „Pausiert am“ mit Datum. |
| **Fortsetzen** | Der Kanal bekommt wieder Nachrichten. |
| **Löschen** | Nach der Bestätigung im Dialog „Kanal löschen“ bekommt der Kanal keine Nachrichten mehr. Das Zustell-Log dieses Kanals wird mit gelöscht. Das lässt sich nicht rückgängig machen. |

Scheitern mehrere Nachrichten an einen Kanal endgültig hintereinander, pausiert HocDoc ihn selbst, wie bei den Endpunkten der [Webhooks](/guides/einstellungen#webhooks). Der Kanal zeigt dann „Automatisch pausiert am“ mit der Zahl der gescheiterten Nachrichten. Prüfe die Adresse und wähle dann **Fortsetzen**.

### Grenzen

* Ein Workspace hat höchstens 5 Kanäle, Slack und Teams zusammen. Die Kanäle zählen nicht auf die 5 Endpunkte der Webhooks. Ist die Obergrenze erreicht, steht: „Die Obergrenze ist erreicht. Lösche einen Kanal, um einen neuen anzulegen.“
* Ein Konto legt höchstens in 20 Workspaces Webhooks oder Kanäle an. Ist das erreicht, steht: „Du hast bereits in 20 Workspaces Webhooks angelegt. Lösche zuerst die Einträge in einem Workspace, in dem du sie nicht mehr brauchst.“
* Zustellung, Wiederholung und Pause sind dieselben wie bei den Webhooks. Das Ergebnis jeder Nachricht steht im **Zustell-Log**, auch das der Testnachricht.
* Zu viele Tests in kurzer Zeit lehnt HocDoc ab: „Zu viele Tests in kurzer Zeit. Bitte versuche es in einigen Minuten erneut.“

## Verbindungen zu HubSpot und Pipedrive (in Vorbereitung)

In den Einstellungen im Reiter **Integrationen** steht die Karte **Verbindungen**. Sie sagt: „Verbinde HocDoc mit Diensten, die du schon nutzt. Versand, erste Öffnung und Annahme landen dann dort.“ Dort stehen **HubSpot** und **Pipedrive** mit dem Status **In Vorbereitung**. Es gibt noch keinen Knopf zum Verbinden.

Geplant ist, dass HocDoc zu jedem Angebot einen Kontakt, einen Deal und Notizen anlegt und den Deal bei der Annahme auf gewonnen setzt. Wann das freigeschaltet wird, steht noch nicht fest. Sobald es so weit ist, beschreibt diese Seite die Einrichtung.

Die Karte sehen alle Rollen. Bis dahin richtest du Benachrichtigungen mit Slack oder Teams ein oder verbindest eigene Systeme über [Webhooks](/guides/einstellungen#webhooks) und die [API](/api/introduction).


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