Zum Hauptinhalt springen

Message-Skript-Konfiguration

message kann nicht erstellt werden

Die Aufgabenerstellung lehnt message ab: Die Skript-Binary hat auf keiner der beiden Plattformen einen Handler dafür, sodass jede solche Aufgabe auf dem Gerät mit "Unknown script" fehlschlug. Die folgenden Parameter bleiben nur als Referenz bestehen. Für Direktnachrichten verwenden Sie Super Marketing.

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​