본문으로 건너뛰기

메시지 스크립트 구성

이 페이지에서는 message 스크립트의 구성 매개변수를 문서화합니다.

개요​

message 스크립트는 TikTok 또는 Instagram의 사용자에게 자동으로 다이렉트 메시지를 보냅니다. API를 통해 여러 대상 사용자를 제공하면 각 사용자에 하나의 작업이 생성됩니다. start_time으로 타이밍을 제어할 수 있습니다.

스크립트 구성 (script_config)​

메시지 스크립트 구성 매개변수:

매개변수​

매개변수유형필수기본값설명
target_usersstring[]Yes*[]메시지를 보낼 대상 사용자 배열(사용자당 한 작업)
target_userstringYes*""단일 사용자 이름 또는 줄바꿈/쉼표로 구분된 여러 사용자
message_contentstringYes""보낼 메시지 텍스트 내용
access_methodstringNo"direct"접근 방법: direct 또는 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 예제​

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을 통해 사용자 프로필을 엽니다. 더 빠르고 신뢰할 수 있습니다.

검색에서 사용자 이름을 입력합니다. 느리지만 직접 URL이 차단될 때 작동합니다.

모범 사례​

  1. 작업 예약: start_time 사용.

  2. 메시지 개인화: 자연스럽게 보이도록 내용 맞춤 설정.

  3. 직접 접근 선호: 더 빠르고 신뢰할 수 있음.

  4. 플랫폼 한도 존중: 한 번에 너무 많은 메시지 작업 생성 금지.

오류 코드​

CodeDescription
40001대상 사용자 또는 메시지 내용 없음
40003API를 통해 지원되지 않는 스크립트
40301API 액세스에는 Pro+ 플랜 필요

참고 항목​