Ana içeriğe geç

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

ParametreTürGerekliVarsayılanAçıklama
target_usersstring[]Yes*[]Hedef kullanıcı dizisi (kullanıcı başına bir görev)
target_userstringYes*""Tek kullanıcı adı veya yeni satır/virgülle ayrılmış birden fazla
message_contentstringYes""Gönderilecek metin mesajı içeriği
access_methodstringNo"direct"Erişim yöntemi: direct veya search
not

target_users veya target_user gerekli. Her ikisi varsa target_users öncelikli.

bilgi

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.

Aramaya gider ve adı yazar. Yavaş ama doğrudan erişim engellendiğinde çalışır.

En İyi Uygulamalar

  1. Görevleri planlayın: start_time kullanın.

  2. Mesajları kişiselleştirin: İçeriği uyarlayın.

  3. Doğrudan erişimi tercih edin: Daha hızlı ve güvenilir.

  4. Platform sınırlarına saygı: Çok fazla görev oluşturmayın.

Hata Kodları

CodeDescription
40001Hedef kullanıcılar veya mesaj içeriği eksik
40003Skript API aracılığıyla desteklenmiyor
40301Pro+ planı gerekli

Ayrıca Bakınız