Configuration du Script de Publication

Cette page documente les paramètres de configuration du script post utilisé lors de la création de tâches.

Vue d'ensemble

Le script post permet de publier automatiquement du contenu (vidéos ou images) sur TikTok ou Instagram. Il supporte plusieurs méthodes de publication, sources de matériel et options audio.

Paramètres de Requête

Lors de la création d'une tâche, vous pouvez spécifier les paramètres de niveau supérieur suivants :

Paramètre	Type	Requis	Valeur par défaut	Description
serials	string[]	Conditionnel	[]	Liste des numéros de série des appareils (Mode 1 : basé sur l'appareil)
usernames	string[]	Conditionnel	[]	Liste des noms d'utilisateur pour créer des tâches (Mode 2 : basé sur le nom d'utilisateur)
script_name	string	Oui	-	Nom du script à exécuter (par exemple, "post")
script_config	object	Oui	-	Paramètres de configuration du script (voir ci-dessous)
enable_multi_account	boolean	Non	false	Activer le mode multi-comptes (créer une tâche pour chaque compte sur l'appareil)
start_time	string	Non	-	Heure de début optionnelle au format "HH:MM"
platform	string	Conditionnel*	auto	Plateforme cible : `tiktok`, `instagram`. Voir la note ci-dessous

Note : serials ou usernames doit être fourni.

*Comportement du Paramètre Platform :

TikMatrix et IgMatrix : Le paramètre platform est ignoré s'il est fourni. La plateforme est automatiquement déterminée à partir du nom de l'application (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro : Le paramètre platform est requis et doit être explicitement spécifié comme tiktok ou instagram.

Configuration du Script (`script_config`)

L'objet script_config contient les paramètres du script de publication. Voici les paramètres disponibles :

Paramètres Communs (TikTok et Instagram)

Paramètre	Type	Requis	Valeur par défaut	Description
content_type	integer	Non	0	Type de contenu : `0` = vidéo, `1` = image
image_count	integer	Non	1	Nombre d'images à sélectionner (lorsque content_type = 1)
captions	string	Non	""	Texte de légende de la publication. Supporte le format spintax : `{option1\|option2\|option3}`
caption_format	string	Non	"multiline"	Comment gérer les légendes multi-lignes : `multiline` (insérer de vraies nouvelles lignes) ou `singleline` (remplacer `\n` par des espaces)
ai_label	boolean	Non	false	S'il faut ajouter le label de contenu généré par IA à la publication
save_draft	boolean	Non	false	Sauvegarder la publication en tant que brouillon plutôt que de publier immédiatement
post_way	string	Non	"addButton"	Méthode de publication. Consultez la section Méthodes de publication ci-dessous pour plus de détails
material_source	string	Non	"materialLibrary"	Source du matériel : `materialLibrary` (bibliothèque de matériel) ou `localFolder` (dossier local), ignoré si material_list est fourni
material_path	string	Conditionnel	""	Chemin du dossier local (requis lorsque material_source = "localFolder")
material_list	string[]	Non	[]	Tableau direct de chemins de fichiers de matériel. Lorsque ce paramètre est fourni, la logique de material_source et material_path est ignorée. Recommandé pour les scénarios d'automatisation API.
materials_tags	string	Non	""	Tags de matériel séparés par des virgules, pour filtrer depuis la bibliothèque de matériel
upload_wait_time	integer	Non	10	Secondes d'attente pour la fin du téléchargement

upload_wait_time s’applique à la fois à la publication normale et au mode save_draft. Même lors d’un enregistrement en brouillon, TikTok/Instagram a encore besoin de temps pour terminer l’envoi de la vidéo en arrière-plan. | sound_wait_time | integer | Non | 10 | Secondes d'attente pour le chargement de l'audio | | add_sound | string/integer | Non | "-1" | Options audio : -1 = par défaut, 0 = désactivé, 1 = activé, custom = utiliser audio personnalisé | | sound_name | string | Conditionnel | "" | Nom/URL de l'audio (requis lorsque post_way = "useSound") | | custom_sound_keyword | string | Conditionnel | "" | Mot-clé pour rechercher l'audio personnalisé (requis lorsque add_sound = "custom") | | origin_sound_volume | integer | Non | 100 | Volume audio d'origine (0-100) | | add_sound_volume | integer | Non | 100 | Volume audio ajouté (0-100) |

Méthodes de publication (`post_way`)

Le paramètre post_way contrôle la manière dont le script ouvre l'écran de publication :

Valeur	Description
`addButton`	(Par défaut) Appuie sur le bouton de création "+" dans l'application, puis sélectionne le média dans la galerie de l'appareil. Fonctionne avec tous les emplacements (`reel`, `story`, `post`). Recommandé dans la plupart des cas.
`share`	Déclenche une intention de partage Android directement depuis le fichier média vers l'application Instagram/TikTok. C'est une méthode alternative qui contourne la navigation dans l'application ; utile lorsque le flux `addButton` est peu fiable sur un appareil ou une version d'application donnée.
`useSound`	Navigue d'abord vers une piste audio spécifique (via l'URL ou le mot-clé de `sound_name`), puis associe la vidéo à ce son. Pour Reels / TikTok uniquement. Nécessite que `sound_name` soit défini. Non compatible avec `placement = "post"` ou `placement = "story"`.

remarque

Lorsque placement vaut post (publication dans le fil Instagram), l'automatisation du son n'est pas prise en charge quel que soit post_way. Le script ignorera automatiquement l'étape sonore.

Paramètres Spécifiques à TikTok

Paramètre	Type	Requis	Valeur par défaut	Description
placement	string	Non	""	Emplacement de publication : `""` (vidéo normale, défaut) ou `"story"` (TikTok Story). Avec `"story"`, le script clique sur "Your Story" après la configuration du son, en ignorant le titre/lien produit/étiquette IA.
add_product_link	integer	Non	0	S'il faut ajouter un lien produit/shopping : `0` = non, `1` = oui

Paramètres Spécifiques à Instagram

Paramètre	Type	Requis	Valeur par défaut	Description
placement	string	Non	"reel"	Emplacement de publication : `reel` (Reels), `story` (Stories) ou `post` (publication classique dans le fil). Remarque : les options audio ne sont pas prises en charge lorsque `placement` vaut `post`
enable_schedule_reels	boolean	Non	false	S'il faut planifier le Reel pour un moment futur
schedule_reels_time	string	Conditionnel	""	Heure de publication planifiée au format `YYYY-MM-DD HH:MM` (requis lorsque enable_schedule_reels = true)
story_link	string	Non	""	URL à joindre comme lien d'autocollant sur une Story (s'applique uniquement lorsque placement = "story")

