Przejdź do głównej zawartości

Konfiguracja Skryptu Wiadomości

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​

ParametrTypWymaganyDomyślnyOpis
target_usersstring[]Yes*[]Tablica docelowych użytkowników (jedno zadanie na użytkownika)
target_userstringYes*""Pojedyncza nazwa lub wiele oddzielonych nowymi liniami/przecinkami
message_contentstringYes""Zawartość wiadomości tekstowej
access_methodstringNo"direct"Metoda dostępu: direct lub search
notatka

target_users lub target_user jest wymagany. target_users ma pierwszeństwo.

informacja

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.

Nawiguje do wyszukiwania i wpisuje nazwę. Wolniejsza, ale działa gdy bezpośredni dostęp jest zablokowany.

Najlepsze Praktyki​

  1. Planuj zadania: Użyj start_time.

  2. Personalizuj wiadomości: Dostosuj treść.

  3. Preferuj bezpośredni dostęp: Szybszy i niezawodniejszy.

  4. Szanuj limity: Nie twórz zbyt wielu zadań naraz.

Kody Błędów​

CodeDescription
40001Brak docelowych użytkowników lub treści wiadomości
40003Skrypt nie jest obsługiwany
40301Plan Pro+ wymagany

Zobacz Również​