Hoppa till huvudinnehåll

Meddelandeskript Konfiguration

Aktuellt beteende\nThreads har nu ett fristående message-skript; använd target_users eller target_user tillsammans med message_content. Den gamla texten om att det inte kunde skapas finns bara som historisk referens; använd Super Marketing för TikTok/Instagram.\n:::
message kan inte skapas

Uppgiftsskapandet avvisar message: skriptbinären har ingen hanterare för det på någon av plattformarna, så varje sådan uppgift misslyckades på enheten med "Unknown script". Parametrarna nedan finns kvar enbart som referens. För direktmeddelanden idag, använd Super Marketing.

Den här sidan dokumenterar konfigurationsparametrarna för message-skriptet.

Översikt​

message-skriptet skickar automatiskt direktmeddelanden till användare på TikTok eller Instagram. Med flera målanvändare via API:t skapas en uppgift per användare. Styr timing med start_time.

Skriptkonfiguration (script_config)​

Konfigurationsparametrar för meddelandeskriptet:

Parametrar​

ParameterTypKrävsStandardBeskrivning
target_usersstring[]Yes*[]Array med målanvändare (en uppgift per användare)
target_userstringYes*""Enstaka användarnamn eller flera separerade med radbrytningar/kommatecken
message_contentstringYes""Textinnehållet i meddelandet
access_methodstringNo"direct"Åtkomstmetod: direct eller search
anteckning

Antingen target_users-arrayen eller target_user-strängen måste anges. target_users har prioritet.

info

Med flera målanvändare skapar API:t en uppgift per användare. 3 användare + 2 enheter = 6 uppgifter.

Exempel​

Skicka meddelande till en användare​

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

Skicka meddelanden till flera användare​

En uppgift per användare:

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

Skapar 3 separata uppgifter som körs omedelbart.

Planera meddelanden med starttid​

Använd start_time för att schemalägga:

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

Skicka via sökmetoden​

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

Skicka meddelanden via användarnamnslista​

Skapa meddelandeuppgifter för specifika konton:

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-meddelanden på flera enheter​

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

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

Svar​

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

Åtkomstmetoder​

Direktmetod (direct)​

Öppnar användarprofil via URL. Snabbare och mer tillförlitlig.

Navigerar till sök och skriver namnet. Långsammare men fungerar när direktåtkomst är blockerad.

Bästa Praxis​

  1. Schemalägg: Använd start_time.

  2. Personalisera: Anpassa innehållet.

  3. Direktåtkomst föredras: Snabbare och mer tillförlitlig.

  4. Respektera limiter: Inte för många uppgifter på en gång.

Felkoder​

CodeDescription
40001Målanvändare eller meddelandeinnehåll saknas
40003Skript stöds inte via API
40301Pro+-plan krävs

Se Även​