Facebook Threads API icon

Facebook Threads API

Tương tác với Facebook Threads API

Overview

This node integrates with the Facebook Threads API to manage and interact with Threads content. Specifically, the Create Carousel operation allows users to create a carousel thread post containing multiple media items (images or videos) along with accompanying text.

Common scenarios for this node include:

  • Social media managers wanting to automate posting multi-media carousel threads on Facebook Threads.
  • Marketing teams scheduling rich media content with multiple images/videos in a single thread post.
  • Developers building integrations that require programmatic creation of engaging carousel posts on Threads.

For example, a user can provide a text description and at least two media URLs (images or videos), and the node will create a carousel post combining these media items into one interactive thread.

Properties

Name Meaning
Text The textual content of the thread post.
Media URLs An array of URLs pointing to media files (images or videos) to include in the carousel. At least 2 URLs are required. Supported formats include JPG, JPEG, PNG, GIF for images and MP4, MOV, AVI, WMV for videos.

Output

The output is a JSON array where each item corresponds to the result of the API call to create and publish the carousel thread. The main fields include:

  • id: The unique identifier of the created carousel container or published thread.
  • Other metadata returned by the Facebook Threads API related to the created carousel post.

If the operation fails, an error message describing the failure reason is included in the output.

The node does not output binary data; all outputs are JSON objects representing API responses.

Dependencies

  • Requires a valid API authentication token for Facebook Threads API (provided via credentials).
  • Needs internet access to make HTTP requests to https://graph.threads.net.
  • The node expects the Facebook Threads API version to be specified in credentials.
  • No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • Error: "Carousel cần ít nhất 2 media items"
    This means fewer than two media URLs were provided. Ensure you supply at least two valid media URLs.

  • Error: "Không thể tạo item container cho media: [URL]"
    Indicates failure to create a container for one of the media items. Verify the media URL is accessible, correctly formatted, and points to a supported media type.

  • Error: "Không thể tạo carousel container"
    Means the API failed to create the overall carousel container after creating individual media containers. Check API credentials and network connectivity.

  • General API errors
    May occur due to invalid or expired access tokens, insufficient permissions, or rate limits. Refresh tokens or check credential validity if such errors appear.

  • Network issues
    Ensure the node has proper internet access and the Facebook Threads API endpoint is reachable.

Links and References

Discussion