Skip to main content
Free Zendesk Themes

Add Flip channel

Updated

Overview

Use this guide to integrate a Flip channel with SocialHub. This includes all the steps from custom SocialHub channel creation through to authentication. In addition, you will learn about incoming Flip tickets in the SocialHub Inbox.


 

Prerequisites

  • A Flip account with at least one channel
  • The Flip channel ID you want to integrate
  • A SocialHub custom channel access token
  • OIDC client details from Flip:
    • OIDC Client ID (not the image reader client ID)
    • Public OIDC configuration URL (well-known URI)
  • Image reader client credentials from Flip:
    • Client ID and client secret for a USER-role client with access to Flip media
    • The image reader client must be added as a user to the Flip channel you are integrating
  • The first Flip user you authenticate should be a moderator of the Flip channel (required for deletions from SocialHub)


 

Step 1: Find your Flip channel ID

  • Log in to Flip.
  • In the left menu under “My Channels,” select the channel you want to connect.
  • Copy the channel ID from the last part of the channel’s URL path.

 

Step 2: Create a custom channel in SocialHub

  • Go to Account -> Channels.
  • Click “Add channel.”
  • Under “Inbox API,” click “Add channel.”
  • Name the channel and add an image, then click “Save.”
  • Copy the access token and keep it for later.


 

Step 3: Authenticate the integration (first user)

This sets up the connection and enables media display in SocialHub.

  • Open the Flip Integration form in SocialHub at https://integrations.production.socialhub.io/flip/auth 
  • Paste the SocialHub custom channel access token from Step 2. 
  • Click “Submit and start authentication.”
  • On the configuration page:
  • Enter the OIDC Client ID provided by Flip (not the image reader client ID).
  • Enter the public OIDC configuration URL (well-known URL) provided by Flip.
  • Paste the Flip channel ID from Step 1.
  • Click “Submit.”
  • Sign in on the Flip login page using your Flip username and password. The first authenticated user should be a moderator of the selected Flip channel.
  • When prompted, enter the image reader client ID and client secret. This client must have the role USER, access to Flip media, and be added to the Flip channel so images on posts and comments can display in SocialHub.

Tip: If you make a mistake at any point, you can restart the process using the same SocialHub access token.

That's it, you should see the latest Flip posts and comments in SocialHub in the next few minutes!

 


 

(optional) Step 3.2: Authenticate additional Flip users

Authenticating one Flip user is enough to import posts and comments into SocialHub. To send replies in the name of additional Flip users, authenticate them too.

  • If you are still logged into Flip from Step 3, log out.
  • Open the Flip Integration form in SocialHub.
  • Paste the same SocialHub custom channel access token used in Step 3, then click “Submit and start authentication.”
  • You will be prompted to log in to Flip. Sign in with the credentials of any Flip user who is a member of the chosen Flip channel.
  • Repeat for each Flip user who should be able to reply from SocialHub.


 

What you’ll see in the Inbox

After at least one Flip user is authenticated, Flip posts and comments are created as tickets in SocialHub.


 

Ticket creation logic

The integration regularly queries the Flip API for posts created or modified in the last month.

New posts always become new tickets; updated posts update their corresponding tickets. Also, comments on posts from the last month are converted to tickets.

Important: For each post, only the latest 100 comments (ordered by last modification time) are queried at a time.

Comments on posts older than one month are not imported, even if the comment itself is recent.

 

Ticket actions

Reply: When you reply to a ticket, you will be asked to choose a Flip user to reply as. This creates a new comment on Flip, which is imported into SocialHub as a new ticket.

Delete: Deletes the corresponding Flip post or comment. This action is performed as the first authenticated Flip user. If that user lacks the necessary permissions in Flip, the delete will fail.

Assign, tag, forward by email, archive: These standard SocialHub actions are available for Flip tickets.

 

If you have any questions or require assistance, please let us know!


 

Related to

Related articles