תצורת סקריפט הודעות
דף זה מתאר פרמטרי תצורה של סקריפט message.
סקירה כללית
סקריפט message שולח הודעות ישירות אוטומטית למשתמשים ב-TikTok או Instagram. עם מספר משתמשים, נוצרת משימה לכל משתמש. שלוט בתזמון עם start_time.
הגדרות הסקריפט (script_config)
פרמטרי תצורה לסקריפט הודעות:
פרמטרים
| פרמטר | סוג | נדרש | ברירת מחדל | תיאור |
|---|---|---|---|---|
| target_users | string[] | Yes* | [] | מערך משתמשים מטרה (משימה לכל משתמש) |
| target_user | string | Yes* | "" | שם משתמש יחיד או מספר, מופרדים בירידות שורה/פסיקים |
| message_content | string | Yes | "" | תוכן הודעת הטקסט |
| access_method | string | No | "direct" | שיטת גישה: direct או search |
note
target_users או target_user חייב להיות מסופק. target_users קודם.
info
עם מספר משתמשים, API יוצר משימה לכל משתמש. 3 משתמשים + 2 מכשירים = 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)
מנווט לחיפוש ומקליד את שם המשתמש. איטי יותר אך עובד כשהגישה הישירה חסומה.
שיטות עבודה מומלצות
-
תזמן משימות: השתמש ב-
start_time. -
התאם הודעות: הפוך אותן לאישיות.
-
העדף גישה ישירה: מהיר ואמין.
-
כבד מגבלות פלטפורמה: אל תיצור יותר מדי משימות בבת אחת.
קודי שגיאה
| Code | Description |
|---|---|
| 40001 | משתמשי מטרה או תוכן הודעה חסרים |
| 40003 | הסקריפט אינו נתמך דרך ה-API |
| 40301 | גישה ל-API דורשת תוכנית Pro+ |