Перейти до основного вмісту

Конфігурація скрипту повідомлень

На цій сторінці описано параметри скрипту message для створення завдань.

Огляд​

Скрипт message автоматично надсилає особисті повідомлення користувачам у TikTok або Instagram. При кількох цільових користувачах для кожного створюється завдання. Керуйте часом через 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​

Той самий 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. Швидше і надійніше.

Переходить до пошуку і вводить ім'я. Повільніше, але працює при блокуванні прямого URL.

Найкращі практики​

  1. Плануйте: Використовуйте start_time.

  2. Персоналізуйте: Адаптуйте зміст.

  3. Надавайте перевагу прямому доступу: Швидше і надійніше.

  4. Поважайте ліміти: Не створюйте забагато завдань одночасно.

Коди помилок​

CodeDescription
40001Відсутні цільові користувачі або вміст повідомлення
40003Скрипт не підтримується
40301Потрібен план Pro+

Дивіться також​