Integration Social Marketing with social media pages

With the Social Marketing app, you can connect to Facebook or Linkedin to post and interact with viewers’ comments right on the system without having to log in to each page. This is a centralized management tool for all social networking sites of the enterprise to help manage consistent information and also save manpower compared to managing each page individually.

In order to connect between apps, you need to connect the social networking platforms to Viindoo system through API. API stands for Application Programming Interface - an intermediary method that connects applications and allows data exchange between apps.

Requirements

This tutorial requires the installation of the following applications/modules:

Integrate Facebook pages with Viindoo

Warning

  • The following instructions are based on Facebook’s policy for management apps. Please note that the interface may change depending on Facebook’s policy updates and version. In case the Facebook’s interface is changed, you only can find the way to finíh with some following keywords:

    1. Create a Business-type App on the Meta for Developers platform.

    2. Add the following products to the app: These products are required to manage posts, comments, and receive real-time interactions without calling additional APIs.

      • Facebook Login (Sign in with Facebook)

      • Webhooks

      • Messenger

    3. Verify your business information with Facebook.

    4. Register the required Facebook Advanced access rights through the App Review process.

      • pages_manage_metadata: Enables retrieval of metadata such as user IDs, needed for comment management.

      • pages_read_user_content: Allows reading user-generated content like comments on Page posts.

      • pages_show_list: Allows the app to retrieve the list of Pages the user manages for selection.

      • pages_manage_posts: Allows the app to create, edit, or delete posts on the connected Page.

      • pages_read_engagement: Allows reading engagement metrics such as likes, reactions, and shares.

      • pages_manage_engagement: Allows app to handle engagement actions including replying or hiding comments.

      • pages_messaging: Enables app to send and receive Messenger conversations with customers.

      • public_profile: Allows an app to read the Default Public Profile Fields on the User node. It’s mandatory for Facebook Login product.

    5. Configure of three above products: The steps could be the same or different but the information will be the same.

    6. Integrate with Viindoo.

Create Facebook App

Sign in to Facebook Developer, press Create App to create an app on the website.

Create an app on Facebook

Note

  • In order to link Facebook account in Meta developers page, you need to be the Administrator of the integrated Facebook pages.

Select the Business app type, Others type and press Next to continue.

Select business type for Viindoo Social Marketing app Select sign in type for Viindoo Social Marketing app

Here, select the app display name and contact email so that Facebook can contact you in case of emergency, press Create App to finish.

Enter the information of  Viindoo Social Marketing app

After you finish, the system will navigate you to the dashboard to continue.

Choose the Facebook products for App

On the Dashboard , press Set up to add the following apps: Facebook Login, Webhook, and Messenger.

Adding product to integrate with Facebook in Viindoo system

Verify your business information with Facebook

Follow the Facebook policy, you need to provide your business details, including the legal business name, address, phone number and website. Make sure the details you submit exactly match the details of your legal business entity. Also make sure your business’s website loads and is HTTPS compliant. For more details, please go to Meta’s helps.

The Facebook verify process can take times, from 1 to some days. Untill the Bussiness is verifed, you can not do the next steps.

Register the Facebook permissions access

Your app need to be verified and you also need Facebook permission access to data for the created applications to have a successful integration. To do so, on the Facebook developer, go to App Review ‣ Permissions and Features and request the following advanced access rights:

  • pages_manage_metadata

  • pages_read_user_content

  • pages_messaging

  • pages_show_list

  • pages_manage_posts

  • pages_read_engagement

  • pages_manage_engagement

  • public_profile

Follow Facebook’s policy: for each requested permission, you must include a clear description, a screen-recording demo, and user interaction steps when submitting your app for review. Facebook will evaluate as following:

  • Why your app requires the permission and how it’s used in Viindoo Social Marketing.

  • Step-by-step instructions.

  • Record a video showing actual usage of the permission follow the above instructions, and Facebook will verify these actions.

Note

For example with the permission: pages_manage_posts

  • Description: We use this permission to manage Facebook Page posts directly from our system. It allows content creators and managers to draft, approve, and publish posts on behalf of the Page through our interface.

  • Test Steps:

    • Log in to your [link instance] with the system administration account [Email/ password].

    • Go to Social Marketing app > Article, create a sample post, choose the pages, press Confirm > Post on Social Media.

    • Verify the post appears on the Facebook Page.

    • To edit the posts, press Cancel > Set to Draft, then edit and post again.

    • To delete the posts, press Cancel > Set to Draft, then choose Action button > Delete.

  • Screen Recording: The link of video which show all steps from login to the post appearing live on Page.

In alignment with Facebook’s policy, you are also required to register as a Technology Provider in order to request certain permissions. Please ensure this step is completed before proceeding with any production-level social marketing operations.

Configure the Facebook products

Facebook Login for Bussiness Configuration

On the left toolbar, select Facebook Login ‣ Settings, at the Valid OAuth Redirect URIs field, type: domain name of the instance + /facebook_callback_user_access_token. E.g. example.viindoo.com/facebook_callback_user_access_token.

Enter valid URI

Webhooks Configuration

On the left toolbar, access Webhooks and select Page.

Select Page option

Press Edit Subscription. On the Callback URL, type: domain name of the instance + /facebook_webhooks. E.g: example.viindoo.com/facebook_webhooks and enter a Verify Token. Press Verify and Save.

Callback webhook facebook URL

Note

  • You can set up this token from your Viindoo system in the Developer mode by going to Settings ‣ Technical ‣ System Parameters. From here, search for the viin_social_facebook.facebook_webhook_token key then add your desired token.

    enter token code

Then subscribe the feed field by pressing Subcribe.

