Hướng dẫn tích hợp

Upload-Post + n8n Integration

Automate your social media publishing by connecting Upload-Post with n8n. Start by setting up your Upload-Post users and API key, then choose between our official n8n node or manual HTTP configuration.

Browse All n8n Templates

Cần giúp xây dựng quy trình làm việc của bạn? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Liên hệ với chúng tôi

Prerequisite: Setup in Upload-Post

Before configuring n8n, you must set up users and generate an API key within your Upload-Post account. These will be used to authenticate and direct your automated posts.

Quản lý Người dùng & Kết nối Tài khoản Mạng xã hội

Each post is associated with a specific user in Upload-Post. This user must have the target social media platforms connected to their profile.

  • Navigate to the Quản lý Người dùng page in your Upload-Post dashboard.
  • Thêm người dùng mới hoặc chọn một người dùng hiện có.
  • Đối với người dùng đã chọn, kết nối tất cả các tài khoản mạng xã hội (ví dụ: TikTok, Instagram, Facebook) mà bạn dự định xuất bản nội dung qua n8n.
  • Take note of the Định danh người dùng (this is typically the username or a unique ID associated with the user in Upload-Post). You will need this for your n8n workflows.

Quan trọng: Các tài khoản mạng xã hội phải được kết nối với *người dùng cụ thể* mà bạn định sử dụng trong tự động hóa, không chỉ chung chung với tài khoản Upload-Post của bạn.

Tạo khóa API

The API key authenticates your requests to the Upload-Post API.

  • Go to the Khóa API page in your Upload-Post API keys section.
  • Tạo một khóa API mới nếu bạn chưa có.
  • Sao chép khóa API này một cách an toàn. Bạn sẽ sử dụng nó trong thiết lập thông tin xác thực n8n của bạn.

Ghi chú bảo mật: Treat your API key like a password. Do not share it publicly or embed it directly in shared workflows. Use n8n\'s credential management system.

Once you have your Định danh người dùng and Khóa API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Tình trạng Node:

The n8n-nodes-upload-post node is now included by default in updated versions of n8n for both self-hosted (on-premise) n8n instances and n8n cloud instances. No manual installation is required - just ensure you have the latest version of n8n.

The easiest way to integrate is using our official node: n8n-nodes-upload-post. This node is included by default in updated versions of n8n and streamlines setup with dedicated operations for both cloud and self-hosted n8n instances.

1. Access the Upload-Post Node

Nút Upload-Post được bao gồm theo mặc định trong các phiên bản cập nhật của n8n:

  1. Đảm bảo bạn đã cài đặt phiên bản mới nhất của n8n.
  2. Mở trình chỉnh sửa quy trình làm việc n8n của bạn.
  3. Tìm kiếm "Upload Post" trong thư viện node.
  4. Nút này nên có sẵn mà không cần cài đặt thêm.

If you don\'t see the node, please update your n8n instance to the latest version.

2. Configure Upload-Post API Credentials in n8n

You\'ll use the API Key generated from your Phần API tải lên bài đăng (as described in the "Prerequisite" section above).

  1. In n8n, go to Thông tin xác thực > Mới.
  2. Search for API tải lên bài đăng và chọn nó.
  3. Assign a memorable Tên thông tin xác thực (e.g., "My Upload-Post API Key").
  4. Dán Khóa API vào trường được chỉ định.
  5. Click Lưu.

Điều này lưu trữ an toàn khóa API của bạn để sử dụng bởi nút Upload-Post.

3. Utilize Node Operations in Your Quy trình làm việc

The node provides dedicated operations. For each, you will need to provide the Định danh người dùng (from the user you set up in Quản lý người dùng Upload-Post) to specify which user\'s social accounts to use.

Tải lên ảnh

Tải lên một hoặc nhiều ảnh. Chấp nhận tệp hoặc URL.

Bắt buộc: User Identifier, Platform(s), Photos. Tùy chọn: Title, Caption. Platform-specific fields available.

Tải lên video

Tải lên một video đơn. Chấp nhận tệp hoặc URL.

Bắt buộc: User Identifier, Platform(s), Video. Tùy chọn: Title. Platform-specific fields available.

Tải lên văn bản

Tải lên một bài đăng dựa trên văn bản.

Bắt buộc: User Identifier, Platform(s), Title/Content. Platform-specific fields available.

