Anleitung für die Integration von Slack

Wenn Du zu irgendeinem Zeitpunkt Unterstützung bei den unten aufgeführten Schritten benötigst, reiche bitte eine Anfrage unten ein.

Überblick über die Integration

Die Integration von Beekeeper mit Slack unterstützt derzeit die folgenden Anwendungsfälle:

• Mit einem einzigen Klick Mitteilungen aus einem Slack-Kanal in einem Beekeeper-Stream veröffentlichen. Kommentare und Likes dazu werden ebenfalls auf beiden Plattformen angezeigt.
• Formulareingaben in Beekeeper direkt an einen Slack-Kanal weiterleiten

Anforderungen

• Du benötigst Zugriff auf ein Benutzerkonto mit globalen Admin-Berechtigungen in dem Beekeeper-Mandanten, für den Du die Integration konfigurieren möchtest.
• Du musst die Slack-Team-ID kennen, die Du verbinden möchtest. Um die Slack-Team-ID zu erhalten, logge Dich über einen Webbrowser im Workspace von Slack ein. Kopiere und speichere den Teil der URL, der nach dem Buchstaben „T“ und vor dem nächsten „/“ kommt.
  Beispiel: In der URL https://app.slack.com/client/T039WNM5G/C01AW9YT4G7 ist „T039WNM5G“ die Team-ID.
  

Derzeit kann nur ein Slack-Workspace mit einem Beekeeper-Mandanten verbunden werden.

Installieren der Beekeeper-App in Slack

1. Melde Dich im Slack-Workspace an, den Du mit Beekeeper integrieren möchtest.
   
   

2. Gehe zu Apps und gib „Beekeeper“ in der Suchleiste ein, wähle dann Beekeeper App.
   
   

3. Klicke auf Zu Slack hinzufügen
   
   
   
   

4. Wähle den Slack-Kanal, der mit Beekeeper synchronisiert werden soll, und klicke auf Zulassen.
   
   
   
   

5. Der folgende Text sollte nun erscheinen: „Successfully saved Slack authorization token“.
   
   

Installation der Slack-App im Beekeeper-Marketplace

1. Navigiere im Beekeeper-Admin-Bereich zu Erweiterungen > Marketplace.
   
   
2. Gib in der Suchleiste „Slack“ ein und klicke auf die Slack-App.
   
   
   
   
3. Klicke auf Installieren.
   
   
   
   
4. Nachdem die App installiert wurde, klicke auf Konfiguration.
   
   
   
   
5. Füge im Konfigurationsfeld Deine Slack-Team-ID wie unten gezeigt hinzu:
   

   {   
      "externalTenantId": "Gib hier Deine Slack-Team-ID ein"
   }

   
   
   
   
6. Klicke auf Validieren & speichern.

Wenn ein grünes Benachrichtigungsfeld folgt, wonach die App konfiguriert wurde, so war der Vorgang erfolgreich. Sobald die Integration konfiguriert wurde, kannst Du einen Testlauf durchführen. Die Schritt-für-Schritt-Anleitung dazu findest Du hier.

Optional: Beekeeper-Formulareingaben an Slack weiterleiten

Du kannst die Integration so einrichten, dass Beekeeper Formulareingaben automatisch an einen Kanal Deiner Wahl in Slack gesendet werden. Formulareingaben werden anonym an Slack gesendet. Du kannst mehrere Formulare mit einem Slack-Workspace verbinden.

1. Erstelle ein Formular im Beekeeper-Admin-Bereich. Die genaue Anleitung zur Erstellung von Formularen würde den Rahmen dieses Artikels sprengen. Jedoch findest Du die Schritt-für-Schritt-Anleitung hier.
   
   Die Anzahl der Fragen, die Du einem Formular hinzufügen kannst, ist nicht begrenzt. Beachte jedoch, dass die Integration Antwortfelder für Bilder und Zeichnen derzeit nicht unterstützt (eingereichte Antworten, die diese Formate verwenden, werden in Slack leer angezeigt).
   
   
2. Navigiere zu Erweiterungen > Maketplace > Angefordert/Installiert > Slack > Konfiguration
   
   
3. Aktualisiere die Konfiguration der Slack-App, indem Du den folgenden Abschnitt formsConfig hinzufügst:
   
   

   {
      "formsConfig":  [
         {
            "channel": "Beekeeper-Formular-ID hier einfügen",
            "formId": "Slack-Kanal-ID hier einfügen"
         }
      ],
      "externalTenantId": "Gib hier Deine Slack-Team-ID ein"
   }

• formId ist der letzte Teil der URL Deines Formulars (z. B. https://your-company.beekeeper.io/dashboard/forms/dfcb0e6c-c48b-4a73-b5d7-9fe23a2c80b9, siehe Screenshot unten).
  
  
  
  
• channel ist eine Slack-Kanal-ID, an die die Fragen gesendet werden. Es ist der letzte Teil der Slack-Kanal-URL. Die Kanal-ID beginnt mit C, wenn der Kanal öffentlich ist, und mit G, wenn der Kanal privat ist (z. B. https://app. slack.com/client/T028MTFUQUQ/C028107GFHD). 
  
  
  
  
• Wenn Du einen privaten Kanal für die Integration verwenden möchtest, muss der Beekeeper-App-Bot Mitglied des Slack-Kanals sein. Um den Beekeeper-App-Bot in den Kanal einzuladen, sende die folgende Nachricht im Kanal:
  
  „/invite @beekeeper“
  
  Wenn Du einen öffentlichen Kanal verbindest, muss dieser Schritt nicht ausgeführt werden.
  
  
• Wiederhole die Schritte 3 und 4 für jeden Slack-Kanal, in dem Beekeeper-Formulareingaben empfangen werden sollen. Unten findest Du eine Beispielkonfiguration für mehrere Beekeeper-Formulare, die mit verschiedenen Slack-Kanälen verbunden sind.
  

  {
     "externalTenantId": "Your Slack workspace ID", // REQUIRED
     "formsConfig": [ // OPTIONAL, array should (but doesn't need to) contain at least one object (see format below), needed to configure sharing form submissions
        {
           "formId": "dfcb0e6c-c48b-4a73-b5d7-9fe23a2c80b9",
           "channel": "C567EFGH8IJ"
        },
        {
           "formId": "9281ca9a-559e-11eb-ae93-0242ac130002",
           "channel": "C013VBKCX3P"
        },
        {
           "formId": "06f5f75c-34d6-4309-a313-8e2a4c473695",
           "channel": "C01AW9YT4G7"
        }
     ]
  }

• Klicke auf Validieren & speichern.
  
  
• ​​Mache das Beekeeper-Formular als Link zugänglich, z. B. in einem Beitrag oder als Verknüpfung.