تكوين نص التعليق

تقدم هذه الصفحة معاملات تكوين نص comment لإنشاء المهام.

نظرة عامة

يُستخدم نص comment لنشر التعليقات تلقائيًا على منشورات TikTok أو Instagram. عند توفير عدة روابط منشورات مستهدفة عبر API، يتم إنشاء مهمة واحدة لكل رابط منشور مستهدف. يمكنك استخدام معامل start_time للتحكم في وقت تنفيذ كل مهمة.

تكوين النص البرمجي (script_config)

يحتوي كائن script_config على معاملات نص التعليق. فيما يلي المعاملات المتاحة:

المعاملات

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
target_post_urls	string[]	نعم*	[]	مصفوفة روابط المنشورات المستهدفة للتعليق عليها (مهمة واحدة لكل رابط)
target_post_url	string	نعم*	""	رابط منشور مستهدف واحد أو روابط متعددة مفصولة بفواصل أسطر/فواصل
comment_content	string	نعم	""	نص محتوى التعليق. يمكن أن يحتوي على تعليقات متعددة مفصولة بفواصل أسطر
comment_order	string	لا	"random"	كيفية اختيار التعليقات: random (عشوائي) أو sequential (متسلسل)
insert_emoji	boolean	لا	false	ما إذا كان يجب إدراج رموز تعبيرية عشوائية في التعليقات
comment_image_path	string	لا	""	مسار ملف الصورة للتعليقات بالصور (TikTok فقط). يدعم المسار المطلق أو المسار النسبي لـ work_dir/upload/

ملاحظة

يجب توفير مصفوفة target_post_urls أو سلسلة target_post_url. إذا تم توفير كليهما، فإن target_post_urls له الأولوية.

تعليقات بالصور (TikTok فقط)

يتيح لك معامل comment_image_path إرفاق صورة في تعليقك. هذه الميزة مدعومة فقط على TikTok - تعليقات Instagram لا تدعم مرفقات الصور. سيتم دفع الصورة إلى الجهاز واختيارها كأول صورة في المعرض.

إنشاء المهام

عند توفير عدة روابط منشورات مستهدفة، سينشئ API مهمة واحدة لكل رابط منشور مستهدف. على سبيل المثال، إذا حددت 3 روابط منشورات وجهازين، سيتم إنشاء 6 مهام. استخدم معامل start_time للتحكم في وقت بدء تنفيذ المهام.

أمثلة

التعليق على منشور واحد

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "محتوى رائع! 🔥"
    }
  }'

استخدام خيارات تعليق متعددة

قدم تعليقات متعددة مفصولة بفواصل أسطر. سيختار النظام واحدًا بناءً على comment_order:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "الفيديو رائع!\nأحب هذا المحتوى!\nاستمر في العمل الجيد! 👏\nجيد حقًا!",
      "comment_order": "random"
    }
  }'

التعليق على منشورات متعددة

عند التعليق على منشورات متعددة، يتم إنشاء مهمة لكل منشور:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ],
      "comment_content": "فيديو جيد!\nرائع!\nأحببته!",
      "comment_order": "sequential"
    }
  }'

سيؤدي هذا إلى إنشاء 3 مهام مستقلة يتم تنفيذها على الفور.

تعليق مجدول

استخدم start_time لجدولة وقت بدء تنفيذ المهام:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "تعليق مجدول!"
    },
    "start_time": "14:30"
  }'

التعليق مع إدراج رموز تعبيرية

تمكين الإدراج التلقائي للرموز التعبيرية لجعل التعليقات أكثر جاذبية:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "هذا رائع",
      "insert_emoji": true
    }
  }'

التعليق بوضع قائمة أسماء المستخدمين

إنشاء مهام تعليق مباشرة لحسابات محددة:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "comment_content": "فيديو لا بأس به!"
    }
  }'

التعليق الدفعي على عدة أجهزة

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999",
      "comment_content": "محتوى رائع!\nعمل ممتاز!\nأحبه جدًا!",
      "comment_order": "random"
    },
    "enable_multi_account": true
  }'

مثال تعليق Instagram

نفس API ينطبق على منشورات Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/",
      "comment_content": "صورة جميلة! 📸",
      "insert_emoji": true
    }
  }'

مثال تعليق بصورة على TikTok

أرفق صورة في تعليقك على TikTok (غير مدعوم على Instagram):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "انظر إلى هذه الصورة!",
      "comment_image_path": "C:/images/my_image.jpg"
    }
  }'

مسار الصورة

يمكن أن يكون comment_image_path:

• مسار مطلق: C:/images/my_image.jpg أو /home/user/images/my_image.jpg
• مسار نسبي: my_image.jpg (نسبيًا لـ work_dir/upload/)

الاستجابة

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301, 302, 303],
    "created_count": 3
  }
}

ترتيب التعليقات

ترتيب عشوائي (random)

• اختيار تعليق عشوائيًا من القائمة المقدمة
• مناسب لجعل التعليقات تبدو أكثر طبيعية
• السلوك الافتراضي

ترتيب متسلسل (sequential)

• اختيار التعليقات بالترتيب بناءً على job_count
• المهمة الأولى تستخدم التعليق الأول، المهمة الثانية تستخدم التعليق الثاني، وهكذا
• العودة إلى البداية عند الوصول إلى نهاية القائمة
• مناسب لتوزيع تعليقات مختلفة عبر مهام متعددة

تنسيقات روابط المنشورات

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

أفضل الممارسات

1. نوّع تعليقاتك: قدم خيارات تعليق متعددة لتجنب أن تبدو كرسائل غير مرغوب فيها.

2. استخدم الوضع المتسلسل للتنوع: عند التعليق على منشورات متعددة بنفس الجهاز، استخدم الترتيب sequential لتوزيع تعليقات مختلفة.

3. تمكين إدراج الرموز التعبيرية: اضبط insert_emoji: true لجعل التعليقات تبدو أكثر طبيعية وجاذبية.

4. جدولة المهام: استخدم معامل start_time لتوزيع التعليقات على مدى فترة زمنية، مما يقلل من فرص تفعيل حدود التكرار.

5. الامتثال لحدود المنصة: لا تنشئ عددًا كبيرًا جدًا من مهام التعليق مرة واحدة. لدى معظم المنصات حدود تكرار للتعليقات.

رموز الأخطاء

الرمز	الوصف
40001	رابط المنشور المستهدف أو محتوى التعليق مفقود
40003	النص البرمجي غير مدعوم بواسطة API
40301	يتطلب الوصول إلى API خطة Pro+

انظر أيضًا

• API إدارة المهام - إنشاء وإدراج وإدارة المهام
• تكوين نص النشر - تكوين معاملات نص النشر
• تكوين نص المتابعة - تكوين معاملات نص المتابعة
• نظرة عامة على API المحلي - نظرة عامة على API والبدء السريع