Refer to the node\'s help documentation within n8n or the npm package page for detailed parameter lists. The Tài liệu API tải lên bài đăng provides full details on underlying API capabilities.

Using this dedicated n8n node is the recommended approach for both cloud and self-hosted n8n users.

Manual Configuration (Alternative using HTTP Request Node)

If the official node is not suitable for your specific needs, you can configure the integration manually using n8n\'s generic HTTP Request node. This requires careful setup of API parameters.

Điều kiện tiên quyết: Người dùng Upload-Post & Khóa API

Đảm bảo bạn đã hoàn thành các bước "Điều kiện tiên quyết: Thiết lập trong Upload-Post" được mô tả ở đầu hướng dẫn này. Bạn sẽ cần:

Open Upload-Post App

Hiểu các điểm cuối API Upload-Post & Thực hiện yêu cầu

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Ủy quyền header with your API Key and generally require a user field (your User Identifier from Upload-Post) and platform[] to specify the target social media.

1. Video Upload Endpoint

Điểm cuối URL: https://api.upload-post.com/api/upload

Use this endpoint for uploading single video files. Key parameters include video (file), title, user, and platform[].

curl \
  -H 'Ủy quyền: Apikey YOUR_API_KEY_HERE' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Tiêu đề video của bạn"' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

Điểm cuối URL: https://api.upload-post.com/api/upload_photos

For uploading one or more photos (e.g., for carousels/slideshows). Use photos[] for each image file. Also include user, platform[], title, and optionally description.

curl \
  -H 'Ủy quyền: Apikey YOUR_API_KEY_HERE' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -F 'platform[]=instagram' \
  -F 'title="My Awesome Photo Album"' \
  -F 'description="Check out these cool photos!"' \
  -X POST https://api.upload-post.com/api/upload_photos

3. Text Upload Endpoint

Điểm cuối URL: https://api.upload-post.com/api/upload_text

For publishing text-based posts. Requires user, platform[], and title (as the main content). caption can be used for internal tracking or specific platform needs.

curl \
  -H 'Ủy quyền: Apikey YOUR_API_KEY_HERE' \
  -F 'user="YOUR_USER_IDENTIFIER"' \
  -F 'platform[]=x' \
  -F 'title="This is my amazing tweet content!"' \
  -F 'caption="Optional: A caption for stats & tracking."' \
  -X POST https://api.upload-post.com/api/upload_text

Ghi chú quan trọng cho cấu hình thủ công:

  • Replace YOUR_API_KEY_HERE with your actual API key from the Upload-Post Api section.
  • Replace YOUR_USER_IDENTIFIER bằng Định danh người dùng cụ thể (ví dụ: tên người dùng) từ Upload-Post có các tài khoản mạng xã hội mục tiêu đã kết nối.
  • Rất khuyến nghị bạn lưu trữ khóa API của mình trong trình quản lý thông tin xác thực của n8n và tham chiếu nó trong nút HTTP Request thay vì mã hóa cứng.
  • The @/path/to/your/file syntax in cURL indicates a file upload. In n8n, you would use expressions to reference binary data from previous nodes (e.g., ={{ $binary.data }}).

Mẹo chuyên nghiệp: Kiểm tra & Tạo cURL từ Bảng điều khiển Upload-Post

Before configuring n8n, test your uploads directly from the Bảng điều khiển Upload-Post. Once you\'ve successfully uploaded content, the dashboard generates a perfect cURL command that you can copy and import directly into your n8n HTTP Request node.

Quy trình làm việc:

  1. Go to Bảng điều khiển Upload-Post
  2. Tải lên nội dung của bạn (video, ảnh hoặc văn bản) đến các nền tảng mong muốn của bạn
  3. Sau khi tải lên thành công, sao chép lệnh cURL được tạo ra
  4. Nhập cURL này trực tiếp vào nút Yêu cầu HTTP n8n của bạn bằng cách sử dụng tính năng "Nhập từ cURL"

Cấu hình Nút Yêu cầu HTTP n8n (Nội dung)

Key fields for the HTTP Request node\'s body (typically multipart/form-data):

