Skip to main content
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.“
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.

​
Welche Nachrichten kommen

Du bekommst drei Nachrichten. Du kannst sie nicht einzeln abwählen. 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).

​
Kanal einrichten

1

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

Dialog öffnen

Öffne Einstellungen, dann den Reiter Integrationen. In der Karte Benachrichtigungen wählst du Kanal hinzufügen.
3

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.“
4

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

​
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/ 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: Scheitern mehrere Nachrichten an einen Kanal endgültig hintereinander, pausiert HocDoc ihn selbst, wie bei den Endpunkten der 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 und die API.