Перейти к основному содержимому

Конфигурация скрипта сообщений

На этой странице описаны параметры скрипта 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​

Тот же 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Скрипт не поддерживается через API
40301Требуется план Pro+

См. также​