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}`
caption_format	string	No	"multiline"	Cómo manejar los pies de foto de varias líneas: `multiline` (insertar saltos de línea reales) o `singleline` (reemplazar `\n` con espacios)
ai_label	boolean	No	false	Si se debe agregar la etiqueta de contenido generado por IA a la publicación
save_draft	boolean	No	false	Guardar la publicación como borrador en lugar de publicar inmediatamente
post_way	string	No	"addButton"	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	10	Segundos a esperar para completar la carga

upload_wait_time se aplica tanto a la publicación normal como al modo save_draft. Incluso al guardar como borrador, TikTok/Instagram todavía necesita tiempo para terminar de subir el video en segundo plano. | 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 | 100 | Volumen del audio original (0-100) | | add_sound_volume | integer | No | 100 | Volumen del audio añadido (0-100) |

Parámetros Específicos de TikTok

Parámetro	Tipo	Requerido	Por Defecto	Descripción
add_product_link	integer	No	0	Si se debe agregar un enlace de producto/compras: `0` = no, `1` = sí

Parámetros Específicos de Instagram

Parámetro	Tipo	Requerido	Por Defecto	Descripción
placement	string	No	"reel"	Ubicación de publicación: `reel` (Reel) o `story` (Historia)
enable_schedule_reels	boolean	No	false	Si se debe programar el Reel para un momento futuro
schedule_reels_time	string	Condicional	""	Hora de publicación programada en el formato `YYYY-MM-DD HH:MM` (requerido cuando enable_schedule_reels = true)
story_link	string	No	""	URL para adjuntar como enlace de sticker en una Story (solo aplica cuando placement = "story")

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 Específicos de TikTok​

Parámetros Específicos 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​