Integration Social Marketing with social media page

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:

Connect API with Facebook

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, Sign in 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.

The dashboard of the created apps

Note

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, go to App Review ‣ Permissions and Features and request the following access rights:

  • Level: Advanced Access
    • pages_manage_metadata

    • pages_read_user_content

    • pages_messaging

    • pages_show_list

    • pages_manage_posts

    • pages_read_engagement

    • pages_manage_engagement

  • Level: Standard Access
    • pages_manage_metadata

    • pages_read_user_content

    • pages_messaging

    • pages_show_list

    • pages_manage_posts

    • pages_read_engagement

    • pages_manage_engagement

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

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 verify Token: fa****1234. Press Verify and Save.

Callback webhook facebook URL

Then subscribe the feed field by pressing Subcribe.

Subscribe fields

Messenger Integration

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 API with Linkedin

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

Create an app at Linkerdin

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

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

After the Linked In page is verified, you can request access product at Products tab.

Select the Products tab on Linkedin Select the Products tab on Linkedin

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 Client 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

The feature of receiving notifications for interactions on LinkedIn posts:

  1. Go to Social Marketing > Configuration > Settings, and scroll to LinkedIn section..

Information in Linkedin
  1. Copy ApplicationID’s LinkedIn App then paste to Application ID field.

ApplicationId of application on Linkedin LinkedIn Developer Application ID
  1. Navigate to 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 specific 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 Facebook/Linkedin interface. Here, log in to your account to complete the connection.

Log in to the account to 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.