Facebook

Facebook module for RobinPath.

Package: @robinpath/facebook | Category: Social Media | Type: Integration

Authentication

facebook.setCredentials "your-credentials"

Call this once at the start of your script before using any other function. Credentials persist for the duration of the script execution.

Use Cases

Use the facebook module when you need to:

• getPageInfo -- Use facebook.getPageInfo to perform this operation
• listPagePosts -- Use facebook.listPagePosts to perform this operation
• createPagePost -- Use facebook.createPagePost to perform this operation
• updatePost -- Use facebook.updatePost to perform this operation
• deletePost -- Use facebook.deletePost to perform this operation

Quick Reference

Function	Description	Returns
setCredentials	Configure facebook credentials.	object
getPageInfo	getPageInfo	object
listPagePosts	listPagePosts	object
createPagePost	createPagePost	object
updatePost	updatePost	object
deletePost	deletePost	object
getPost	getPost	object
getPostInsights	getPostInsights	object
getPageInsights	getPageInsights	object
listComments	listComments	object
replyToComment	replyToComment	object
deleteComment	deleteComment	object
hideComment	hideComment	object
listPageEvents	listPageEvents	object
createPageEvent	createPageEvent	object
uploadPhoto	uploadPhoto	object
uploadVideo	uploadVideo	object
getAdAccounts	getAdAccounts	object
getCampaigns	getCampaigns	object
getMe	getMe	object
searchPages	searchPages	object

Functions

setCredentials

Configure facebook credentials.

Module: facebook | Returns: object -- API response.

facebook.setCredentials

Parameter	Type	Required	Description
accessToken	string	Yes	accessToken

---

getPageInfo

getPageInfo

Module: facebook | Returns: object -- API response.

facebook.getPageInfo

Parameter	Type	Required	Description
input	string	No	Input parameter

---

listPagePosts

listPagePosts

Module: facebook | Returns: object -- API response.

facebook.listPagePosts

Parameter	Type	Required	Description
input	string	No	Input parameter

---

createPagePost

createPagePost

Module: facebook | Returns: object -- API response.

facebook.createPagePost

Parameter	Type	Required	Description
input	string	No	Input parameter

---

updatePost

updatePost

Module: facebook | Returns: object -- API response.

facebook.updatePost

Parameter	Type	Required	Description
input	string	No	Input parameter

---

deletePost

deletePost

Module: facebook | Returns: object -- API response.

facebook.deletePost

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getPost

getPost

Module: facebook | Returns: object -- API response.

facebook.getPost

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getPostInsights

getPostInsights

Module: facebook | Returns: object -- API response.

facebook.getPostInsights

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getPageInsights

getPageInsights

Module: facebook | Returns: object -- API response.

facebook.getPageInsights

Parameter	Type	Required	Description
input	string	No	Input parameter

---

listComments

listComments

Module: facebook | Returns: object -- API response.

facebook.listComments

Parameter	Type	Required	Description
input	string	No	Input parameter

---

replyToComment

replyToComment

Module: facebook | Returns: object -- API response.

facebook.replyToComment

Parameter	Type	Required	Description
input	string	No	Input parameter

---

deleteComment

deleteComment

Module: facebook | Returns: object -- API response.

facebook.deleteComment

Parameter	Type	Required	Description
input	string	No	Input parameter

---

hideComment

hideComment

Module: facebook | Returns: object -- API response.

facebook.hideComment

Parameter	Type	Required	Description
input	string	No	Input parameter

---

listPageEvents

listPageEvents

Module: facebook | Returns: object -- API response.

facebook.listPageEvents

Parameter	Type	Required	Description
input	string	No	Input parameter

---

createPageEvent

createPageEvent

Module: facebook | Returns: object -- API response.

facebook.createPageEvent

Parameter	Type	Required	Description
input	string	No	Input parameter

---

uploadPhoto

uploadPhoto

Module: facebook | Returns: object -- API response.

facebook.uploadPhoto

Parameter	Type	Required	Description
input	string	No	Input parameter

---

uploadVideo

uploadVideo

Module: facebook | Returns: object -- API response.

facebook.uploadVideo

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getAdAccounts

getAdAccounts

Module: facebook | Returns: object -- API response.

facebook.getAdAccounts

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getCampaigns

getCampaigns

Module: facebook | Returns: object -- API response.

facebook.getCampaigns

Parameter	Type	Required	Description
input	string	No	Input parameter

---

getMe

getMe

Module: facebook | Returns: object -- API response.

facebook.getMe

Parameter	Type	Required	Description
input	string	No	Input parameter

---

searchPages

searchPages

Module: facebook | Returns: object -- API response.

facebook.searchPages

Parameter	Type	Required	Description
input	string	No	Input parameter

---

Error Handling

All functions throw on failure. Common errors:

Error	Cause
Facebook API error (${res.status}): ${t}	Check the error message for details
facebook.setCredentials requires accessToken.	Check the error message for details
facebook.updatePost requires an ID.	Check the error message for details
facebook.deletePost requires an ID.	Check the error message for details
facebook.deleteComment requires an ID.	Check the error message for details
facebook.hideComment requires an ID.	Check the error message for details
Facebook: "..." not configured. Call facebook.setCredentials first.	Check the error message for details

@desc "Get page info and validate result"
do
  set $result as facebook.getPageInfo
  if $result != null
    print "Success"
  else
    print "No result"
  end
enddo

Recipes

1. List and iterate PageInfo

Retrieve all items and loop through them.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Get page info and iterate results"
do
  set $result as facebook.getPageInfo
  each $item in $result
    print $item
  end
enddo

2. Create a new item with createPagePost

Create a new resource and capture the result.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Create page post"
do
  set $result as facebook.createPagePost
  print "Created: " + $result
enddo

3. Create and update workflow

Create an item and then update it.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Create page post and update post"
do
  set $created as facebook.createPagePost
  # Update the created item
  facebook.updatePost
enddo

4. Check before creating

List existing items and only create if needed.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Get page info and create page post"
do
  set $existing as facebook.getPageInfo
  if $existing == null
    facebook.createPagePost
    print "Item created"
  else
    print "Item already exists"
  end
enddo

5. Multi-step Facebook workflow

Chain multiple facebook operations together.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Get page info, list page posts, and more"
do
  set $r_getPageInfo as facebook.getPageInfo
  set $r_listPagePosts as facebook.listPagePosts
  set $r_createPagePost as facebook.createPagePost
  print "All operations complete"
enddo

6. Safe getPageInfo with validation

Check results before proceeding.

@desc "Setup authentication"
do
  facebook.setCredentials $token
enddo

@desc "Get page info and validate result"
do
  set $result as facebook.getPageInfo
  if $result != null
    print "Success: " + $result
  else
    print "Operation returned no data"
  end
enddo

Related Modules

• instagram -- Instagram module for complementary functionality
• twitter -- Twitter/X module for complementary functionality
• linkedin -- LinkedIn module for complementary functionality
• tiktok -- TikTok module for complementary functionality
• pinterest -- Pinterest module for complementary functionality