الرئيسية
دليل التكامل

دليل التكامل

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

تحتاج مساعدة في بناء سير العمل الخاص بك؟ We work with trusted partners who can set up your n8n automation or build a custom project for you.

اتصل بنا

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.

إدارة المستخدمين وربط الحسابات الاجتماعية

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 إدارة المستخدمين page in your Upload-Post dashboard.
أضف مستخدمًا جديدًا أو اختر مستخدمًا موجودًا.
للمستخدم المختار، قم بربط جميع حسابات وسائل التواصل الاجتماعي (مثل، TikTok، Instagram، Facebook) التي تنوي نشر المحتوى من خلالها عبر n8n.
Take note of the معرف المستخدم (this is typically the username or a unique ID associated with the user in Upload-Post). You will need this for your n8n workflows.

مهم: يجب ربط حسابات التواصل الاجتماعي بالمستخدم *المحدد* الذي تنوي استخدامه في الأتمتة، وليس فقط بحساب Upload-Post الخاص بك بشكل عام.

إنشاء مفتاح API

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

Go to the مفاتيح API page in your Upload-Post API keys section.
إنشاء مفتاح API جديد إذا لم يكن لديك واحد بالفعل.
انسخ مفتاح API هذا بأمان. ستستخدمه في إعداد بيانات اعتماد n8n الخاصة بك.

ملاحظة الأمان: 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 معرف المستخدم and مفتاح API from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n 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

عقدة Upload-Post مضمنة بشكل افتراضي في الإصدارات المحدثة من n8n:

تأكد من أنك قد قمت بتثبيت أحدث إصدار من n8n.
افتح محرر سير العمل الخاص بـ n8n.
ابحث عن "Upload Post" في مكتبة العقد.
يجب أن تكون العقدة متاحة دون أي تثبيت إضافي.

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 قسم API لتحميل المنشورات (as described in the "Prerequisite" section above).

In n8n, go to الاعتمادات > جديد.
Search for API لتحميل المنشورات وحدده.
Assign a memorable اسم الاعتماد (e.g., "My Upload-Post API Key").
الصق مفتاح API في الحقل المخصص.
Click حفظ.

هذا يخزن مفتاح API الخاص بك بأمان لاستخدامه بواسطة عقدة Upload-Post.

3. Utilize Node Operations in Your سير العمل

The node provides dedicated operations. For each, you will need to provide the معرف المستخدم (from the user you set up in إدارة المستخدمين في Upload-Post) to specify which user\'s social accounts to use.

تحميل صورة(صور)

رفع صورة واحدة أو أكثر. يقبل الملفات أو الروابط.

مطلوب: User Identifier, Platform(s), Photos. اختياري: Title, Caption. Platform-specific fields available.

تحميل فيديو

رفع فيديو واحد. يقبل ملف أو رابط.

مطلوب: User Identifier, Platform(s), Video. اختياري: Title. Platform-specific fields available.

تحميل نص

رفع منشور نصي.

مطلوب: 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 وثائق API لتحميل المنشورات 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.

المتطلبات الأساسية: مستخدم Upload-Post ومفتاح API.

تأكد من أنك قد أكملت خطوات "المتطلبات المسبقة: الإعداد في Upload-Post" الموضحة في بداية هذا الدليل. ستحتاج إلى:

Your مفتاح API from مفاتيح واجهة برمجة التطبيقات Upload-Post.
The معرف المستخدم (e.g., username) for the user whose social accounts you\'ll be posting to, from إدارة المستخدمين في Upload-Post.

Open Upload-Post App

فهم نقاط نهاية Upload-Post API وإجراء الطلبات

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an التفويض 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

نقطة النهاية 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 'التفويض: Apikey YOUR_API_KEY_HERE' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="عنوان الفيديو الخاص بك"' \
  -F 'user="معرف_المستخدم_الخاصة_بك"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

نقطة النهاية 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 'التفويض: Apikey YOUR_API_KEY_HERE' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="معرف_المستخدم_الخاصة_بك"' \
  -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

نقطة النهاية 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 'التفويض: Apikey YOUR_API_KEY_HERE' \
  -F 'user="معرف_المستخدم_الخاصة_بك"' \
  -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

ملاحظات مهمة للتكوين اليدوي:

Replace مفتاح_API_الخاصة_بك_هنا with your actual API key from the Upload-Post Api section.
Replace معرف_المستخدم_الخاصة_بك بمعرّف المستخدم المحدد (مثل اسم المستخدم) من Upload-Post الذي لديه حسابات التواصل الاجتماعي المستهدفة مرتبطة.
يوصى بشدة بتخزين مفتاح API الخاص بك في مدير بيانات اعتماد n8n والإشارة إليه في عقدة طلب HTTP بدلاً من ترميزه بشكل ثابت.
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 }}).

