メッセージスクリプト設定

このページでは message スクリプトの設定パラメータについて説明します。

概要

message スクリプトはTikTokまたはInstagramのユーザーに自動でダイレクトメッセージを送信します。APIで複数のターゲットユーザーを指定すると 各ユーザーに1タスク が作成されます。start_time でタイミングを制御できます。

スクリプト設定 (script_config)

メッセージスクリプトの設定パラメータ:

パラメータ

パラメータ	型	必須	デフォルト	説明
target_users	string[]	Yes*	[]	メッセージを送るターゲットユーザーの配列（ユーザー毎に1タスク）
target_user	string	Yes*	""	単一ユーザー名、または改行/カンマ区切りの複数ユーザー
message_content	string	Yes	""	送信するメッセージのテキスト内容
access_method	string	No	"direct"	ナビゲーション方法: direct または search

注記

target_users 配列または target_user 文字列が必要です。両方の場合は target_users 優先。

備考

複数ユーザー指定時、APIは 各ユーザーに1タスク を作成します。3ユーザー × 2デバイス = 6タスク。

例

1ユーザーへのメッセージ送信

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

複数ユーザーへのメッセージ送信

ユーザー毎に1タスク作成:

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例

InstagramにもAPI対応:

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 でメッセージを時間分散させる。

2. パーソナライズ: 自然に見えるようメッセージをカスタマイズする。

3. 直接アクセス優先: より速く信頼性が高い。

4. プラットフォーム制限: 一度に多くのメッセージタスクを作成しない。

エラーコード

Code	Description
40001	ターゲットユーザーまたはメッセージ内容が未指定
40003	APIからこのスクリプトはサポート外
40301	APIアクセスにはPro+プランが必要

関連ページ

• タスク管理 API
• フォロースクリプト設定
• コメントスクリプト設定
• ローカル API 概要