Ga naar hoofdinhoud

Bericht-script Configuratie

message kan niet worden aangemaakt

Het aanmaken van taken weigert message: de script-binary heeft er op geen van beide platforms een handler voor, dus elke zo’n taak mislukte op het apparaat met "Unknown script". De parameters hieronder blijven alleen ter referentie staan. Gebruik voor directe berichten Super Marketing.

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​