Конфигурация скрипта продвижения комментариев (ответы)

На этой странице описаны параметры конфигурации скрипта boost_comment, используемого при создании задач.

Какой скрипт вам нужен?

Существуют два разных скрипта комментариев, и они выполняют разные действия:

comment — публикует новый комментарий верхнего уровня к посту. См. Конфигурация скрипта комментариев.
boost_comment (эта страница) — ставит лайк и/или отвечает на существующий комментарий. Это и есть функция "REPLY COMMENT" (ответ на комментарии) / «Boost Comments».

Если вы хотите отвечать на комментарии, вы попали по адресу.

Обзор

Скрипт boost_comment открывает пост и взаимодействует с его верхним комментарием — он может поставить лайк комментарию, ответить на него или сделать и то, и другое. Это API-эквивалент диалога Boost Comments в приложении.

В отличие от скрипта comment, скрипт boost_comment обрабатывает все целевые URL в рамках одного запуска задачи (он внутренне разбивает target_comment_urls по переносам строк и обрабатывает их один за другим). Создаётся одна задача на устройство (режим серийного номера) или на аккаунт (режим имени пользователя / мультиаккаунта) — а не одна задача на URL.

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

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
target_comment_urls	string	Да	""	URL поста(ов), с верхним комментарием которого нужно взаимодействовать. Несколько URL разделяются переносами строк (`\n`).
enable_like_comment	boolean	Да*	false	Поставить лайк верхнему комментарию каждого поста.
enable_reply_comment	boolean	Да*	false	Ответить на верхний комментарий каждого поста.
reply_contents	string	Обязателен, если `enable_reply_comment` равно `true`	""	Текст ответа. Несколько вариантов ответа разделяются переносами строк (`\n`); один выбирается на задачу в соответствии с `reply_order`.
reply_order	string	Нет	"random"	Как выбирать ответ из `reply_contents`: `random` (случайно) или `sequential` (последовательно).
insert_emoji	boolean	Нет	false	Вставить случайный эмодзи в ответ.
username	string	Нет	""	Переключиться на этот аккаунт перед запуском. Если не указано, используется аккаунт, активный на устройстве в данный момент.

Требуется хотя бы одно действие

Необходимо включить хотя бы одно действие: установите enable_like_comment и/или enable_reply_comment в true. Если enable_reply_comment равно true, поле reply_contents не может быть пустым. В противном случае API отклонит запрос с ошибкой 40001.

С каким комментарием происходит взаимодействие?

Скрипт взаимодействует с верхним (первым) комментарием каждого поста. Укажите URL поста в target_comment_urls — прямая ссылка на отдельный комментарий не нужна.

Примеры

Ответ на комментарий (самый распространённый случай)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_reply_comment": true,
      "reply_contents": "Great point!\nI totally agree!\nThanks for sharing 🙌"
    }
  }'

Ответ выбирается из трёх строк в reply_contents (по умолчанию случайно).

Лайк и ответ одновременно

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_like_comment": true,
      "enable_reply_comment": true,
      "reply_contents": "Couldn'\''t agree more!\nWell said!",
      "reply_order": "sequential",
      "insert_emoji": true
    }
  }'

Взаимодействие с комментариями нескольких постов в одной задаче

Разделяйте URL переносами строк. Все они обрабатываются в рамках одной задачи:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@user1/video/111\nhttps://www.tiktok.com/@user2/video/222\nhttps://www.tiktok.com/@user3/video/333",
      "enable_reply_comment": true,
      "reply_contents": "Love this!\nAmazing!\nSo true!",
      "reply_order": "random"
    }
  }'

Только лайк (без ответа)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_like_comment": true
    }
  }'

Запуск с определённым аккаунтом (режим имени пользователя)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@target/video/123",
      "enable_reply_comment": true,
      "reply_contents": "Nice!\nGreat content!"
    }
  }'

Создаётся одна задача на аккаунт, каждая сначала переключается на этот аккаунт.

Пример для Instagram

Тот же API работает и для постов Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.instagram.com/p/ABC123/",
      "enable_reply_comment": true,
      "reply_contents": "Beautiful! 😍\nLove it!"
    }
  }'

Ответ

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301],
    "created_count": 1
  }
}

Порядок ответов

Случайный порядок (`random`)

Для задачи случайно выбирается один ответ из reply_contents.
Хорошо подходит, чтобы ответы выглядели более естественно.
Поведение по умолчанию.

Последовательный порядок (`sequential`)

Ответ выбирается по индексу задачи (job_count): первая задача использует первую строку, вторая — вторую и так далее, с возвратом к началу по достижении конца.
Хорошо подходит для распределения разных ответов по нескольким устройствам/аккаунтам.

Форматы URL постов

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

`comment` против `boost_comment`

	`comment`	`boost_comment`
Что делает	Публикует новый комментарий верхнего уровня	Ставит лайк / отвечает на существующий комментарий
Основной ввод	`target_post_url(s)` + `comment_content`	`target_comment_urls` + `reply_contents`
Разбиение задач	Одна задача на URL	Одна задача на устройство/аккаунт (все URL за один запуск)
Документация	Скрипт комментариев	Эта страница

Коды ошибок

Код	Описание
40001	Отсутствует `target_comment_urls`, не включено ни одно действие, или `enable_reply_comment` равно true при пустом `reply_contents`
40003	Скрипт не поддерживается через API
40301	Для доступа к API требуется план Pro+

См. также

Конфигурация скрипта комментариев - Публикация нового комментария к посту
Конфигурация скрипта лайков - Лайки постов
API управления задачами - Создание, просмотр и управление задачами
Обзор локального API - Обзор API и быстрый старт

Обзор​

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

Параметры​

Примеры​

Ответ на комментарий (самый распространённый случай)​

Лайк и ответ одновременно​

Взаимодействие с комментариями нескольких постов в одной задаче​

Только лайк (без ответа)​

Запуск с определённым аккаунтом (режим имени пользователя)​

Пример для Instagram​

Ответ​

Порядок ответов​

Случайный порядок (random)​

Последовательный порядок (sequential)​

Форматы URL постов​

TikTok​

Instagram​

comment против boost_comment​

Рекомендации​

Коды ошибок​

См. также​