Zum Hauptinhalt springen

Slack

Reelwire lädt jedes Video über eine eigene Slack-App in einen Slack-Kanal hoch: Eine App, die nur für Ihren Workspace gemacht ist, braucht keine Prüfung durch Slack, nur zwei Berechtigungen und einen Platz im Kanal.

Was Sie brauchen​

  • Ein Bot-Token Ihrer Slack-App, das mit xoxb- beginnt, mit den Berechtigungen files:write und chat:write und ausgeschalteter Token-Rotation: Ein rotierendes Token funktioniert nach zwölf Stunden nicht mehr.
  • Die Kanal-ID des Kanals, in den gepostet wird, wobei die App diesem Kanal hinzugefügt ist.

Einrichten​

  1. App erstellen. Öffnen Sie api.slack.com/apps und klicken Sie auf Create New App. Slack zeigt zuerst seine Vorlagen an; wählen Sie unter Or start your own way die Option From a manifest und klicken Sie auf Weiter.

  2. Manifest einfügen. Wechseln Sie zu YAML und ersetzen Sie, was dort steht, durch die Zeilen unten. Ändern Sie Reelwire an beiden Stellen in den Namen, den Beiträge zeigen sollen, wählen Sie Ihren Workspace und klicken Sie auf Next.

    display_information:
      name: Reelwire
      description: Posts our short-form videos into Slack.
    features:
      bot_user:
        display_name: Reelwire
        always_online: false
    oauth_config:
      scopes:
        bot:
          - chat:write
          - files:write
          - channels:read
    settings:
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false

    Es gibt der App genau das, was sie braucht: chat:write und files:write, um das Video zu posten, und channels:read, damit Reelwire den Kanal nach der Prüfung benennen kann (ohne diese Berechtigung wird trotzdem gepostet). Die Token-Rotation bleibt ausgeschaltet.

  3. Erstellen und installieren. Slack zeigt, was die App darf: Post messages, Files und Kanäle. Klicken Sie auf Create and Install und, wenn Slack fragt, auf Allow.

  4. Token kopieren. Öffnen Sie in den Einstellungen der App OAuth & Permissions (oder Install App) und kopieren Sie das Bot User OAuth Token, das mit xoxb- beginnt. Behalten Sie es für sich: Wer es besitzt, kann als die App posten.

  5. App zum Kanal hinzufügen. Öffnen Sie in Slack die Details des Kanals (sein Name oben), wählen Sie den Tab Agents & apps, klicken Sie auf Add Agent or App und dann auf Hinzufügen neben Ihrer App. Dasselbe erreichen Sie, wenn Sie im Kanal /invite @ und den Namen der App senden. Ohne das lehnt Slack jeden Beitrag ab.

  6. Kanal-ID finden. Sie steht am Ende des Tabs Info in den Kanaldetails, beginnt mit C (bei manchen privaten Kanälen mit G), etwa C0123456789, mit einer Schaltfläche zum Kopieren. Es ist nicht der Name des Kanals.

  7. Beides in Reelwire eintragen. Öffnen Sie unter Kanäle die Einstellungen des Kanals, wählen Sie Slack als Plattform und das Seitenverhältnis und fügen Sie unter Per Plattform-Connector übergeben das Bot-Token und die Kanal-ID ein. Schalten Sie ihn neben dem Namen des Abschnitts ein.

  8. Plattform-Connector testen. Reelwire fragt Slack, ob das Token funktioniert, ohne etwas zu posten, und zeigt unter der Schaltfläche die App und den Workspace an, oder den Grund von Slack.

  9. Speichern.

Beiträge zeigen den Namen und das Bild der App. Geben Sie ihr ein Bild unter Basic Information, Display Information, App icon: ein Quadrat von mindestens 512 Pixeln.

Lieber klicken als einfügen? Wählen Sie in Schritt 1 Blank app und benennen Sie sie. Fügen Sie unter OAuth & Permissions, Scopes, Bot Token Scopes files:write und chat:write hinzu (und channels:read, wenn Sie möchten), klicken Sie auf der gleichen Seite auf die Schaltfläche Install to und machen Sie mit Schritt 4 weiter.

Wie ein Beitrag aussieht​

Das Video, in den Kanal hochgeladen und dort abgespielt, mit dem Text daneben als Nachricht: den eigenen Worten des Beitrags, der Zeile der Marke, dem Link und den Hashtags, bis zu 4.000 Zeichen.

Änderungen und Entfernungen​

Löschanfrage senden löscht das Video und seine Nachricht. Slack gibt einer App keine Möglichkeit, den Text neben einer Datei zu ändern, die sie geteilt hat, daher sagt Aktualisierungsanfrage senden das: Löschen Sie den Beitrag und posten Sie ihn erneut, oder bearbeiten Sie die Nachricht manuell in Slack.

Wenn etwas nicht stimmt​

Der Beitrag meldetWas zu tun ist
Slack hat das Token abgelehntKopieren Sie das Bot User OAuth Token erneut aus OAuth & Permissions und speichern Sie es. Wenn es zwölf Stunden funktioniert hat und dann aufgehört hat, ist die Token-Rotation eingeschaltet, was Slack nicht wieder ausschalten kann: Erstellen Sie aus dem Manifest oben eine neue App.
Der Slack-App fehlt eine benötigte BerechtigungFügen Sie files:write und chat:write hinzu, installieren Sie die App neu und speichern Sie ihr neues Token.
Die Slack-App ist nicht in diesem KanalFügen Sie sie dem Kanal hinzu (Schritt 5), dann Beitragsanfrage erneut senden unter Mehr auf der Seite Beiträge.
Slack findet diesen Kanal nichtPrüfen Sie die Kanal-ID: Sie beginnt mit C und steht am Ende des Tabs Info in den Kanaldetails. Fügen Sie die App zuerst hinzu, wenn der Kanal privat ist.
Dieser Slack-Kanal ist archiviertHeben Sie die Archivierung in Slack auf oder tragen Sie die ID eines anderen Kanals ein.
Slack hat das Video nicht angenommenDatei-Uploads sind in Ihrem Slack-Workspace ausgeschaltet oder auf weniger als die Größe des Clips begrenzt: Fragen Sie die Person, die ihn verwaltet.

Um es anzuhalten, schalten Sie den Connector am Kanal aus. Um es endgültig zu beenden, entfernen Sie die App in Slack unter dem Namen Ihres Workspaces oben links, Tools & settings, Manage apps, was ihr Token widerruft, oder löschen Sie sie am Ende von Basic Information auf api.slack.com.