تكوين نص الرسائل

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

نظرة عامة

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

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

معاملات تكوين نص الرسائل:

المعاملات

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
target_users	string[]	Yes*	[]	مصفوفة أسماء المستخدمين المستهدفين للمراسلة (مهمة لكل مستخدم)
target_user	string	Yes*	""	اسم مستخدم واحد، أو عدة أسماء مفصولة بفواصل/أسطر
message_content	string	Yes	""	محتوى الرسالة النصية
access_method	string	No	"direct"	طريقة الانتقال: direct أو search

ملاحظة

يجب توفير target_users أو target_user. إذا توفر كلاهما فـtarget_users له الأولوية.

معلومات

عند توفير عدة مستخدمين مستهدفين، سينشئ API مهمة لكل مستخدم. 3 مستخدمين + جهازان = 6 مهام.

أمثلة

إرسال رسالة لمستخدم واحد

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@username_to_message"],
      "message_content": "Hello! Check out our latest content.",
      "access_method": "direct"
    }
  }'

إرسال رسائل لعدة مستخدمين

مهمة لكل مستخدم:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "message_content": "Hi! We have an exclusive offer for you."
    }
  }'

هذا ينشئ 3 مهام منفصلة تنفذ فوراً.

جدولة الرسائل باستخدام وقت البدء

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

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "message_content": "Scheduled greeting!"
    },
    "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": "message",
    "script_config": {
      "target_users": ["username1", "username2"],
      "message_content": "Hello from TikMatrix!",
      "access_method": "search"
    }
  }'

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

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

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@target_user"],
      "message_content": "Hi there!"
    }
  }'

الإرسال على عدة أجهزة

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@influencer_account"],
      "message_content": "Love your content! Let's collaborate."
    },
    "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": "message",
    "script_config": {
      "target_user": "instagram_username",
      "message_content": "Hey! Loved your post"
    }
  }'

الاستجابة

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

طرق الوصول

الطريقة المباشرة (direct)

تفتح ملف المستخدم عبر URL. أسرع وأكثر موثوقية. مُوصى بها.

طريقة البحث (search)

تنتقل إلى البحث وتكتب اسم المستخدم. أبطأ لكن تعمل عند حجب URL المباشر.

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

1. جدولة المهام: استخدم start_time.

2. تخصيص الرسائل: خصص محتوى الرسالة لجعلها تبدو شخصية.

3. الطريقة المباشرة: أسرع وأكثر موثوقية.

4. احترام حدود المنصة: لا تنشئ عدداً كبيراً من مهام الرسائل دفعة واحدة.

رموز الخطأ

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

انظر أيضاً

• API إدارة المهام
• تكوين نص المتابعة
• تكوين نص التعليق
• نظرة عامة على API المحلي