Instagram Pro Connector User Manual
  • 18 May 2023
  • 5 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Instagram Pro Connector User Manual

  • Dark
    Light
  • PDF

Article summary

OBTAINING THE INSTAGRAM PROFILE ID

Before creating a flow using the Instagram Pro Connector, you will need to obtain the Instagram Profile ID that is associated with the Instagram business account that you will be archiving posts from.

  1. Navigate to https://developers.facebook.com/tools/explorer/

  2. Hover over Tools menu and click on the Graph API Exploreroption
    2020-08-13_9-26-29.png

  3. Select the Facebook App that was used in the Instagram Pro Connector Installation Guide
    2020-09-14_10-56-11.png

  4. Enter the string below into the search bar and click on the Submit button
    me/accounts?fields=instagram_business_account{name},name
    2020-09-25_15-32-09.jpg

  5. Locate the Instagram Business Account that you would like to use to archive posts from and copy its Id value
    This will be needed later in the guide
    2020-09-03_8-17-23.png

SAMPLE FLOWS

We have provided a sample flow to archive posts from Instagram to Content Manager. The sample flow will help you get set up with the Instagram connector and can be used as a basis to design other flows:

  • Instagram Pro to CM Flow - This flow will archive posts/comments from Instagram to CM
Note

Before using these sample flows ensure you have completed all steps from the Power2CM Installation Guide and Instagram Pro Connector Installation Guide.

Before importing the sample, you need to create two connections in Power Automate:

  • Power2CM Connection
  • Instagram Pro Connection

CREATING A POWER2CM CONNECTION

  1. Once you have logged into Power Automate, click on Connections in the left menu under Data
    2020-09-23_15-03-16.png

  2. Click on the New connection button
    2020-09-23_15-04-08.png

  3. Type Power2CM into the search bar and click on the Power2CM Connector (name may vary depending on the name given for the connector in the Power2CM Installation Guide)
    2020-09-30_15-44-03.png

  4. Enter your Content Manager username and password into the username and password fields respectively

  5. Click on the Create button
    2020-09-30_15-45-26.png

  6. Your connection will now appear in the list of Power Automate connections. The status should state Connected
    2020-09-30_15-47-27.png

CREATING A INSTAGRAM PRO CONNECTION

  1. Once you have logged into Power Automate, click on Connections in the left menu under Data
    2020-09-23_15-03-16.png

  2. Click on the New connection byttib
    2020-09-23_15-04-08.png

  3. Type Instagram Pro Connector into the search bar and click on the Instagram Pro Connector (name may vary depending on the name given for the connector in the Instagram Pro Connector Installation Guide)
    2020-09-30_16-49-20.png

  4. Click Create
    2020-09-30_16-54-30.png

  5. Login using your Facebook Developer account and follow the prompts in the popup window

  6. Once complete, your connection will now appear in the list of Power Automate connections
    The status should say Connected
    2020-09-30_16-55-25.png

IMPORTING THE INSTAGRAM TO CM FLOW

  1. Once you have logged into Power Automate, click on My Flows in the left menu
    2020-09-23_15-21-48.png

  2. Click Import
    2020-09-23_15-24-46.png

  3. Click Upload
    2020-09-23_15-25-45.png

  4. Select the Instagram Pro to CM flow.zip file and click Open
    2020-09-23_16-28-45.png

  5. Once the file has finished uploading, you will be taken to the page below
    2020-09-23_16-30-51.png

  6. The connectors/connections (resources) found in the Related Resources table will need to be mapped to your current connectors/connections. This can be achieved by clicking the Select during import button found in the IMPORT SETUP column and then selecting the correct resource.

EXPORTED RESOURCERESOURCE TO MAP
Instagram Pro ConnectorSelect the Instagram Pro Connector and click Save
Power2CM ConnectorSelect Power2CM and click Save
Instagram Pro ConnectionSelect the Instagram Pro Connection and click Save. The name displayed will be the full name of the Facebook Developer account used in the CREATING A INSTAGRAM PRO CONNECTION
Power2CM ConnectionSelect Power2CM and click Save

Each time a resource is mapped, its icon will change from to

  1. Click Import
    2020-09-23_15-51-22.png

  2. You will receive a success message at the top of the page once your flow has been imported successfully
    2020-09-23_16-44-05.png

UPDATING THE FIELD VALUES

  1. Open the Instagram Pro to CM flow that has been imported
    2020-09-25_16-54-32.jpg

  2. Click on the Get Instagram Posts action
    2020-09-30_16-57-19.png

  3. In the Profile Id field, paste the value obtained from the OBTAINING THE INSTAGRAM PROFILE ID section of the user manual. Ensure no " surround the number or trailing/leading white space. Only the number should be shown in the box.
    2020-09-30_16-58-01.png

  4. Enter the URI of the record type that you wish to use into the Record Type field. Enter the record number of the container you wish to capture the posts in the Container field

image.png

Placeholders can be added to the Notes and Title fields to capture information from the Instagram posts:
2020-12-18_16-52-31.png

For a full list of available placeholders, please refer to the Archive Instagram Post section in the Power2CM User Manual

  1. Click on the Save button
    2020-09-23_16-08-24.png

Your flow will now run once a day. Records already created from previous flows will be updated using the id supplied in the Id field of the Create Record in CM action

  1. Your flow will be disabled by default. To enable it, click the Left Arrow button
    image.png

  2. Click on the Turn on toggle
    image.png

INSTAGRAM PRO CONNECTOR ACTIONS

GET INSTAGRAM POSTS

Retrieves all posts from the Instagram account.

2020-09-30_16-44-57.png

NameDescription
Profile IdThe Id of the Instagram account that will be used to retrieve posts from
fieldsThe fields retrieved from the Get Posts API call. We recommend using the following value: caption,media_url,username,timestamp,like_count,comments{like_count,text,timestamp,username,replies{like_count,text,timestamp,username}}

GET COMMENTS

This action retrieves all comments from an Instagram Post.
2020-09-30_16-45-47.png

NameDescription
Post IdThe id of the Instagram post that will be used to retrieve Instagram posts from
fieldsThe fields returned from the API call. We recommend using the following value: comments{like_count,text,timestamp,username}

ERROR HANDLING NOTIFICATIONS (OPTIONAL)

Power2CM contains the ability to provide email notifications of any errors that occur during the transfer process. This email will be sent once per day. If this error notification is required to be sent after a failed processed request, an additional step can be included in a flow to allow for an instantaneous message to be sent to the nominated person.

Below is an example of error handling for a Facebook flow, this can be completed for all types of flows.

To add an error handling step to the end of the connector, complete the following:

  1. Select the flow to change and click on the Edit button
    2022-01-25_11-13-47.jpg

  2. Click on the New Step Button to add the step to the end of the flow
    2022-01-25_11-12-43.jpg

  3. Click on the Notifications button
    2022-01-25_11-16-15.jpg

  4. Select the preferred notification type, Email or Mobile Notification, and fill out the required details required
    2022-01-25_11-19-20.jpg

  5. Click on the** '...'** menu in the top right of the action, and click on the **Configure Run After **option
    2022-01-25_11-20-10.jpg

  6. Enable the** Has Failed and Has Timed Out** check boxes only and click on the Done button
    2022-01-25_11-21-56.jpg

  7. Click on the Save button
    2022-01-25_11-23-38.jpg

  8. Repeat the process above for any other flows desired


Was this article helpful?