Passa al contenuto principale

Configurazione Script Messaggio

Questa pagina documenta i parametri dello script message per la creazione di attività.

Panoramica​

Lo script message invia automaticamente messaggi diretti agli utenti su TikTok o Instagram. Con più utenti target via API, un'attività per utente. Controlla il timing con start_time.

Configurazione Script (script_config)​

Parametri di configurazione dello script messaggio:

Parametri​

ParametroTipoRichiestoDefaultDescrizione
target_usersstring[]Yes*[]Array di utenti target (un'attività per utente)
target_userstringYes*""Username singolo o più separati da newline/virgole
message_contentstringYes""Contenuto del messaggio testuale
access_methodstringNo"direct"Metodo di accesso: direct o search
note

target_users o target_user deve essere fornito. target_users ha priorità.

informazioni

Con più utenti target, l'API crea un'attività per utente. 3 utenti + 2 dispositivi = 6 attività.

Esempi​

Inviare messaggio a un utente​

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

Inviare messaggi a più utenti​

Un'attività per utente:

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

Crea 3 attività separate eseguite immediatamente.

Pianificare messaggi con orario di inizio​

Usa start_time per pianificare:

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

Inviare messaggio via ricerca​

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

Inviare messaggi tramite lista username​

Creare attività di messaggi per account specifici:

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

Messaggi in batch su più dispositivi​

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

Esempio Instagram​

La stessa API per 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"
    }
  }'

Risposta​

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

Metodi di Accesso​

Metodo diretto (direct)​

Apre il profilo utente via URL. Più veloce e affidabile.

Naviga alla ricerca e digita il nome. Più lento ma funziona se l'accesso diretto è bloccato.

Buone Pratiche​

  1. Pianifica le attività: Usa start_time.

  2. Personalizza i messaggi: Adatta il contenuto.

  3. Preferisci l'accesso diretto: Più veloce e affidabile.

  4. Rispetta i limiti della piattaforma: Non creare troppe attività in una volta.

Codici di Errore​

CodeDescription
40001Utenti target o contenuto del messaggio mancanti
40003Script non supportato via API
40301Piano Pro+ richiesto

Vedere Anche​