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

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

Огляд

Скрипт message автоматично надсилає особисті повідомлення користувачам у TikTok або Instagram. При кількох цільових користувачах для кожного створюється завдання. Керуйте часом через start_time.

Конфігурація скрипту (script_config)

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

Параметри

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
target_users	string[]	Yes*	[]	Масив цільових користувачів (одне завдання на користувача)
target_user	string	Yes*	""	Один або кілька імен, розділених переносами/комами
message_content	string	Yes	""	Текстовий вміст повідомлення
access_method	string	No	"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. Швидше і надійніше.

Метод пошуку (search)

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

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

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

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

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

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

Коди помилок

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

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

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