Slack-Integration

Erhalten Sie eine Nachricht in einem Slack-Channel, wenn Ihr Feedback Aufmerksamkeit braucht. Voxtrics postet aus einer Warnung in Slack: einer Regel, die eingehende Antworten beobachtet, zum Beispiel „mindestens 3 Bewertungen von 2 oder weniger innerhalb einer Stunde“. Slack wird über einen Incoming Webhook angebunden, eine Webadresse, die Slack Ihnen für einen Channel gibt – auf Seiten von Voxtrics muss also nichts installiert werden.

Einen Webhook in Slack erstellen

Sie brauchen die Berechtigung, Ihrem Slack-Workspace Apps hinzuzufügen. Wenn in Ihrem Workspace nur Admins Apps genehmigen, fragt Slack zuerst einen von ihnen.

Öffnen Sie Ihre Slack-Apps, klicken Sie auf Create New App und wählen Sie From scratch.
Geben Sie der App einen Namen, zum Beispiel Voxtrics, wählen Sie Ihren Workspace und klicken Sie auf Create App.
Öffnen Sie in den Einstellungen der App Incoming Webhooks und schalten Sie Activate Incoming Webhooks ein.
Klicken Sie auf Add New Webhook to Workspace, wählen Sie den Channel, in den die Warnungen gehen sollen, und erlauben Sie den Zugriff. Bei einem privaten Channel treten Sie ihm zuerst bei.
Kopieren Sie die neue URL unter Webhook URLs for Your Workspace. Sie sieht so aus: https://hooks.slack.com/services/T0000/B0000/XXXXXXXX.

Die Anleitung von Slack selbst zu Incoming Webhooks: Sending messages using incoming webhooks.

Jeder, der die Webhook-URL hat, kann in den Channel posten. Halten Sie sie von öffentlichen Orten wie Code-Repositories fern: Slack deaktiviert Webhook-URLs, die es veröffentlicht findet.

Warnungen an Slack senden

Gehen Sie zu Warnungen und klicken Sie auf Neue Warnung oder bei einer bestehenden Regel auf das Stiftsymbol (Bearbeiten).
Legen Sie Name, Geltungsbereich, Zeitfenster und Bedingung der Regel fest, wie unter Warnungen beschrieben.
Wählen Sie unter Benachrichtigen über die Option Slack und fügen Sie die URL in Slack-Webhook-URL ein.
Klicken Sie auf Warnung erstellen bzw. bei einer bestehenden Regel auf Änderungen speichern.

Ein Webhook postet nur in den Channel, für den er erstellt wurde. Um Warnungen auch in einem anderen Channel zu bekommen, erstellen Sie einen Webhook für diesen Channel und eine eigene Regel dafür. Mehrere Regeln können denselben Webhook verwenden.

Was in der Nachricht steht

Jedes Mal, wenn die Regel auslöst, bekommt der Channel eine kurze Textnachricht mit dem Namen der Regel, der Domain, der Anzahl der passenden Antworten im Zeitfenster und dem Grund für die Auslösung. Die Antworten selbst stehen nicht darin: Öffnen Sie die Auslösung unter Warnungen, um sie zu sehen.

Eine Regel löst höchstens einmal alle 30 Minuten aus, oder seltener, wenn Sie eine Drosselung festlegen. Die Warnungen eines Space posten zusammen höchstens 200 Nachrichten pro Tag an Slack und Telegram. Darüber hinaus löst eine Regel zwar weiterhin aus und die Auslösung erscheint unter „Warnungen“, gepostet wird aber nichts.

Wenn keine Nachrichten ankommen

Wenn sich die Warnung nicht speichern lässt, prüfen Sie, ob die URL mit https://hooks.slack.com/ beginnt. Voxtrics akzeptiert nur die Webhook-Adressen von Slack, keinen Link zu einem Channel oder einer Nachricht.
Prüfen Sie, ob die Regel aktiviert ist und ausgelöst hat: Jede Auslösung ist unter Warnungen aufgeführt.
Wenn die Regel ausgelöst hat, aber nichts in Slack angekommen ist, funktioniert der Webhook nicht mehr: Die App wurde entfernt, der Channel archiviert oder gelöscht, oder Slack hat die URL deaktiviert. Erstellen Sie einen neuen Webhook und fügen Sie ihn in die Regel ein.