Passa al contenuto principale

Configurazione Script Post

Questa pagina documenta i parametri di configurazione per lo script post utilizzato nella creazione delle attività.

Panoramica​

Lo script post viene utilizzato per pubblicare automaticamente contenuti (video o immagini) su TikTok o Instagram. Supporta vari metodi di pubblicazione, fonti di materiale e opzioni audio.

Parametri della Richiesta​

Quando si crea un'attività, è possibile specificare i seguenti parametri di livello superiore:

ParametroTipoObbligatorioPredefinitoDescrizione
serialsstring[]Condizionale[]Elenco dei numeri di serie dei dispositivi (Modalità 1: basata su dispositivo)
usernamesstring[]Condizionale[]Elenco degli username per cui creare attività (Modalità 2: basata su username)
script_namestringSì-Nome dello script da eseguire (es. "post")
script_configobjectSì-Parametri di configurazione dello script (vedi sotto)
enable_multi_accountbooleanNofalseAbilita modalità multi-account (crea attività per ogni account sul dispositivo)
start_timestringNo-Ora di inizio facoltativa nel formato "HH:MM"
platformstringCondizionale*autoPiattaforma di destinazione: tiktok, instagram. Vedi nota sotto

Nota: Deve essere fornito serials o usernames.

*Comportamento del Parametro Platform:

  • TikMatrix e IgMatrix: Il parametro platform viene ignorato se fornito. La piattaforma viene determinata automaticamente dal nome dell'app (TikMatrix → tiktok, IgMatrix → instagram).
  • TikMatrix Pro: Il parametro platform è obbligatorio e deve essere specificato esplicitamente come tiktok o instagram.

Configurazione Script (script_config)​

L'oggetto script_config contiene i parametri per lo script post. Di seguito sono riportati i parametri disponibili:

Parametri Comuni (TikTok e Instagram)​

ParametroTipoObbligatorioPredefinitoDescrizione
content_typeintegerNo0Tipo di contenuto: 0 = Video, 1 = Immagini
image_countintegerNo1Numero di immagini da selezionare (quando content_type = 1)
captionsstringNo""Testo della didascalia per il post. Supporta formato spintax: {opzione1|opzione2|opzione3}
post_waystringNo"share"Metodo di pubblicazione: share, addButton, o useSound
material_sourcestringNo"materialLibrary"Fonte del materiale: materialLibrary o localFolder (ignorato se viene fornito material_list)
material_pathstringCondizionale""Percorso della cartella locale (obbligatorio quando material_source = "localFolder")
material_liststring[]No[]Array di percorsi diretti dei file materiali. Quando fornito, bypassa la logica di material_source e material_path. Ideale per l'automazione API.
materials_tagsstringNo""Tag dei materiali separati da virgola per filtrare dalla libreria
upload_wait_timeintegerNo30Secondi di attesa per il completamento del caricamento
sound_wait_timeintegerNo10Secondi di attesa per il caricamento dell'audio
add_soundstring/integerNo"-1"Opzione audio: -1 = predefinito, 0 = disabilita, 1 = abilita, custom = usa audio personalizzato
sound_namestringCondizionale""Nome/URL dell'audio (obbligatorio quando post_way = "useSound")
custom_sound_keywordstringCondizionale""Parola chiave per cercare audio personalizzato (obbligatorio quando add_sound = "custom")
origin_sound_volumeintegerNo50Volume audio originale (0-100)
add_sound_volumeintegerNo50Volume audio aggiunto (0-100)

Parametri Specifici per TikTok​

ParametroTipoObbligatorioPredefinitoDescrizione
add_product_linkintegerNo0Aggiungi link prodotto: 0 = No, 1 = Sì

Parametri Specifici per Instagram​

ParametroTipoObbligatorioPredefinitoDescrizione
placementstringNo"reel"Posizionamento del post: reel o story

Esempi​

Attività di Pubblicazione Base con Lista Materiali Diretta​

Questo è l'approccio raccomandato per l'automazione API - passare i percorsi dei materiali direttamente senza fare affidamento sulla libreria materiali o sulla scansione delle cartelle:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Guarda il mio nuovo video! #virale #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Attività di Pubblicazione con Libreria Materiali (TikTok)​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Guarda il mio nuovo video! #virale #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "tendenza, danza",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Attività di Pubblicazione per Lista di Username​

Questa modalità consente di creare attività direttamente per account specifici senza conoscere i loro numeri di serie del dispositivo:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Guarda il mio nuovo video! #virale #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Attività di Pubblicazione con Cartella Locale (Instagram)​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Contenuto fantastico! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Pubblicazione con Audio Personalizzato​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Ballando su questo suono di tendenza!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "danza tendenza 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Pubblicazione Usando URL Audio Specifico​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "Usando questo suono fantastico!",
      "material_source": "materialLibrary"
    }
  }'

Pubblicazione Immagini (Carosello)​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "Guarda queste foto! #carosellofoto",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Pubblicazione con Selezione Esplicita della Piattaforma​

Puoi specificare esplicitamente la piattaforma di destinazione utilizzando il parametro platform. Questo è utile quando vuoi sovrascrivere l'impostazione predefinita dell'ambiente:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "Pubblicando su Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Risposta​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Vedi Anche​