Konfiguracja Skryptu Wiadomości
message nie może zostać utworzonyTworzenie zadań odrzuca message: binarka skryptów nie ma dla niego obsługi na żadnej z platform, więc każde takie zadanie kończyło się na urządzeniu błędem "Unknown script". Poniższe parametry pozostają wyłącznie jako materiał referencyjny. Do wysyłania wiadomości prywatnych użyj Super Marketing.
Ta strona dokumentuje parametry skryptu message.
Przegląd
Skrypt message automatycznie wysyła wiadomości bezpośrednie do użytkowników na TikTok lub Instagram. Przy wielu docelowych użytkownikach, jedno zadanie na użytkownika. Kontroluj czas przez start_time.
Konfiguracja Skryptu (script_config)
Parametry konfiguracji skryptu wiadomości:
Parametry
| Parametr | Typ | Wymagany | Domyślny | Opis |
|---|---|---|---|---|
| target_users | string[] | Yes* | [] | Tablica docelowych użytkowników (jedno zadanie na użytkownika) |
| target_user | string | Yes* | "" | Pojedyncza nazwa lub wiele oddzielonych nowymi liniami/przecinkami |
| message_content | string | Yes | "" | Zawartość wiadomości tekstowej |
| access_method | string | No | "direct" | Metoda dostępu: direct lub search |
target_users lub target_user jest wymagany. target_users ma pierwszeństwo.
Przy wielu użytkownikach API tworzy jedno zadanie na użytkownika. 3 użytkowników + 2 urządzenia = 6 zadań.
Przykłady
Wysłanie wiadomości do jednego użytkownika
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"
}
}'
Wysyłanie wiadomości do wielu użytkowników
Jedno zadanie na użytkownika:
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."
}
}'
Tworzy 3 zadania wykonywane natychmiast.
Zaplanowanie wiadomości z czasem startu
Użyj start_time do planowania:
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"
}'
Wiadomość przez metodę wyszukiwania
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"
}
}'
Wysyłanie przez listę nazw użytkowników
Zadania wiadomości dla konkretnych kont:
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!"
}
}'
Wsadowe wysyłanie na wielu urządzeniach
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
}'
Przykład Instagram
Ten sam API dla 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"
}
}'
Odpowiedź
{
"code": 0,
"message": "success",
"data": {
"task_ids": [501, 502, 503],
"created_count": 3
}
}
Metody Dostępu
Metoda bezpośrednia (direct)
Otwiera profil przez URL. Szybsza i bardziej niezawodna.
Metoda wyszukiwania (search)
Nawiguje do wyszukiwania i wpisuje nazwę. Wolniejsza, ale działa gdy bezpośredni dostęp jest zablokowany.
Najlepsze Praktyki
-
Planuj zadania: Użyj
start_time. -
Personalizuj wiadomości: Dostosuj treść.
-
Preferuj bezpośredni dostęp: Szybszy i niezawodniejszy.
-
Szanuj limity: Nie twórz zbyt wielu zadań naraz.
Kody Błędów
| Code | Description |
|---|---|
| 40001 | Brak docelowych użytkowników lub treści wiadomości |
| 40003 | Skrypt nie jest obsługiwany |
| 40301 | Plan Pro+ wymagany |