Configurazione Script Comment
Questa pagina documenta i parametri di configurazione per lo script comment usato nella creazione delle attività.
Questa pagina copre lo script comment, che pubblica un nuovo commento di primo livello su un post. Per mettere mi piace o rispondere a un commento esistente (la funzione "REPLY COMMENT" / Boost Comments), usa invece lo script boost_comment.
Panoramica
Lo script comment viene usato per pubblicare automaticamente commenti sui post di TikTok o Instagram. Quando fornisci più URL di post target tramite API, viene creata un'attività per ogni URL di post target. Puoi controllare quando ogni attività viene eseguita usando il parametro start_time.
Configurazione dello Script (script_config)
L'oggetto script_config contiene i parametri per lo script comment. Di seguito sono elencati i parametri disponibili:
Parametri
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
| target_post_urls | string[] | Sì* | [] | Array di URL di post target su cui commentare (un'attività per URL) |
| target_post_url | string | Sì* | "" | Singolo URL di post target o più URL separati da a capo/virgole |
| comment_content | string | Sì | "" | Contenuto testuale del commento. Può contenere più commenti separati da a capo |
| comment_order | string | No | "random" | Come selezionare i commenti: random o sequential |
| insert_emoji | boolean | No | false | Se inserire emoji casuali nel commento |
| comment_image_path | string | No | "" | Percorso del file immagine per il commento con immagine (solo TikTok). Supporta percorso assoluto o percorso relativo a work_dir/upload/ |
Deve essere fornito o l'array target_post_urls o la stringa target_post_url. Se sono forniti entrambi, target_post_urls ha la priorità.
Il parametro comment_image_path ti permette di allegare un'immagine al tuo commento. Questa funzione è supportata solo su TikTok - i commenti di Instagram non supportano gli allegati immagine. L'immagine verrà inviata al dispositivo e selezionata come prima immagine nella galleria.
Quando vengono forniti più URL di post target, l'API crea un'attività per ogni URL di post target. Ad esempio, se specifichi 3 URL di post e 2 dispositivi, verranno create 6 attività. Usa il parametro start_time per controllare quando le attività iniziano l'esecuzione.
Esempi
Commenta un Singolo Post
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890",
"comment_content": "Great content! 🔥"
}
}'
Commenta con Più Opzioni di Commento
Fornisci più commenti separati da a capo. Il sistema ne selezionerà uno in base a comment_order:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890",
"comment_content": "Amazing video!\nLove this content!\nKeep it up! 👏\nThis is so good!",
"comment_order": "random"
}
}'
Commenta Più Post
Quando commenti su più post, viene creata un'attività per ogni post:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_urls": [
"https://www.tiktok.com/@user1/video/111",
"https://www.tiktok.com/@user2/video/222",
"https://www.tiktok.com/@user3/video/333"
],
"comment_content": "Great video!\nAwesome!\nLove it!",
"comment_order": "sequential"
}
}'
Questo crea 3 attività separate che vengono eseguite immediatamente.
Pianifica Commenti con Ora di Inizio
Usa start_time per pianificare quando le attività devono iniziare:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890",
"comment_content": "Scheduled comment!"
},
"start_time": "14:30"
}'
Commenta con Inserimento di Emoji
Attiva l'inserimento automatico di emoji per rendere i commenti più coinvolgenti:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890",
"comment_content": "This is amazing",
"insert_emoji": true
}
}'
Commenta in Modalità Elenco Nomi Utente
Crea attività di commento direttamente 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": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@target/video/123",
"comment_content": "Nice video!"
}
}'
Commento in Blocco 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": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@viral/video/999",
"comment_content": "Great content!\nAmazing work!\nLove this!",
"comment_order": "random"
},
"enable_multi_account": true
}'
Esempio di Commento Instagram
La stessa API funziona per i post di Instagram:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.instagram.com/p/ABC123/",
"comment_content": "Beautiful photo! 📸",
"insert_emoji": true
}
}'
Esempio di Commento con Immagine su TikTok
Allega un'immagine al tuo commento TikTok (non supportato su Instagram):
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "comment",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890",
"comment_content": "Check out this image!",
"comment_image_path": "C:/images/my_image.jpg"
}
}'
Il comment_image_path può essere:
- Percorso assoluto:
C:/images/my_image.jpgo/home/user/images/my_image.jpg - Percorso relativo:
my_image.jpg(relativo awork_dir/upload/)
Risposta
{
"code": 0,
"message": "success",
"data": {
"task_ids": [301, 302, 303],
"created_count": 3
}
}
Ordine dei Commenti
Ordine Casuale (random)
- Seleziona casualmente un commento dall'elenco fornito
- Utile per rendere i commenti più naturali
- Comportamento predefinito
Ordine Sequenziale (sequential)
- Seleziona i commenti in ordine in base a
job_count - La prima attività usa il primo commento, la seconda attività il secondo commento, ecc.
- Ritorna all'inizio quando raggiunge la fine dell'elenco
- Utile per distribuire commenti diversi su più attività
Formati URL dei Post
TikTok
https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/
Instagram
https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/
Best Practice
-
Varia i tuoi commenti: fornisci più opzioni di commento per evitare di sembrare spam.
-
Usa l'ordine sequenziale per variare: quando commenti su più post con lo stesso dispositivo, usa l'ordine
sequentialper distribuire commenti diversi. -
Attiva l'inserimento di emoji: imposta
insert_emoji: trueper rendere i commenti più naturali e coinvolgenti. -
Pianifica le attività: usa il parametro
start_timeper distribuire i commenti nel tempo, riducendo la probabilità di limitazioni di frequenza. -
Rispetta i limiti della piattaforma: non creare troppe attività di commento in una volta. La maggior parte delle piattaforme ha limiti di frequenza sui commenti.
Codici di Errore
| Codice | Descrizione |
|---|---|
| 40001 | URL del post target o contenuto del commento mancante |
| 40003 | Script non supportato tramite API |
| 40301 | L'accesso API richiede il piano Pro+ |
Vedi Anche
- Configurazione Script Boost Comment (Reply) - metti mi piace / rispondi ai commenti esistenti
- API di Gestione Attività - crea, elenca e gestisci le attività
- Configurazione Script Post - configura i parametri dello script post
- Configurazione Script Follow - configura i parametri dello script follow
- Panoramica Local API - panoramica dell'API e avvio rapido