- Print
- DarkLight
- PDF
Instagram Connector User Manual
OBTAINING THE ACCESS TOKEN
An access token is required to retrieve Instagram posts using the FYB Instagram Connector. This token will last for 60 days. After 60 days, you will need to generate a new token and update the Get Posts FYB Instagram connector action.
Navigate to https://developers.facebook.com/apps/ and click on the Facebook App used in the Instagram Connector Installation Guide
On the Left Menu, click on Instagram Basic Display followed by clicking Basic Display
Scroll down to the User Token Generator and click on the Generate Token option
A popup window will appear asking you to sign in to Instagram. Once signed in, click on the Continue button
Ensure that the I Understand checkbox is enabled and click on the Copy button to copy the access token
Refer to Instagram's Documentation for more information
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 to CM Flow - This flow will archive posts/comments from Instagram to CM
Before using these sample flows ensure you have completed all steps from the Power2CM Installation Guide and Instagram Connector Installation Guide.
Before importing the sample flows, you need to create two connections in Power Automate:
- Power2CM Connection
- Instagram Connection
CREATING A POWER2CM CONNECTION
Once you have logged into Power Automate, click on Connections in the left menu under Data
Click on the New connection button
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
Enter your Content Manager username and password into the username and password fields respectively, and click on the Create button
Your connection will now appear in the list of Power Automate connections. The status should state Connected
CREATING A INSTAGRAM CONNECTION
Once you have logged into Power Automate, click on Connections in the left menu under Data
Click on the New connection button
Type Instagram Connector into the search bar and click on the FYB Instagram Connector (name may vary depending on the name given for the connector in the Instagram Connector Installation Guide)
Click on the Create button
Follow the prompts in the pop-up window
Once complete, your connection will now appear in the list of Power Automate connections. The status should state Connected
IMPORTING THE FLOW
Once you have logged into Power Automate, click on My Flows in the left menu
Click on the Import button
Click on the Upload button
Select the Instagram to CM flow.zip file and click on the Open button
Once the file has finished uploading, you will be taken to the page below
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.
EXPORTED RESOURCE | RESOURCE TO MAP |
---|---|
Instagram Connector | Select the Instagram Connector and click Save |
Power2CM Connector | Select Power2CM and click Save |
Instagram Connection | Select Instagram Connector and click Save. |
Power2CM Connection | Select Power2CM and click Save |
Each time a resource is mapped, its icon will change from to
Click on the Import button
You will receive a success message at the top of the page once your flow has been imported successfully
UPDATING THE FIELD VALUES
Click on the Get Posts action
In the access_token field, copy the access token obtained from the OBTAINING ACCESS THE TOKEN section of this guide
Click on the Archive Instagram Posts action. 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
For full information on all the fields please refer to the INSTAGRAM CONNECTOR ACTIONS > ARCHIVE INSTAGRAM POSTS section of this guide.
Click on the Save button
Your flow will be disabled by default. To enable it, click the Left Arrow button
Click on the Turn on toggle
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.
INSTAGRAM CONNECTOR ACTIONS
Below is a list of all actions available with the connector and what can be set up with them.
GET POSTS
Retrieves all the posts created by the currently logged-in Instagram user.
Name | Description |
---|---|
fields | The fields retrieved from the Get Posts API call. We recommend using the following value: caption,media_url,username,timestamp |
access_token | The access token required to retrieve posts from Instagram |
ARCHIVE INSTAGRAM POSTS
Requires Power2CM Connector
This action is to be used in conjunction with the Get Posts action above to send the data to Content Manager.
Name | Description |
---|---|
Record Type | The record Type URI |
Title | Title of the record |
Container | Container number of the container that the record will be created in |
Author | Specify the email or full name of the location to be used as the Author location for the record. This value will be used if Power2CM cannot find a matching location for the author of the Instagram post. |
Generate PDF | If Yes is selected, a pdf will be generated using the Title, Date Created, Author, Attachment Url and Notes fields. This pdf will be set as the electronic document of the record. |
PDF Template URI | The URI of a record to be used as the template for generating pdf files. See the PDF TEMPLATES section for more information |
Force Update | If Yes is selected, existing records are always updated (new revisions created) every time the flow is run. This is for scenarios where the preceding connector (e.g. The FYB Instagram Pro Connector) does not have a date last updated field |
Instagram Posts Data | The JSON data returned from the Get Posts action from the FYB Instagram and Instagram Pro connectors |
PLACEHOLDERS
The Notes field can contain the following placeholders:
Placeholder | Description |
---|---|
{AUTHOR} | The author of the Instagram Post |
{COMMENTS} | The comments of the Instagram posts (only available for the Instagram Pro connector). Comments include:
|
{CREATED TIME} | The created date of the Post |
{LIKES} | Total likes for a post |
{MESSAGE} | The message/caption on a post |
The Titles field can contain the following placeholders:
Placeholder | Description |
---|---|
{AUTHOR} | The author of the Facebook Post |
{CREATED TIME} | The created date of the Post |
{LIKES} | Total likes for a post |
{MESSAGE} | The message/caption on a post |
Example use of the Archive Instagram Posts action:
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:
Select the flow to change and click on the Edit button
Click the New Step button to add a step to the end of the flow
Click the Notifications button
Select the preferred notification type, Email or Mobile Notification, and fill out the required details required
Click the** '...'** menu in the top right of the action, and click Configure Run After item
Enable the Has Failed and Has Timed Out check boxes only and click on the Done button
Click on the Save button
Repeat the process above for any other flows desired