Subscribe fields

Messenger Configuration

Navigate to Messenger ‣ Messenger API Settings, at webhook configuration, press Manage and subscribe messages fields.

Messenger Integration Choose the subscription fields

Connect Facebook with Viindoo

Return to Settings ‣ Basic to copy the App ID and App secret.

App ID

Note

You need to press “Show” to show the app secret before copying.

Return to the Viindoo system, navigate to Social Marketing ‣ Configuration ‣ Settings. Scroll to the Facebook section and attach the App ID and App secret to the corresponding field.

Configure Viindoo Social Marketing Enter App ID to integrate with the Social Marketing app.

Then press Save to save. Now, you have completed the API integration with Facebook.

Integrate Facebook pages with the Viindoo system

After finishing the API integration, you need to link the system with specific social media pages that you want to manage.

Navigate to Social Marketing ‣ Configuration ‣ Social Media. To link the Viindoo system with the enterprise’s Facebook page, choose the Facebook card that you want to link and press LINK ACCOUNT.

Warning

  • This step need the person have the administration of the Facebook account need to do.

Link with Social Marketing Link the account with a specific page

The system will navigate you to a new tab with a Facebook interface. Here, log in to your account, choose the pages that you want to connect, and then complete the connection.

Log in to the account to complete the connection

Note

You need to be be the administrator of the page.

After finishing the connection, return to the system and navigate to Social Marketing ‣ Pages. All the social media pages that are under your administration will appear here.

Successfully connecting with Social Marketing app

Note

  • If you cannot see your list of Facebook pages, go to Social Marketing > Configuration > Social Media, open the Facebook card, and click Synchronize Pages.

  • If the pages still do not appear, please review all the steps above. Ensure that you are using a Facebook account with Administrator access and that the necessary Facebook pages have been selected.

Integrate LinkedIn with Viindoo

Create LinkedIn app

Similar to Facebook, you need to create an app at Linkedin Developer by pressing Create App.

Create an app at Linkedin

Here, enter the needed information and press Create App.

Enter the app information in Linkedin to integrate with Viindoo Social Marketing

When you complete, the system will navigate you to the dashboard so that you can continue.

Created Linkedin dashboard

Verify LinkedIn app

To verify company associate with the application, press Verify on LinkedIn Page, and complete the steps following the Verify company popup.

Verify company associate with app in Linkedin

Choose the mandatory products

After the Linked In page is verified, you can request access product at Products tab by press Request Access button on each needed product line.

Select the Products tab on Linkedin

The mandatory products could be:

  • Sign in with LinkedIn: Used to authenticate the user when connecting via OAuth.

  • Share on LinkedIn: Allows to post the articles to LinkedIn pages.

  • Community Management API: Allows businesses to manage and engage with their posts, user interations on the LinkedIn pages.

According to LinkedIn’s policy, using the Community Management product requires verification by submitting relevant information to LinkedIn. After LinkedIn verify your products request, your App will have the corresponding permissions.

Connect LinkedIn with Viindoo

Move to the Auth tab, copy the app’s Client ID and Client Secret.

Copy Linkedin application credentials

Return to Viindoo system, enter Social Marketing ‣ Configuration ‣ Settings and attach the App ID and App Secret to the corresponding fields.

Paste Linkedin application credentials

In tab Auth, you enter the following syntax into the Authorized redirect URLs for your app: instant domain + /linkedin_callback, e.g. viindoo.demo.com/linkedin_callback.

Enter URL information in Linkedin

Webhooks Configuration

Note

  • The Webhook tab in LinkedIn’s developer will only appear when your API products are verified by LinkedIn.

The feature of receiving notifications for interactions on LinkedIn posts:

  1. Copy ApplicationID’s LinkedIn App.

ApplicationId of application on Linkedin
  1. Go to Social Marketing > Configuration, then paste to LinkedIn Developer Application ID field .

Information in Linkedin LinkedIn Developer Application ID
  1. Navigate to developer facebook site, the Webhook tab on LinkedIn, press Create New and enter the following syntax: instant domain + /linkedin_webhook, e.g. viindoo.demo.com/linkedin_webhook.

Create LinkedIn webhook
  1. Press Test this URL

After the URL is authenticated, the label ‘Verified’ will be displayed under the URL link.

Validate LinkedIn webhook URL

Note

You have to complete step 2 first so that when you click Test this URL. Encouraged to press 3 times within 3 minutes to quickly proceed to the next step. The system needs to ensure stability for at least 6 hours from the time the Webhook URL is validated. LinkedIn will perform several checks during that time.

  1. Set up to receive interaction notifications on the Viindoo system

Navigate to Social Marketing > Configuration > Social Media, press Create Webhook Subcriptions.

Create Webhook Subcriptions

Integrate LinkedIn pages with the Viindoo system

After finishing the API integration, you need to link the system with specific social media pages that you want to manage.

Navigate to Social Marketing ‣ Configuration ‣ Social Media. To link the Viindoo system with the enterprise’s page, find the social media that you want to link and press LINK ACCOUNT.

Link with Social Marketing Link the account with a specific page

The system will navigate you to a new tab with a LinkedIn interface. Here, log in to your account, choose the pages that you want to connect, and then complete the connection.

Note

The connected account must be the administrator of the page.

After finishing the connection, return to the system and navigate to Social Marketing ‣ Pages. All the social media pages that are under your administration will appear here.

Successfully connecting with Social Marketing app

In case you only want specific pages, you can delete the connection by turning to list, selecting the pages, and pressing Action ‣ Delete to disconnect.

Disconect with Social Marketing app

Next, you can create the articles on the connected pages.