Saltar al contenido principal

Configuración del Script Message

Esta página documenta los parámetros del script message para creación de tareas.

Descripción General​

El script message envía mensajes directos automáticamente a usuarios en TikTok o Instagram. Con múltiples usuarios objetivo via API, se crea una tarea por usuario. Controla el timing con start_time.

Configuración del Script (script_config)​

Parámetros de configuración del script message:

Parámetros​

ParámetroTipoRequeridoPredeterminadoDescripción
target_usersstring[]Yes*[]Array de usuarios objetivo para mensajear (una tarea por usuario)
target_userstringYes*""Nombre de usuario único o múltiples separados por saltos/comas
message_contentstringYes""Contenido del mensaje de texto
access_methodstringNo"direct"Método de acceso: direct o search
nota

target_users o target_user debe proporcionarse. target_users tiene prioridad.

info

Con múltiples usuarios objetivo, la API crea una tarea por usuario. 3 usuarios + 2 dispositivos = 6 tareas.

Ejemplos​

Enviar mensaje a un usuario​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@username_to_message"],
      "message_content": "Hello! Check out our latest content.",
      "access_method": "direct"
    }
  }'

Enviar mensajes a múltiples usuarios​

Una tarea por usuario:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "message_content": "Hi! We have an exclusive offer for you."
    }
  }'

Crea 3 tareas separadas ejecutadas inmediatamente.

Programar mensajes con tiempo de inicio​

Use start_time para programar:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "message_content": "Scheduled greeting!"
    },
    "start_time": "14:30"
  }'

Enviar mensaje vía método búsqueda​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["username1", "username2"],
      "message_content": "Hello from TikMatrix!",
      "access_method": "search"
    }
  }'

Enviar mensajes por lista de nombres​

Crear tareas de mensajes para cuentas específicas:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@target_user"],
      "message_content": "Hi there!"
    }
  }'

Mensajes en lote en múltiples dispositivos​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@influencer_account"],
      "message_content": "Love your content! Let's collaborate."
    },
    "enable_multi_account": true
  }'

Ejemplo de Instagram​

La misma API para Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_user": "instagram_username",
      "message_content": "Hey! Loved your post"
    }
  }'

Respuesta​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

Métodos de Acceso​

Método directo (direct)​

Abre perfil de usuario via URL. Más rápido y confiable.

Navega a búsqueda y escribe el nombre. Más lento pero funciona cuando el acceso directo está bloqueado.

Mejores Prácticas​

  1. Programar tareas: Use start_time.

  2. Personalizar mensajes: Adapte el contenido para parecer personal.

  3. Preferir acceso directo: Más rápido y confiable.

  4. Respetar límites: No crear demasiadas tareas de mensajes a la vez.

Códigos de Error​

CodeDescription
40001Usuarios objetivo o contenido del mensaje faltante
40003Script no compatible con la API
40301El acceso a la API requiere plan Pro+

Ver También​