私信脚本配置

message 无法创建

创建任务会拒绝 message：脚本二进制在两个平台上都没有对应的处理分支，这类任务过去都会在设备上以 "Unknown script" 失败。下面的参数仅作参考保留。如需群发私信，请使用超级营销。

本页面介绍创建任务时 message 脚本的配置参数。

概述

message 脚本用于在 TikTok 或 Instagram 上自动向用户发送私信。通过 API 提供多个目标用户时，系统会为每个用户创建一个任务。使用 start_time 参数来控制任务的执行时间。

脚本配置 (script_config)

私信脚本的配置参数如下：

参数

参数	类型	必需	默认值	描述
target_users	string[]	Yes*	[]	要私信的目标用户数组（每个用户一个任务）
target_user	string	Yes*	""	单个目标用户名，或多个用户名以换行/逗号分隔
message_content	string	Yes	""	要发送的文本消息内容
access_method	string	No	"direct"	导航到用户资料的方式：direct（通过 URL）或 search

备注

必须提供 target_users 数组或 target_user 字符串。如果两者都提供，target_users 优先。

信息

当提供多个目标用户时，API 会为每个用户创建一个任务。例如，3 个用户 + 2 个设备 = 6 个任务。

示例

向单个用户发送私信

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"
    }
  }'

向多个用户发送私信

每个用户创建一个任务：

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."
    }
  }'

这将创建 3 个独立的任务，立即执行。

使用开始时间调度私信

使用 start_time 来调度任务的开始时间：

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"
  }'

通过搜索方式发送私信

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"
    }
  }'

通过用户名列表发送私信

直接为特定账号创建私信任务：

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!"
    }
  }'

多设备批量私信

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
  }'

Instagram 示例

相同的 API 也适用于 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"
    }
  }'

响应

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

访问方式

直接访问 (direct)

通过 URL 打开用户资料。更快更可靠，大多数情况下推荐使用。

搜索访问 (search)

导航到搜索，输入用户名，点击结果。较慢但在直接 URL 访问被阻止时有效。

最佳实践

1. 调度任务：使用 start_time 参数来调度任务的执行时间（格式："HH:MM"）。

2. 个性化消息：自定义 message_content 使消息看起来自然。

3. 优先直接访问：direct 访问方式比 search 更快更可靠。

4. 尊重平台限制：不要一次创建太多私信任务，大多数平台对私信有频率限制。

错误代码

Code	Description
40001	目标用户或消息内容缺失
40003	API 不支持该脚本
40301	API 访问需要 Pro+ 套餐

另请参阅

• 任务管理 API - 创建、查询和管理任务
• 关注脚本配置 - 配置关注脚本参数
• 评论脚本配置 - 配置评论脚本参数
• 本地 API 概述 - API 概述和快速入门