Webhook in Slack erzeugen

1. Slack-App erstellen (falls du noch keine hast)

Slack-App erstellen

Wähl einen Namen und einen Workspace, dem deine App zugeordnet werden soll (denk daran, dass du wahrscheinlich viele Testnachrichten posten wirst – vielleicht lohnt sich ein eigener Channel zum Testen), und klick dann auf Create App. Wenn du schon eine App erstellt hast, kannst du stattdessen diese verwenden.

2. Incoming Webhooks für deine Slack-App aktivieren

Nachdem du deine Slack-App erstellt hast, wirst du zur Einstellungsseite der neuen App weitergeleitet (wenn du eine vorhandene App verwendest, öffne ihre Einstellungen einfach über das Verwaltungs-Dashboard deiner Apps).

Wähl dort die Funktion Incoming Webhooks aus und aktiviere den Schalter Activate Incoming Webhooks.

3. Incoming Webhook für deinen Slack-Workspace erstellen

Sobald Incoming Webhooks aktiviert sind, sollte sich die Einstellungsseite neu laden und einige zusätzliche Optionen anzeigen. Eine davon ist ein sehr praktischer Button mit der Aufschrift Add New Webhook to Workspace, auf den du klicken solltest.

Dieser Button startet eine verkürzte Version des Installationsablaufs für Slack-Apps. Sie ist komplett in sich geschlossen, sodass du keinen Code schreiben musst, um eine Incoming-Webhook-URL zu erzeugen. Du siehst dann ungefähr diesen Bildschirm:

Wähl einen Channel, in dem die App posten soll, und klick dann auf Authorize. Wenn du den Incoming Webhook zu einem privaten Channel hinzufügen möchtest, musst du zuerst Mitglied dieses Channels sein.

Du landest wieder in deinen App-Einstellungen und solltest jetzt im Bereich Webhook URLs for Your Workspace einen neuen Eintrag sehen, mit einer Webhook-URL, die etwa so aussieht:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Diese URL ist dein brandneuer Incoming Webhook, der für genau einen Nutzer und genau einen Channel gilt.

Slack-Webhook-URL im Commentful-Plugin hinzufügen

Um die Slack-Benachrichtigungen von Commentful einzurichten, erstell eine Slack-Webhook-URL, wie oben beschrieben. Klick dann im Figma-Plugin Commentful auf das Symbol Settings (oben rechts im Plugin-Fenster) und auf Enable webhook notifications for review links, achte darauf, dass im Dropdown Webhook Platform die Option Slack ausgewählt ist, füge deine Slack-Webhook-URL ein und klick auf Save Webhook URL:

zum Beispiel https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Ob die Slack-Integration funktioniert, prüfst du mit einem Klick auf Send Test Message. Commentful sendet dann eine Testbenachrichtigung in deinen Slack-Channel.

Slack-Webhook-URL in der Commentful-Web-App hinzufügen

Um die Slack-Benachrichtigungen von Commentful einzurichten, erstell eine Slack-Webhook-URL, wie oben beschrieben. Öffne dann einen geteilten Review-Link im Browser, drück in der Commentful-Web-App auf deiner Tastatur CTRL + K und füge deine Slack-Webhook-URL ein:

zum Beispiel https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Ob die Slack-Integration funktioniert, prüfst du mit einem Klick auf Send Test Message to Slack. Commentful sendet dann eine Testbenachrichtigung in deinen Slack-Channel.

Slack-Webhook-Benachrichtigungen gehen als Channel-Benachrichtigungen an den von dir gewählten Slack-Channel. Wenn deine Commentful-Kommentare Text wie @name enthalten, zeigt Slack diesen Text möglicherweise im Nachrichtentext an. Commentful ordnet Commentful-Reviewer aber nicht automatisch Slack-Nutzern zu, echte Slack-Erwähnungen sind also nicht garantiert.