Connect API with Facebook¶
Sign in to Facebook Developer, press Create App to create an app on the website.
![Create an app on Facebook](../../../_images/15-Tao-ung-dung-tai-Facebook.en.jpg)
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 and press Next to continue.
![Select business type for Viindoo Social Marketing app](../../../_images/16-Chon-loai-kinh-doanh-cho-ung-dung.en.jpg)
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](../../../_images/17-Dien-thong-tin-ung-dung.en.jpg)
After you finish, the system will navigate you to the dashboard to continue.
![The dashboard of the created apps](../../../_images/18-Bang-thong-tin-ung-dung-Facebook-da-tao.en.jpg)
Note
In addition to the settings instructed in this article, you also need Facebook permission access to data for the created applications to have a successful integration. To do so, go to
and request the following access rights:- Level: Advanced Access
pages_manage_metadata
pages_read_engagement
read_insights
pages_read_user_content
pages_messaging
pages_show_list
pages_manage_posts
public_profile
email
- Level: Standard Access
user_messenger_contact
Human Agent
Oembed Read
Business Asset User Profile Access
Page Mentions
business_management
pages_user_gender
attribution_read
pages_manage_engagement
catalog_management
Page Public Content Access
page_events
Page Public Metadata Access
pages_manage_instant_articles
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](../../../_images/01-Them-san-pham-de-ket-noi-Facebook.en.jpg)
On the left toolbar, select
, 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](../../../_images/02-Dien-thong-tin-URI-hop-le.en.jpg)
Webhooks Configuration¶
On the left toolbar, access Webhooks and select Page.
![Select Page option](../../../_images/01-webhooks.en.jpg)
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: fafafa1234. Press Verify and Save.
![Callback URL](../../../_images/02-webhooks.en.jpg)
Then subscribe all the shown fields by pressing Subcribe.
![Subscribe fields](../../../_images/03-webhooks.en.jpg)
Messenger Integration¶
Navigate to
, press Edit on the page and select all the subscription fields.![Messenger Integration](../../../_images/01-messenger.en.jpg)
![Choose the subscription fields](../../../_images/02-messenger.en.jpg)
Connect Facebook with Viindoo¶
Return to
to copy the App ID and App secret.![App ID](../../../_images/03-Thong-tin-ID-ung-dung.en.jpg)
Note
You need to press “Show” to show the app secret before copying.
Return to the Viindoo system, navigate to
. Scroll to the Facebook section and attach the App ID and App secret to the corresponding field.![Configure Viindoo Social Marketing](../../../_images/04-Thiet-lap-cau-hinh-tai-ung-dung-social-marketing.en.jpg)
![Enter App ID to integrate with the Social Marketing app.](../../../_images/05-Dien-thong-tin-ID-ung-dung-facebook.en.jpg)
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](../../../_images/19-Tao-ung-dung-tai-Linkedin.jpg)
Here, enter the needed information and press Create App.
![Enter the app information in Linkedin to integrate with Viindoo Social Marketing](../../../_images/20-Dien-thong-tin-ung-dung-tai-Linkedin.jpg)
When you complete, the system will navigate you to the dashboard so that you can continue.
![Created Linkedin dashboard](../../../_images/21-Bang-thong-tin-ung-dung-Linkedin-da-tao.jpg)
Note
For successful integration, in addition to the settings instructed in this article, you need to ask Linkedin to grant connect with their data for the created application as follows:
r_organization_social
r_1st_connections_size
r_ads_reporting
r_emailaddress
rw_organization_admin
r_liteprofile
r_basicprofile
r_ads
rw_ads
w_member_social
w_organization_social
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](../../../_images/06-Dien-thong-tin-URL-tai-linkedin.en.jpg)
At the Products tab, add the following products: Share on Linkedin, Sign in with Linkedin, Marketing Developer Platform.
![Select the Products tab on Linkedin](../../../_images/07-Chon-san-pham-tai-linkedin.en.jpg)
Move to the Auth tab, copy the app’s Client ID and Client Secret.
![Copy Linkedin application credentials](../../../_images/08-Sao-chep-ma-ung-dung-linkedin.en.jpg)
Return to Viindoo system, enter
and attach the App ID and App Secret to the corresponding fields.![Paste Linkedin application credentials](../../../_images/09-Dien-thong-tin-ID-ung-dung-linkedin.en.jpg)
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
. 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](../../../_images/10-Thiet-lap-ket-noi-voi-trang-voi-ung-dung-social-marketing.en.jpg)
![Link the account with a specific page](../../../_images/11-Lien-ket-tai-khoan-voi-trang-cu-the.en.jpg)
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](../../../_images/12-Dang-nhap-tai-khoan-de-hoan-thanh-ket-noi.en.jpg)
Note
The connected account must be the administrator of the page.
After finishing the connection, return to the system and navigate to
. All the social media pages that are under your administration will appear here.![Successfully connecting with Social Marketing app](../../../_images/13-Ket-noi-thanh-cong.en.jpg)
In case you only want specific pages, you can delete the connection by turning to list, selecting the pages, and pressing
to disconnect.![Disconect with Social Marketing app](../../../_images/14-Xoa-ket-noi-trang-mang-xa-hoi.en.jpg)
Next, you can create the articles on the connected pages. Refer to Manage post on social media.