Ga naar hoofdinhoud

Bericht-script Configuratie

Deze pagina documenteert de configuratieparameters voor het message-script.

Overzicht​

Het message-script stuurt automatisch directe berichten naar gebruikers op TikTok of Instagram. Met meerdere doelgebruikers via de API, wordt één taak per gebruiker aangemaakt. Beheer timing met start_time.

Scriptconfiguratie (script_config)​

Configuratieparameters voor het bericht-script:

Parameters​

ParameterTypeVereistStandaardBeschrijving
target_usersstring[]Yes*[]Array van doelgebruikers (één taak per gebruiker)
target_userstringYes*""Enkelvoudige gebruikersnaam of meerdere, gescheiden door regeleinden/komma's
message_contentstringYes""Inhoud van het tekstbericht
access_methodstringNo"direct"Toegangsmethode: direct of search
notitie

target_users of target_user moet worden opgegeven. target_users heeft prioriteit.

info

Met meerdere doelgebruikers maakt de API één taak per gebruiker aan. 3 gebruikers + 2 apparaten = 6 taken.

Voorbeelden​

Bericht naar één gebruiker sturen​

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

Berichten naar meerdere gebruikers sturen​

Één taak per gebruiker:

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

Maakt 3 afzonderlijke taken direct uitvoerbaar.

Berichten plannen met begintijd​

Gebruik start_time om te plannen:

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

Bericht sturen via zoekmethode​

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

Berichten sturen via gebruikersnaamlijst​

Berichttaken aanmaken voor specifieke accounts:

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 berichten op meerdere apparaten​

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

Dezelfde API voor 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"
    }
  }'

Reactie​

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

Toegangsmethoden​

Directe methode (direct)​

Opent gebruikersprofiel via URL. Sneller en betrouwbaarder.

Navigeert naar zoeken en typt de naam. Langzamer maar werkt als directe URL geblokkeerd is.

Aanbevolen Procedures​

  1. Plan taken: Gebruik start_time.

  2. Personaliseer berichten: Pas inhoud aan om persoonlijk te lijken.

  3. Directe toegang voorkeur: Sneller en betrouwbaarder.

  4. Respecteer limieten: Niet te veel taken tegelijk aanmaken.

Foutcodes​

CodeDescription
40001Doelgebruikers of berichtinhoud ontbreken
40003Script niet ondersteund via API
40301Pro+-abonnement vereist

Zie Ook​