نصيحة احترافية: اختبر وولّد cURL من لوحة تحكم Upload-Post.

Before configuring n8n, test your uploads directly from the لوحة تحكم 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.

سير العمل:

Go to لوحة تحكم Upload-Post
رفع محتواك (فيديو، صور، أو نص) إلى المنصات التي ترغب بها
بعد التحميل الناجح، انسخ أمر cURL الذي تم إنشاؤه
استيراد هذا cURL مباشرة إلى عقدة طلب HTTP في n8n باستخدام ميزة "استيراد من cURL"

تكوين عقدة طلب HTTP لـ n8n (الجسم)

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

حقل	القيمة / الوصف	مطلوب
user	Your معرف المستخدم from Upload-Post (e.g., username).	مطلوب
platform[]	المنصة identifier (e.g., `tiktok`, `instagram`). Repeat for multiple platforms.	مطلوب
title	نشر عنوان أو محتوى (يختلف حسب المنصة ونوع المنشور).	اختياري/يختلف
video	بيانات الملف الثنائي لرفع مقاطع الفيديو.	إذا كنت تقوم بتحميل فيديو
image[]	بيانات الملف الثنائي لرفع الصور. كرر ذلك لعدة صور في عرض شرائح.	إذا كنت تقوم بتحميل صورة(صور)

n8n Configuration Tips:

Set HTTP Request node الطريقة to POST.
Set URL to https://api.upload-post.com/api/upload.
Add the التفويض header with your API key.
For نوع محتوى الجسم, select multipart/form-data.
أضف حقولاً إلى الجسم مثل 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 وثائق API لتحميل المنشورات.

مثال: JSON عقدة HTTP (فيديو إلى 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": "التفويض",
          "value": "مفتاح 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 : 'فيديوي الرائع'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "تحميل الفيديو إلى TikTok (يدوي)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

أمان مفتاح API: Always use n8n\'s credential management for your Upload-Post API Key. Avoid hardcoding it.
معرف المستخدم: تأكد من أن حقل user في نص الطلب يشير بشكل صحيح إلى معرّف المستخدم من Upload-Post الذي ترتبط به حسابات التواصل الاجتماعي التي تنوي استخدامها.
عند مشاركة سير العمل، قم بالتصدير دون بيانات الاعتماد الحساسة.

مثال على سير العمل: ناشر وسائل التواصل الاجتماعي المدعوم بالذكاء الاصطناعي

This workflow is available as a template: عرض على n8n.io or see all our n8n templates

What It Does

يراقب مجلد Google Drive للعثور على فيديوهات جديدة
يتم نسخ الفيديو باستخدام OpenAI
إنشاء أوصاف جذابة لوسائل التواصل الاجتماعي
التحميلات إلى Instagram وTikTok وYouTube
يرسل إشعارات عند الانتهاء أو الأخطاء

Workflow Architecture

Implementation Steps

محفز Google Drive: Configure to monitor a specific folder for new videos
نسخ OpenAI: Set up to extract audio and convert to text
مولد وصف OpenAI: Use a custom prompt to create engaging descriptions based on transcription
طلب HTTP Upload-Post: Configure as described in previous steps with multi-platform selection
معالجة الأخطاء: Add Telegram notification for success/failure alerts

Get This Template on n8n.io

مثال على سير العمل: ناشر دواليب الصور لـ Instagram و TikTok

This workflow is available as a template: عرض على n8n.io or see all our n8n templates

What It Does

يعمل على تحميل صور متعددة كدواليب إلى إنستغرام تلقائيًا
يعمل على تحميل صور متعددة كشرائح إلى TikTok تلقائيًا
تبسيط إدارة المحتوى المرئي عبر المنصات
يتعامل مع تحميلات الصور المتعددة بزناد واحد

Workflow Steps

الزناد: Start the workflow with your selected images (e.g., from a schedule, webhook, or manual execution).
معالجة الصور: The workflow prepares images for platform-specific formats (consider nodes for resizing or formatting if needed).
طلب HTTP Upload-Post: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
- استخدم حقل `image[]` بدلاً من `video`.
- قم بتمرير البيانات الثنائية لكل صورة إلى حقل `image[]`.
- قم بتعيين `platform[]` إلى `instagram` و/أو `tiktok`.
تحسين المنصة: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
(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

تحتاج إلى مساعدة؟

خبراؤنا في التكامل هنا للمساعدة

Contact Support