# Stripe Workflows für Slack Senden Sie automatisierte Benachrichtigungen aus Stripe Workflows an Slack-Kanäle. Nutzen Sie die App „Stripe Workflows für Slack“, um automatisierte Benachrichtigungen an Ihre Slack-Kanäle zu senden, sobald Ereignisse in Stripe eintreten. Kombinieren Sie dies mit [Stripe Workflows](https://docs.stripe.com/workflows.md), um Ihr Team in Echtzeit über Zahlungen, Abonnements, Streitfälle und andere Stripe-Ereignisse zu informieren. Die App bietet Unterstützung für: - **Benutzerdefinierte Nachrichtenvorlagen**: Fügen Sie dynamische Daten aus Stripe-Ereignissen ein und formatieren Sie Nachrichten mit den Textformatierungsfunktionen von Slack. - **Deep Links zum Dashboard**: Fügen Sie optional in jede Benachrichtigung einen Link zur entsprechenden Seite im Stripe-Dashboard ein. - **Mehrere Kanäle**: Leiten Sie verschiedene Benachrichtigungen entsprechend Ihrer Workflow-Logik an unterschiedliche Slack-Kanäle weiter. ## App installieren 1. Suchen Sie die **Slack**-App im [Stripe App Marketplace](https://marketplace.stripe.com/). 1. Wählen Sie aus der Dropdown-Liste „Konto“ das Konto aus, auf dem Sie die App installieren möchten. 1. Klicken Sie auf **Installieren**. Nach der Installation wird die App als Symbol in der rechten Seitenleiste auf jeder Seite des Kontos angezeigt, auf dem Sie sie installiert haben. Suchen Sie das Symbol in der oberen rechten Ecke Ihres Bildschirms neben der Schaltfläche **Apps**. ## Mit Slack verbinden Nachdem Sie die App installiert haben, verbinden Sie sie mit einem Slack-Workspace: 1. Öffnen Sie die App über die rechte Seitenleiste. Sie werden aufgefordert, die Einstellungsseite der App aufzurufen. 1. Klicken Sie in der App auf den Link **Zu den Einstellungen** oder klicken Sie mit der rechten Maustaste auf das Überlaufmenü (⋯) in der oberen rechten Ecke und wählen Sie **App-Einstellungen anzeigen**. 1. Klicken Sie auf der Einstellungsseite auf den Link **Zu Slack hinzufügen**. 1. Wählen Sie den Arbeitsbereich, mit dem Sie eine Verbindung herstellen möchten, aus der Dropdown-Liste aus. Auf dieser Seite werden die Berechtigungen angezeigt, die die App anfordert, um grundlegende Kanalinformationen lesen und Nachrichten senden zu können. 1. Klicken Sie auf **Zulassen**, um die Verbindung herzustellen. Auf der Einstellungsseite wird „Verbunden mit “ angezeigt, sobald die Verbindung erfolgreich hergestellt wurde. Sollte die Verbindung nicht sofort angezeigt werden, aktualisieren Sie die Seite. Um den verbundenen Arbeitsbereich zu ändern, klicken Sie auf der Einstellungsseite auf **Verbindung entfernen** und wiederholen Sie den Vorgang, um einen anderen Arbeitsbereich auszuwählen. ## Kanäle konfigurieren ### Kanal hinzufügen Kanäle von Slack aus hinzufügen: 1. Öffnen Sie den Kanal, den Sie aktivieren möchten. 1. Geben Sie im Kanal „/invite @Stripe“ ein. 1. Stripe wird dem Kanal hinzugefügt und ist in der Liste **Kanäle** der App zu sehen. Falls es nicht sofort angezeigt wird, klicken Sie auf **Aktualisieren**, um die Liste zu aktualisieren. ### Einen Kanal entfernen Kanäle in Slack entfernen: 1. Öffnen Sie den Kanal, den Sie entfernen möchten. 1. Geben Sie im Kanal „/remove @Stripe“ ein. 1. Bestätigen Sie die Entfernung, wenn Sie dazu aufgefordert werden. Klicken Sie in der Stripe-App auf **Aktualisieren**, um die Liste zu aktualisieren. ### Senden Sie eine Testbenachrichtigung Auf der Seite mit den App-Einstellungen in Stripe können Sie überprüfen, ob ein Kanal verbunden ist: 1. Klicken Sie neben dem Kanalnamen auf **Test**. 1. Die Schaltfläche zeigt vorübergehend „Senden…“ an und bestätigt anschließend, dass der Test gesendet wurde. 1. Überprüfen Sie den Kanal in Slack. Eine Testnachricht von der App bestätigt, dass der Kanal verbunden und bereit ist, Benachrichtigungen zu empfangen. ## Erstellen Sie einen Workflow mit Slack-Benachrichtigungen Sie finden **Workflows** in der linken Menüleiste von Stripe, entweder im Abschnitt **Shortcuts** oder unter **Produkte** > **Mehr**. So fügen Sie eine Slack-Benachrichtigung zu einem Workflow hinzu: 1. Klicken Sie auf **Workflow erstellen**. 1. Fügen Sie Ihren Auslöser sowie alle vorangehenden Schritte hinzu, die die benötigten Daten bereitstellen. 1. Klicken Sie auf **Schritt hinzufügen** und wählen Sie **Aktion hinzufügen** aus. 1. Suchen Sie nach „Slack“ oder wählen Sie das Tag **Apps** aus und wählen Sie anschließend **Slack-Benachrichtigung senden**. ### Konfigurieren Sie die Aktion Das Fenster **Bearbeiten** enthält drei Pflichtfelder: | Feld | Beschreibung | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Slack-Kanal** | Wählen Sie den Kanal für die Benachrichtigung aus der Dropdown-Liste aus. Diese Liste enthält alle Kanäle, für die Sie der App das Senden von Nachrichten gestattet haben. | | **Nachrichtenvorlage** | Geben Sie den Text der Benachrichtigung ein. Klicken Sie auf die Schaltfläche **+** in der unteren rechten Ecke des Eingabefelds, um Variablen aus Ihrem Auslöser oder vorherigen Schritten einzufügen. Sie können den Text auch mithilfe der [Nachrichtenformatierung](https://docs.stripe.com/use-stripe-apps/stripe-workflows-slack.md#format-messages) gestalten. | | **Dashboard-Link einfügen** | Wählen Sie **wahr**, um einen Deep Link zur entsprechenden Seite im Stripe-Dashboard einzufügen. Bei der Einstellung **wahr** wird ein zusätzliches Feld **Ereignisobjekt-ID** angezeigt. Geben Sie dort die ID des Objekts ein, zu dem Sie einen Link erstellen möchten und verwenden Sie dazu eine Variable aus Ihrem Auslöser oder einem vorherigen Schritt. | > Fügen Sie vor der Konfiguration dieser Aktion einen Auslöser oder einen Datenschritt hinzu. Das Pluszeichen (+) zum Einfügen von Variablen wird nur angezeigt, wenn ein vorhergehender Schritt auswählbare Daten bereitstellt. Um den Workflow zu testen, klicken Sie auf **Veröffentlichen**. Führen Sie in einer Sandbox-Umgebung die Auslöseraktion aus und überprüfen Sie, ob die Benachrichtigung in Ihrem Slack-Kanal angezeigt wird. Anschließend können Sie den Workflow bearbeiten und bei Bedarf erneut veröffentlichen. ### Formatieren Sie Nachrichtenvorlagen Nachrichtenvorlagen unterstützen die meisten Textformatierungsfunktionen von Slack: | Syntax | Ergebnis | | -------------- | ------------------------ | | `_text_` | *kursiver Text* | | `*text*` | **fett gedruckter Text** | | `~text~` | Durchgestrichener Text | | `> text` | Angebot blockieren | | `code` | Inline-Code | | `code` | Codeblock | | `:emoji-name:` | Emoji mit Namen | Zeilenumbrüche in der Texteingabe bleiben beim Senden an Slack erhalten. Erstellen Sie Listen, indem Sie ein Symbol gefolgt von einem Leerzeichen verwenden: ```text * Item 1 * Item 2 ``` Für nummerierte Listen: ```text 1. Item 1 2. Item 2 ``` #### URL-Hyperlinks hinzufügen Um eine URL mit benutzerdefiniertem Text anzuzeigen, verwenden Sie spitze Klammern mit einem Pipe-Zeichen als Trennzeichen: ```text ``` #### Erwähnen Sie Nutzer/innen, Kanäle und Gruppen Verwenden Sie Slack-IDs (nicht Anzeigenamen), um Nutzer/innen, Kanäle und Gruppen in Ihren Nachrichtenvorlagen zu erwähnen: | Typ | Syntax | So finden Sie die ID | | --------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Nutzer/in | `<@U012AB3CD>` | Öffnen Sie das Benutzerprofil in Slack, klicken Sie auf das Überlaufmenü (⋯) und wählen Sie **Mitglieder-ID kopieren**. | | Kanal | `<#C123ABC456>` | Klicken Sie auf das Überlaufmenü (⋯) eines Kanals, wählen Sie **Kanal-Details öffnen** und kopieren Sie die Kanal-ID unten. | | Gruppe | `` | Es sind Administratorrechte erforderlich. Entnehmen Sie die Gruppen-ID der URL, wenn Sie das Profil der Benutzergruppe aufrufen. | | Spezial | ``, ``, `` | Verwenden Sie diese, um alle, aktive Mitglieder oder alle Kanalmitglieder zu erwähnen. | ## Beispiele für Workflows ### Benachrichtigung bei hohen Zahlungen versenden Erstellen Sie einen Workflow, der einen Kanal benachrichtigt, wenn eine Zahlung über 1.000 USD eingeht: 1. Klicken Sie auf **Auslöser hinzufügen** und wählen Sie **Payment Intent erfolgreich** aus. 1. Klicken Sie unter **Auslösebedingungen** auf **Bedingung hinzufügen**. Legen Sie die Bedingung fest: **Erhaltener Betrag** ist größer oder gleich 1.000,00 USD. 1. Klicken Sie auf **Schritt hinzufügen** und wählen Sie **Aktion hinzufügen**. Suchen Sie nach **Kundinnen und Kunden abrufen** und legen Sie die **Kunden-ID** fest, indem Sie das Plus-Symbol (+) verwenden, um die **Kunden-ID** aus dem Auslöser auszuwählen. 1. Klicken Sie auf **Schritt hinzufügen** und wählen Sie **Aktion hinzufügen**. Suchen Sie nach **Slack-Benachrichtigung senden** und konfigurieren Sie diese: - **Slack-Kanal**: Wählen Sie Ihren Kanal aus (zum Beispiel `#wins`). - **Nachrichtenvorlage**: Verfassen Sie Ihre Nachricht unter Verwendung von Variablen. Zum Beispiel: ```text *Big win!* :tada: We just closed a large deal! {Payment intent | Amount received} from {Customer | Name} {Payment intent | Description} Payment processed on {Payment intent | Created} ``` - **Dashboard-Link einfügen**: Setzen Sie den Wert auf **wahr**. - **Ereignisobjekt-ID**: Wählen Sie die **Payment Intent-ID** aus dem Auslöser aus. 1. Klicken Sie auf **Veröffentlichen** und senden Sie eine Testzahlung, um den Workflow in Aktion zu sehen. Dieses Beispiel veranschaulicht Auslösebedingungen, das Abrufen von Daten aus verbundenen Objekten, das Erstellen von Nachrichten mit Variablen sowie das Einfügen von Dashboard-Deep-Links. ### Weiterleiten von Benachrichtigungen nach Abonnementtyp Erstellen Sie einen Workflow, der Benachrichtigungen an verschiedene Kanäle sendet, je nachdem, für welchen Abonnementtarif sich Kundinnen und Kunden angemeldet haben: 1. Klicken Sie auf **Workflow erstellen** und legen Sie den Auslöser auf **Kundenabonnement wurde erstellt** fest. 1. Fügen Sie die Aktion **„Slack-Benachrichtigung senden“** hinzu, um einen allgemeinen Kanal über alle neuen Abonnements zu informieren: - **Slack-Kanal**: Wählen Sie Ihren allgemeinen Abonnement-Kanal aus. - **Nachrichtenvorlage**: Zum Beispiel: „Benachrichtigung über neues Abonnement! {Subscription | Description}“. - **Dashboard-Link einfügen**: Setzen Sie diese Option auf **wahr** und die **Ereignisobjekt-ID** auf die **Abonnement-ID**. 1. Fügen Sie eine Aktion **Kundinnen und Kunden abrufen** hinzu und legen Sie die **Kunden-ID** über das Plus-Symbol fest (+). 1. Fügen Sie einen Schritt **Bedingung** hinzu, um den Workflow zu verzweigen: - Legen Sie die Bedingung so fest, dass geprüft wird, ob **Posten (Sammlung)** aus dem Auslöser mindestens einen Posten enthalten, bei dem **Preis** > **Produkt-ID** Ihrem Enterprise-Plan entspricht. 1. Fügen Sie im **wahr**-Zweig eine Aktion **Slack-Benachrichtigung senden** hinzu: - **Slack-Kanal**: Wählen Sie Ihren Kanal `#enterprise` aus. - **Nachrichtenvorlage**: Zum Beispiel: „Neuer Enterprise-Kunde! Willkommen {Customer | Name} in unserer Gruppe!“ - **Dashboard-Link einfügen**: Setzen Sie den Wert auf **wahr** und die **Ereignisobjekt-ID** auf die **Kunden-ID**. 1. Fügen Sie auf dem Zweig **falsch** die Aktion **Slack-Benachrichtigung senden** hinzu: - **Slack-Kanal**: Wählen Sie Ihren Kanal `#hobby` aus. - **Nachrichtenvorlage**: Zum Beispiel: „Ein neuer Hobbyist ist eingetroffen! Willkommen {Customer | Name} im Team!“ - **Dashboard-Link einfügen**: Setzen Sie den Wert auf **wahr** und die **Ereignisobjekt-ID** auf die **Kunden-ID**. Dieses Beispiel veranschaulicht mehrere Slack-Benachrichtigungen an verschiedene Kanäle, bedingte Workflow-Logik sowie Nachrichten, die durch Daten aus mehreren Schritten zusätzlichen Kontext liefern.