MetaSharp: A .NET library for Facebook and Instagram Graph API.

MetaSharp is a .NET library that enables you to authenticate and make graph API calls to Facebook. It's used for posting feeds and contents on Facebook using C# and .NET

Installation

MetaSharp is available on NuGet. Use the package manager console in Visual Studio to install it:

Install-Package CMS365.MetaSharp

API support

MetaSharp version	Facebook Graph API version
8.x	18.x

MetaSharp currently supports the following Facebook Graph APIs:

• Getting started
  • Creating an app
• Access and Security
  • Getting the access token
• Using the MetaSharp
  • Using the MetaSharp
  • Page
    • Get page details
    • Post with multiline text and images
    • Post with multiline text and link
    • Get page albums
  • General Graph API methods
    • Get

Creating an App

Please visit https://developers.facebook.com/apps and create an app.

Access and Security

Please visit https://developers.facebook.com/tools/explorer/ and generate a user token.

You can adjust permissions based on your needs. This is a short lived token and can be used for Facebook Graph api for user level operations. We will use it to generate a long live user token.

User postman and send a request to the following endpoint and get a long lived user token.

https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id=APP_CLIENT_ID&client_secret=APP_CLIENT_SECRET&fb_exchange_token=YOUR_SHORT_LIVED_USER_TOKEN_HERE

You will get a response like

{
    "access_token": "vMF7UXNvRZC6m58zr0tRQJP3MVCZBd6JDhHkyCXjWcfag8hfcmjImn85B2YPZAUYK4eirj9ZA0ZAsp1TocZD",
    "token_type": "bearer",
    "expires_in": 5182228
}

We will get an access_token which is long lived user token and can be used for Facebook Graph api for user level operations but we have to generate a page token so that we can perform action on a Facebook page.

https://graph.facebook.com/FACEBOOK_PAGE_ID?fields=access_token&access_token=LONG_LIVED_USER_TOKEN

{
    "access_token": "EAASZAbmgGb7YBAFWM3uNUKan1ZBTf4rIAQiLzPSNMa7Lm3Ak1R8tNAVwsORl0LZAcPNEURzFgl6",
    "id": "111444904022049"
}

We have now got a page token which we will use to perform actions on a Facebook page.

Using the MetaSharp

Initialize the instance with the page token

var facebookController = new MetaSharp.FacebookController("EAASZAbmgGb7YBAFWM3uNUKan1ZBTf4rIAQiLzPSNMa7Lm3Ak1R8tNAVwsORl0LZAcPNEURzFgl6");

Page

Get page details

PageInfo pageInfo = await facebookController.GetPageDetailsAsync("[PAGE_ID]");

Post with multiline text and images

CreateFeedResponse feedWithImages = await facebookController.PostPageFeedAsync("[PAGE_ID]", new MetaSharp.Entities.Page.PageFeedRequestContent()
{
    MessageLines = new List<string>() { "I am a test message", "I am on next line", "https://google.com" },
    PhotoUrls = new List<string>() { "https://google.com/34f4ea06a374b216cb1c778a0d1810c6_480x.jpg?v=1684836648" }
});

Post with multiline text and a link

CreateFeedResponse feedWithLink = await facebookController.PostPageFeedAsync("[PAGE_ID]",new List<string>() 
{ 
    "I am a test message", "I am on next line", "I am a third line", "I am a fourth line"
},
"https://google.com");

Get page albums

var pageAlbums = await facebookController.GetPageAlbumsAsync("[PAGE_ID]", string fields = "");

Get page albums

Returns most recent 25 conversations. List of fields is available at https://developers.facebook.com/tools/explorer/1294599377547190/?method=GET&path=me%2Fconversations

var pageConversations = await facebookController.GetPageConversations("[PAGE_ID]", string fields = "");

General Graph API methods

You can call direct graph API method If there is no mapping available. For example

Get

var info = await facebookController.Get("/[apge_id]?fields=name,about,link,cover");