Trường Giá trị / Mô tả Bắt buộc
user Your Định danh người dùng from Upload-Post (e.g., username). Bắt buộc
platform[] Nền tảng identifier (e.g., tiktok, instagram). Repeat for multiple platforms. Bắt buộc
title Đăng tiêu đề hoặc nội dung (thay đổi theo nền tảng và loại bài đăng). Tùy chọn/Thay đổi
video Dữ liệu tệp nhị phân cho việc tải lên video. Nếu tải lên video
image[] Dữ liệu tệp nhị phân cho việc tải lên hình ảnh. Lặp lại cho nhiều hình ảnh trong một carousel/slideshow. Nếu tải lên hình ảnh
n8n Configuration Tips:
  • Set HTTP Request node Phương pháp to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Ủy quyền header with your API key.
  • For Loại nội dung thân, select multipart/form-data.
  • Thêm các trường vào body như user, platform[], title, and either video or image[] with appropriate values (e.g., using n8n expressions like ={{ $binary.data }} for file data).

For detailed examples and platform-specific parameters, refer to the Tài liệu API tải lên bài đăng.

Ví dụ: HTTP Node JSON (Video đến TikTok)

This is a conceptual JSON representation for an n8n HTTP Request node configured to upload a video to TikTok. You would build this using the n8n interface. 

{
  "parameters": {
    "method": "POST",
    "url": "https://api.upload-post.com/api/upload",
    "authentication": "headerAuth",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        {
          "name": "Ủy quyền",
          "value": "Khóa API YOUR_API_KEY_HERE"
        }
      ]
    },
    "sendBody": true,
    "bodyContentType": "multipart-form-data",
    "bodyParameters": {
      "parameters": [
        {
          "name": "user",
          "value": "YOUR_UPLOAD_POST_USER_IDENTIFIER"
        },
        {
          "name": "title",
          "value": "= $input.item.title ? $input.item.title : 'Video tuyệt vời của tôi'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Tải lên video đến TikTok (Thủ công)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • Bảo mật khóa API: Always use n8n\'s credential management for your Upload-Post API Key. Avoid hardcoding it.
  • Định danh người dùng: Đảm bảo trường user trong phần thân yêu cầu tham chiếu chính xác đến Định danh người dùng từ Upload-Post có các tài khoản mạng xã hội đã kết nối mà bạn định sử dụng.
  • Khi chia sẻ quy trình làm việc, xuất ra mà không có dữ liệu xác thực nhạy cảm.

Ví dụ về quy trình: Nhà xuất bản mạng xã hội sử dụng AI

This workflow is available as a template: Xem trên n8n.io or see all our n8n templates

What It Does

  • Giám sát một thư mục Google Drive để tìm video mới
  • Chuyển đổi video bằng OpenAI
  • Tạo mô tả mạng xã hội hấp dẫn
  • Tải lên Instagram, TikTok & YouTube
  • Gửi thông báo khi hoàn thành hoặc có lỗi

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Kích hoạt Google Drive: Configure to monitor a specific folder for new videos
  2. Chuyển văn bản OpenAI: Set up to extract audio and convert to text
  3. Trình tạo mô tả OpenAI: Use a custom prompt to create engaging descriptions based on transcription
  4. Yêu cầu HTTP của Upload-Post: Configure as described in previous steps with multi-platform selection
  5. Xử lý lỗi: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Ví dụ về quy trình: Nhà xuất bản băng chuyền hình ảnh cho Instagram & TikTok

This workflow is available as a template: Xem trên n8n.io or see all our n8n templates

What It Does

  • Tự động tải lên nhiều hình ảnh dưới dạng băng chuyền lên Instagram
  • Tự động tải lên nhiều hình ảnh dưới dạng trình chiếu lên TikTok
  • Tối ưu hóa quản lý nội dung hình ảnh trên các nền tảng
  • Xử lý tải lên nhiều hình ảnh với một lần kích hoạt

Workflow Steps

  1. Kích hoạt: Start the workflow with your selected images (e.g., from a schedule, webhook, or manual execution).
  2. Xử lý hình ảnh: The workflow prepares images for platform-specific formats (consider nodes for resizing or formatting if needed).
  3. Yêu cầu HTTP của Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • Sử dụng trường `image[]` thay vì `video`.
    • Truyền dữ liệu nhị phân cho mỗi hình ảnh vào trường `image[]`.
    • Đặt `platform[]` thành `instagram` và/hoặc `tiktok`.
  4. Tối ưu hóa nền tảng: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Add nodes to notify upon success or failure.

Refer to the n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

Cần trợ giúp?

Các chuyên gia tích hợp của chúng tôi sẵn sàng giúp đỡ

Contact Support