Exemples

Publication en Story TikTok

Publiez directement en Story TikTok. Après la configuration du son, le script clique sur « Your Story » — sans étape de titre/lien produit/étiquette IA :

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,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

Tâche de Publication Basique - Passage Direct de Chemins de Matériel

C'est la méthode recommandée pour l'automatisation API - passage direct de chemins de fichiers de matériel, sans dépendre de la bibliothèque de matériel ou du scan de dossier :

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": "Regardez ma nouvelle vidéo ! #tendance #recommandé",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Publication avec Bibliothèque de Matériel (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": "Regardez ma nouvelle vidéo ! #tendance #recommandé",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "tendance, danse",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Créer une Tâche de Publication par Liste de Noms d'Utilisateur

Ce mode vous permet de créer directement des tâches pour des comptes spécifiques, sans connaître leurs numéros de série d'appareil :

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": "Regardez ma nouvelle vidéo ! #tendance #recommandé",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Publication avec Dossier Local (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": "Contenu incroyable ! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Publication dans le fil Instagram (placement: post)

Publiez dans le fil Instagram classique (pas un Reel). Les options audio ne sont pas prises en charge pour cet emplacement :

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": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

Publication avec Audio Personnalisé

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": "Dansez sur cette musique tendance !",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "musique danse tendance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Publication avec URL Audio Spécifique

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": "Utilisez cette super musique !",
      "material_source": "materialLibrary"
    }
  }'

Publication d'Images (Carrousel)

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": "Regardez ces photos ! #galerie",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Publication avec Sélection Explicite de Plateforme

Vous pouvez spécifier explicitement la plateforme cible en utilisant le paramètre platform. Cela est utile lorsque vous souhaitez remplacer la valeur par défaut de l'environnement :

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": "Publication sur Instagram ! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Réponse

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

Documentation Associée

API de Gestion des Tâches - Créer, lister et gérer les tâches

Vue d'ensemble​

Paramètres de Requête​

Configuration du Script (script_config)​

Paramètres Communs (TikTok et Instagram)​

Méthodes de publication (post_way)​

Paramètres Spécifiques à TikTok​

Paramètres Spécifiques à Instagram​

Exemples​

Publication en Story TikTok​

Tâche de Publication Basique - Passage Direct de Chemins de Matériel​

Publication avec Bibliothèque de Matériel (TikTok)​

Créer une Tâche de Publication par Liste de Noms d'Utilisateur​

Publication avec Dossier Local (Instagram)​

Publication dans le fil Instagram (placement: post)​

Publication avec Audio Personnalisé​

Publication avec URL Audio Spécifique​

Publication d'Images (Carrousel)​

Publication avec Sélection Explicite de Plateforme​

Réponse​

Documentation Associée​