Configuración del Script Post

Esta página documenta los parámetros de configuración para el script post usado en la creación de tareas.

Visión General

El script post se utiliza para publicar automáticamente contenido (videos o imágenes) en TikTok o Instagram. Soporta múltiples métodos de publicación, fuentes de material y opciones de audio.

Parámetros de Solicitud

Al crear una tarea, puede especificar los siguientes parámetros de nivel superior:

Parámetro	Tipo	Requerido	Por Defecto	Descripción
serials	string[]	Condicional	[]	Lista de números de serie de dispositivos (Modo 1: basado en dispositivo)
usernames	string[]	Condicional	[]	Lista de nombres de usuario para crear tareas (Modo 2: basado en nombre de usuario)
script_name	string	Sí	-	Nombre del script a ejecutar (por ejemplo, "post")
script_config	object	Sí	-	Parámetros de configuración del script (ver abajo)
enable_multi_account	boolean	No	false	Habilitar modo multi-cuenta (crear tarea para cada cuenta en el dispositivo)
start_time	string	No	-	Hora de inicio opcional en formato "HH:MM"
platform	string	Condicional*	auto	Plataforma destino: `tiktok`, `instagram`. Ver nota abajo

Nota: Se debe proporcionar serials o usernames.

*Comportamiento del Parámetro Platform:

TikMatrix e IgMatrix: El parámetro platform es ignorado si se proporciona. La plataforma se determina automáticamente por el nombre de la aplicación (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: El parámetro platform es requerido y debe especificarse explícitamente como tiktok o instagram.

Configuración del Script (`script_config`)

El objeto script_config contiene los parámetros para el script de publicación. Los siguientes son los parámetros disponibles:

Parámetros Generales (TikTok e Instagram)

Parámetro	Tipo	Requerido	Por Defecto	Descripción
content_type	integer	No	0	Tipo de contenido: `0` = video, `1` = imagen
image_count	integer	No	1	Cantidad de imágenes a seleccionar (cuando content_type = 1)
captions	string	No	""	Texto del título de la publicación. Soporta formato spintax: `{opción1\|opción2\|opción3}`
post_way	string	No	"share"	Método de publicación: `share`, `addButton` o `useSound`
material_source	string	No	"materialLibrary"	Fuente de material: `materialLibrary` (biblioteca de materiales) o `localFolder` (carpeta local), ignorado si se proporciona material_list
material_path	string	Condicional	""	Ruta de carpeta local (requerido cuando material_source = "localFolder")
material_list	string[]	No	[]	Array de rutas de archivos de material directamente. Cuando se proporciona este parámetro, se omite la lógica de material_source y material_path. Recomendado para escenarios de automatización API.
materials_tags	string	No	""	Etiquetas de material separadas por comas para filtrar de la biblioteca de materiales
upload_wait_time	integer	No	30	Segundos a esperar para completar la carga
sound_wait_time	integer	No	10	Segundos a esperar para cargar el audio
add_sound	string/integer	No	"-1"	Opción de audio: `-1` = predeterminado, `0` = deshabilitado, `1` = habilitado, `custom` = usar audio personalizado
sound_name	string	Condicional	""	Nombre/URL del audio (requerido cuando post_way = "useSound")
custom_sound_keyword	string	Condicional	""	Palabra clave para buscar audio personalizado (requerido cuando add_sound = "custom")
origin_sound_volume	integer	No	50	Volumen del audio original (0-100)
add_sound_volume	integer	No	50	Volumen del audio añadido (0-100)

Parámetros Exclusivos de TikTok

Parámetro	Tipo	Requerido	Por Defecto	Descripción
add_product_link	integer	No	0	Añadir enlace de producto: `0` = no, `1` = sí

Parámetros Exclusivos de Instagram

Parámetro	Tipo	Requerido	Por Defecto	Descripción
placement	string	No	"reel"	Ubicación de publicación: `reel` (Reel) o `story` (Historia)

Ejemplos

Tarea Básica de Publicación - Pasando Rutas de Material Directamente

Esta es la manera recomendada para automatización API - pasar rutas de archivos de material directamente, sin depender de la biblioteca de materiales o escaneo de carpetas:

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": "¡Mira mi nuevo video! #viral #trending",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Publicar Usando Biblioteca de Materiales (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": "¡Mira mi nuevo video! #viral #trending",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "viral, baile",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Crear Tarea de Publicación por Lista de Nombres de Usuario

Este modo te permite crear tareas directamente para cuentas específicas sin necesidad de conocer sus números de serie de 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": "¡Mira mi nuevo video! #viral #trending",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Publicar Usando Carpeta 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": "¡Contenido increíble! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Publicar con Audio Personalizado

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": "¡Bailando con esta canción viral!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "música viral 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Publicar con URL de Audio Especificada

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 esta música increíble!",
      "material_source": "materialLibrary"
    }
  }'

Publicar Imágenes (Carrusel)

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": "¡Mira estas fotos! #galería",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Publicar con Selección Explícita de Plataforma

Puede especificar explícitamente la plataforma destino usando el parámetro platform. Esto es útil cuando desea anular el valor predeterminado del entorno:

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

Respuesta

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

Documentación Relacionada

API de Gestión de Tareas - Crear, listar y gestionar tareas

Visión General​

Parámetros de Solicitud​

Configuración del Script (script_config)​

Parámetros Generales (TikTok e Instagram)​

Parámetros Exclusivos de TikTok​

Parámetros Exclusivos de Instagram​

Ejemplos​

Tarea Básica de Publicación - Pasando Rutas de Material Directamente​

Publicar Usando Biblioteca de Materiales (TikTok)​

Crear Tarea de Publicación por Lista de Nombres de Usuario​

Publicar Usando Carpeta Local (Instagram)​

Publicar con Audio Personalizado​

Publicar con URL de Audio Especificada​

Publicar Imágenes (Carrusel)​

Publicar con Selección Explícita de Plataforma​

Respuesta​

Documentación Relacionada​