Mesaj Skript Yapılandırması
Bu sayfa, message skriptinin yapılandırma parametrelerini belgeler.
Genel Bakış
message skripti, TikTok veya Instagram'daki kullanıcılara otomatik olarak doğrudan mesaj gönderir. Birden fazla hedef kullanıcı ile her kullanıcı için bir görev oluşturulur. start_time ile zamanlamayı kontrol edin.
Skript Yapılandırması (script_config)
Mesaj skripti yapılandırma parametreleri:
Parametreler
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|---|
| target_users | string[] | Yes* | [] | Hedef kullanıcı dizisi (kullanıcı başına bir görev) |
| target_user | string | Yes* | "" | Tek kullanıcı adı veya yeni satır/virgülle ayrılmış birden fazla |
| message_content | string | Yes | "" | Gönderilecek metin mesajı içeriği |
| access_method | string | No | "direct" | Erişim yöntemi: direct veya search |
target_users veya target_user gerekli. Her ikisi varsa target_users öncelikli.
Birden fazla hedef kullanıcı ile API her kullanıcı için bir görev oluşturur. 3 kullanıcı + 2 cihaz = 6 görev.
Örnekler
Tek kullanıcıya mesaj gönderme
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"
}
}'
Birden fazla kullanıcıya mesaj
Her kullanıcı için bir görev:
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."
}
}'
Anında yürütülen 3 ayrı görev oluşturur.
Başlangıç zamanıyla mesajları planlama
start_time ile planlama:
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"
}'
Arama yöntemiyle mesaj gönderme
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"
}
}'
Kullanıcı adı listesiyle mesaj
Belirli hesaplar için doğrudan mesaj görevi:
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!"
}
}'
Birden fazla cihazda toplu mesaj
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 Örneği
Aynı API Instagram için:
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"
}
}'
Yanıt
{
"code": 0,
"message": "success",
"data": {
"task_ids": [501, 502, 503],
"created_count": 3
}
}
Erişim Yöntemleri
Doğrudan Yöntem (direct)
Kullanıcı profilini URL ile açar. Daha hızlı ve güvenilir.
Arama Yöntemi (search)
Aramaya gider ve adı yazar. Yavaş ama doğrudan erişim engellendiğinde çalışır.
En İyi Uygulamalar
-
Görevleri planlayın:
start_timekullanın. -
Mesajları kişiselleştirin: İçeriği uyarlayın.
-
Doğrudan erişimi tercih edin: Daha hızlı ve güvenilir.
-
Platform sınırlarına saygı: Çok fazla görev oluşturmayın.
Hata Kodları
| Code | Description |
|---|---|
| 40001 | Hedef kullanıcılar veya mesaj içeriği eksik |
| 40003 | Skript API aracılığıyla desteklenmiyor |
| 40301 | Pro+ planı gerekli |