إنتقل إلى المحتوى الرئيسي

تكوين نص المتابعة

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

نظرة عامة​

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

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

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

المعاملات​

المعاملالنوعمطلوبالقيمة الافتراضيةالوصف
target_usersstring[]نعم*[]مصفوفة أسماء المستخدمين المستهدفين للمتابعة (مهمة لكل مستخدم)
target_userstringنعم*""اسم مستخدم مستهدف واحد، أو أسماء مستخدمين متعددة مفصولة بفواصل أسطر/فواصل
access_methodstringلا"direct"طريقة الانتقال إلى ملف المستخدم: direct (عبر URL) أو search
ملاحظة

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

إنشاء المهام

عند توفير عدة مستخدمين مستهدفين، سينشئ 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": "follow",
    "script_config": {
      "target_users": ["@username_to_follow"],
      "access_method": "direct"
    }
  }'

متابعة عدة مستخدمين​

عند متابعة عدة مستخدمين، يتم إنشاء مهمة لكل مستخدم:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "access_method": "direct"
    }
  }'

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

جدولة المهام باستخدام وقت البدء​

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

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "access_method": "direct"
    },
    "start_time": "14:30"
  }'

متابعة المستخدمين عبر طريقة البحث​

استخدم طريقة البحث عندما لا يعمل الوصول المباشر عبر URL:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["username1", "username2"],
      "access_method": "search"
    }
  }'

متابعة دفعية على عدة أجهزة​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@influencer_account"],
      "access_method": "direct"
    },
    "enable_multi_account": true
  }'

الاستجابة​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [201, 202, 203],
    "created_count": 3
  }
}

طرق الوصول​

الوصول المباشر (direct)​

  • فتح ملف المستخدم عبر URL: tiktok.com/@username أو instagram.com/username أو threads.com/@username
  • أسرع وأكثر موثوقية
  • موصى به في معظم الحالات
  • طريقة الوصول الوحيدة المتاحة على Threads
  • الانتقال إلى البحث، وإدخال اسم المستخدم، والنقر على النتيجة
  • غير متاحة على Threads — عند طلب مهمة لها ستفشل بدلًا من محاولة التخمين في واجهة البحث
  • أبطأ ولكنه يعمل عند حظر الوصول المباشر عبر URL
  • قد يكون أقل دقة إذا كان هناك أسماء مستخدمين متشابهة متعددة

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

  1. استخدام start_time للجدولة: استخدم معامل start_time لجدولة وقت تنفيذ المهام (التنسيق: "HH:MM").

  2. إعطاء الأولوية للوصول المباشر: طريقة الوصول direct أسرع وأكثر موثوقية من search.

  3. معالجة دفعية معقولة: لا تتابع الكثير من المستخدمين مرة واحدة. سينشئ النظام مهمة لكل مستخدم مستهدف، لذا ستنتج القوائم الكبيرة مهام كثيرة.

انظر أيضًا​