Zum Hauptinhalt springen

Message-Skript-Konfiguration

Diese Seite beschreibt die Konfigurationsparameter für das message-Skript.

Übersicht​

Das message-Skript sendet automatisch Direktnachrichten an Nutzer auf TikTok oder Instagram. Bei mehreren Zielnutzern via API wird eine Aufgabe pro Nutzer erstellt. Steuern Sie das Timing mit start_time.

Skript-Konfiguration (script_config)​

Konfigurationsparameter für das Message-Skript:

Parameter​

ParameterTypErforderlichStandardBeschreibung
target_usersstring[]Yes*[]Array von Zielnutzern (eine Aufgabe pro Nutzer)
target_userstringYes*""Einzelner Nutzername oder mehrere, getrennt durch Zeilenumbrüche/Kommas
message_contentstringYes""Nachrichteninhalt
access_methodstringNo"direct"Navigationsweise: direct oder search
hinweis

target_users oder target_user muss angegeben werden. target_users hat Vorrang.

info

Bei mehreren Zielnutzern erstellt die API eine Aufgabe pro Nutzer. 3 Nutzer + 2 Geräte = 6 Aufgaben.

Beispiele​

Nachricht an einen Nutzer​

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"
    }
  }'

Nachrichten an mehrere Nutzer​

Eine Aufgabe pro Nutzer:

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."
    }
  }'

Erstellt 3 sofort ausgeführte Aufgaben.

Nachrichten mit Startzeit planen​

Verwenden Sie start_time zum Planen:

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"
  }'

Nachricht über Suchmethode​

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"
    }
  }'

Nachrichten per Nutzernamen-Liste​

Nachricht-Aufgaben für bestimmte Konten:

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!"
    }
  }'

Batch-Nachrichten auf mehreren Geräten​

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-Beispiel​

Dieselbe API für 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"
    }
  }'

Antwort​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

Zugriffsmethoden​

Direkte Methode (direct)​

Öffnet Nutzerprofil über URL. Schneller und zuverlässiger.

Navigiert zur Suche und tippt den Nutzernamen. Langsamer, aber funktioniert bei blockiertem Direktzugriff.

Best Practices​

  1. Aufgaben planen: Verwenden Sie start_time.

  2. Nachrichten personalisieren: Passen Sie den Inhalt an.

  3. Direktzugriff bevorzugen: Schneller und zuverlässiger.

  4. Plattformlimits beachten: Nicht zu viele Aufgaben auf einmal erstellen.

Fehlercodes​

CodeDescription
40001Fehlende Zielnutzer oder Nachrichteninhalt
40003Skript wird über API nicht unterstützt
40301API-Zugang erfordert Pro+-Plan

Siehe auch​