Configuración del Script Profile
Esta página documenta los parámetros de configuración del script profile utilizado en la creación de tareas.
Visión General
El script profile actualiza automáticamente el perfil de una cuenta de TikTok, Instagram o Threads. Puede actualizar el avatar, nombre de usuario, nombre de usuario de cuenta, biografía y URL de enlace. Threads admite actualizaciones de avatar, nombre, biografía y enlace. Su nombre de usuario es propiedad de la cuenta de Instagram vinculada, por lo que username_to / usernames se registran y se omiten en Threads en lugar de cambiar inesperadamente el nombre de usuario compartido.
Configuración del Script (script_config)
El objeto script_config contiene los parámetros del script de perfil. A continuación se encuentran los parámetros disponibles:
Parámetros
| Parámetro | Tipo | Requerido | Por Defecto | Descripción |
|---|---|---|---|---|
| username | string | No | "" | El nombre de usuario de la cuenta cuyo perfil actualizar. Se utiliza en modo basado en dispositivo. |
| avatars_path | string | No | "" | Ruta a una carpeta que contiene imágenes de avatar. Dejar vacío para omitir la actualización de avatar. |
| nickname | string | No | "" | Un solo apodo a establecer. Tiene prioridad sobre nicknames. |
| nicknames | string | No | "" | Múltiples apodos separados por saltos de línea. Uno se selecciona según profile_order. |
| username_to | string | No | "" | Nuevo nombre de usuario a establecer. Tiene prioridad sobre usernames. |
| usernames | string | No | "" | Múltiples nombres de usuario nuevos separados por saltos de línea. Uno se selecciona según profile_order. |
| bio | string | No | "" | Un solo texto de biografía a establecer. Tiene prioridad sobre bios. |
| bios | string | No | "" | Múltiples textos de biografía separados por saltos de línea. Uno se selecciona según profile_order. |
| link_url | string | No | "" | Una sola URL de enlace a establecer. Tiene prioridad sobre link_urls. |
| link_urls | string | No | "" | Múltiples URLs de enlaces separadas por saltos de línea. Uno se selecciona según profile_order. |
| profile_order | string | No | "random" | Cómo seleccionar contenido cuando se utilizan campos de varios valores: random o sequential. |
| job_count | integer | No | 0 | Contador de trabajo utilizado para la selección secuencial. Lo establece automáticamente el sistema. |
Se debe proporcionar al menos uno de los campos de perfil (avatar, nickname, username_to, bio, link_url). De lo contrario, el script se ejecutará pero no realizará cambios.
Ejemplos
Actualizar Apodo
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "profile",
"script_config": {
"username": "@my_account",
"nickname": "Mi Nuevo Apodo"
}
}'
Actualizar Biografía y Enlace
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "profile",
"script_config": {
"username": "@my_account",
"bio": "¡Mira mi contenido más reciente!",
"link_url": "https://example.com"
}
}'
Actualizar Avatar
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "profile",
"script_config": {
"username": "@my_account",
"avatars_path": "C:/avatars/"
}
}'
Actualizar Múltiples Cuentas con Apodos Diferentes
Use nicknames con profile_order: sequential para asignar diferentes apodos entre cuentas:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1", "device_serial_2", "device_serial_3"],
"script_name": "profile",
"script_config": {
"nicknames": "Apodo Uno\nApodo Dos\nApodo Tres",
"profile_order": "sequential",
"bio": "¡Sígueme para contenido increíble!"
}
}'
Actualizar Perfil por Modo de Nombre de Usuario
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"usernames": ["@account1", "@account2"],
"script_name": "profile",
"script_config": {
"nickname": "Nuevo Nombre de Marca",
"bio": "Biografía actualizada para todas las cuentas",
"link_url": "https://mybrand.com"
}
}'
Programar Actualización de Perfil
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "profile",
"script_config": {
"username": "@my_account",
"nickname": "Apodo Actualizado",
"bio": "¡Contenido fresco cada día!"
},
"start_time": "10:00"
}'
Respuesta
{
"code": 0,
"message": "success",
"data": {
"task_ids": [401, 402],
"created_count": 2
}
}
Orden de Perfil
Orden Aleatorio (random)
- Selecciona aleatoriamente un valor de campos de varios valores (apodos, biografías, etc.)
- Comportamiento predeterminado
Orden Secuencial (sequential)
- Selecciona valores en orden según
job_count - La primera tarea usa el primer valor, la segunda tarea usa el segundo valor, etc.
- Cicla hacia el principio al llegar al final
- Bueno para asignar valores diferentes a cuentas diferentes
Códigos de Error
| Código | Descripción |
|---|---|
| 40001 | Faltan parámetros requeridos |
| 40003 | Script no compatible a través de la API |
| 40301 | El acceso a la API requiere plan Pro+ |
Véase También
- API de Gestión de Tareas - Crear, listar y gestionar tareas
- Configuración del Script Login - Iniciar sesión en cuenta
- Configuración del Script Match Account - Vincular cuentas en dispositivo
- Visión General de la API Local - Descripción general de la API e inicio rápido