Hoppa till huvudinnehåll

Meddelandeskript Konfiguration

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​