Flip-Kanal hinzufügen

Übersicht

Nutze diese Anleitung, um einen Flip-Kanal in SocialHub zu integrieren. Dies umfasst alle Schritte von der Erstellung des benutzerdefinierten SocialHub-Kanals bis zur Authentifizierung. Zusätzlich erfährst du mehr über eingehende Flip-Tickets in der SocialHub Inbox.

Voraussetzungen

• Ein Flip-Konto mit mindestens einem Kanal
• Die Flip-Kanal-ID, die du integrieren möchtest
• Ein SocialHub Custom Channel Access Token
• OIDC-Client-Details von Flip:
  • OIDC Client ID (nicht die Client ID des Image Readers)
  • Öffentliche OIDC-Konfigurations-URL (well-known URI)
• Image-Reader-Client-Zugangsdaten von Flip:
  • Client ID und Client Secret für einen Client mit der Rolle USER und Zugriff auf Flip Media
  • Der Image-Reader-Client muss dem Flip-Kanal, den du integrierst, als Benutzer hinzugefügt werden
  • Der erste Flip-Benutzer, den du authentifizierst, sollte ein Moderator des Flip-Kanals sein (erforderlich für Löschungen aus SocialHub)

 

Schritt 1: Flip-Kanal-ID finden

• Melde dich bei Flip an.
• Wähle im linken Menü unter „Meine Kanäle“ den Kanal aus, den du verbinden möchtest.

• Kopiere die Kanal-ID aus dem letzten Teil des URL-Pfades des Kanals.

  
   

Schritt 2: Einen benutzerdefinierten Kanal in SocialHub erstellen

• Gehe zu Account -> Kanäle.
• Klicke auf „Kanal hinzufügen“.
• Klicke unter „Inbox API“ auf „Kanal hinzufügen“.
• Benenne den Kanal und füge ein Bild hinzu, klicke dann auf „Speichern“.
• Kopiere das Access Token und bewahre es für später auf.

Schritt 3: Die Authentifizierung (erster Benutzer)

Dies richtet die Verbindung ein und ermöglicht die Medienanzeige in SocialHub.

• Öffne das Flip-Integrationsformular von SocialHub unter https://integrations.production.socialhub.io/flip/auth
• Füge das SocialHub Custom Channel Access Token aus Schritt 2 ein.
• Klicke auf „Senden und Authentifizierung starten“.
• Auf der Konfigurationsseite:
  • Gib die von Flip bereitgestellte OIDC Client ID ein (nicht die Client ID des Image Readers).
  • Gib die von Flip bereitgestellte öffentliche OIDC-Konfigurations-URL (well-known URL) ein.
  • Füge die Flip-Kanal-ID aus Schritt 1 ein.
  • Klicke auf „Senden“.
  • Melde dich auf der Flip-Anmeldeseite mit deinem Flip-Benutzernamen und Passwort an. Der erste authentifizierte Benutzer sollte ein Moderator des ausgewählten Flip-Kanals sein.
  • Wenn du dazu aufgefordert wirst, gib die Client ID und das Client Secret des Image Readers ein. Dieser Client muss über die Rolle „USER“ verfügen, Zugriff auf Flip-Medien haben und zum Flip-Kanal hinzugefügt werden, damit Bilder in Beiträgen und Kommentaren in SocialHub angezeigt werden können.

Tipp: Wenn du an irgendeiner Stelle einen Fehler machst, kannst du den Vorgang mit demselben SocialHub Access Token neu starten.

Das war's! Du solltest die neuesten Flip-Posts und -Kommentare in den nächsten Minuten in der SocialHub Inbox sehen!

 

(optional) Schritt 3.2: Zusätzliche Flip-Benutzer authentifizieren

Die Authentifizierung eines Flip-Benutzers reicht aus, um Posts und Kommentare in SocialHub zu importieren. Um Antworten im Namen zusätzlicher Flip-Benutzer zu senden, authentifiziere sie ebenfalls.

• Wenn du noch von Schritt 3 bei Flip angemeldet bist, melde dich ab.
• Öffne das Flip-Integrationsformular in SocialHub.
• Füge dasselbe SocialHub Custom Channel Access Token ein, das du in Schritt 3 verwendet hast, und klicke dann auf „Senden und Authentifizierung starten“.
• Du wirst aufgefordert, dich bei Flip anzumelden. Melde dich mit den Zugangsdaten eines beliebigen Flip-Benutzers an, der Mitglied des ausgewählten Flip-Kanals ist.
• Wiederhole diesen Vorgang für jeden Flip-Benutzer, der von SocialHub aus antworten können soll.

So sieht es in der Inbox aus

Nachdem mindestens ein Flip-Benutzer authentifiziert wurde, fließen Flip-Posts und -Kommentare als Tickets in der SocialHub Inbox ein.

 

Ticket-Erstellungslogik

Die Integration fragt regelmäßig die Flip-API nach Posts ab, die in den letzten zwei Monaten erstellt oder geändert wurden.

Neue Posts werden immer zu neuen Tickets; aktualisierte Posts aktualisieren ihre entsprechenden Tickets. Auch Kommentare zu Posts aus den letzten zwei Monaten werden in Tickets umgewandelt.

Wichtig: Für jeden Post werden jeweils nur die neuesten 100 Kommentare (sortiert nach letzter Änderungszeit) abgefragt.

Kommentare zu Posts, die älter als zwei Monate sind, werden nicht importiert, selbst wenn der Kommentar selbst aktuell ist.

Ticket-Aktionen

• Antworten: Wenn du auf ein Ticket antwortest, wirst du gebeten, einen Flip-Benutzer auszuwählen, als der geantwortet werden soll. Dadurch wird ein neuer Kommentar auf Flip erstellt, der als neues Ticket in SocialHub importiert wird.
• Löschen: Löscht den entsprechenden Flip-Post oder -Kommentar. Diese Aktion wird als der zuerst authentifizierte Flip-Benutzer ausgeführt. Falls diesem Benutzer in Flip die notwendigen Berechtigungen fehlen, schlägt die Löschung fehl.
• Zuweisen, Taggen, per E-Mail weiterleiten, Archivieren: Diese Standard-SocialHub-Aktionen sind für Flip-Tickets verfügbar.

Wenn du Fragen hast oder Hilfe benötigst, lass es uns bitte wissen!