Saltar al contenido principal

Configuración del Script Message

message no se puede crear

La creación de tareas rechaza message: el binario de scripts no tiene manejador para él en ninguna de las dos plataformas, así que toda tarea de este tipo fallaba en el dispositivo con "Unknown script". Los parámetros siguientes se conservan solo como referencia. Para enviar mensajes directos hoy, usa Super Marketing.

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.

información

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​