Выиграй 1 ТБ резидентского трафика, iPhone 18 Pro Max + ещё 33 приза$50 на баланс = 1 билетПрисоединиться
Бизнес

Автоматизация облачных телефонов: Синхронное управление, ADB и работа по REST API

Когда в работе десятки облачных смартфонов, прокликивать каждый профиль вручную становится слишком долго - особенно в рекламных агентствах, командах тестирования (QA) и проектах в сфере интернет-торговли (e-commerce). В облачных телефонах CyberYozh App рутинные действия можно автоматизировать сразу на нескольких уровнях. В зависимости от задачи вы можете клонировать и группировать профили в личном кабинете, дублировать нажатия на несколько экранов одновременно, запускать фоновые кликеры и макросы внутри самого Android, подключать внешние скрипты по протоколу ADB (Android Debug Bridge) или управлять устройствами через Cloud Phones REST API.

В третьей части руководства мы пошагово разберём каждый из этих способов, покажем, как работают фоновые приложения при закрытой вкладке браузера, и приведём готовые команды ADB и запросы к API.

TL;DR: 4 способа автоматизировать облачные телефоны

Если у вас уже куплены слоты и созданы первые профили, выберите удобный способ управления под свою задачу:

  1. Группировка и клонирование в личном кабинете: раскладывайте смартфоны по папкам на вкладке Группы в разделе Мои телефоны, фильтруйте список по статусам (Включён, Запускается, Выключен, Не создан) и используйте меню с тремя точками на карточке профиля, чтобы скопировать настроенный смартфон (Клонировать) или сменить параметры железа на выключенном аппарате (Заменить fingerprint -> окно Новая машина).

  2. Синхронизация экранов и фоновые приложения: запускайте внутри Android программы для автоматизации (Tasker, MacroDroid, AutoX.js) - они продолжают работать в фоне даже после закрытия вкладки браузера. А чтобы одновременно повторять нажатия, свайпы и ввод текста сразу на нескольких телефонах, используйте многооконную синхронизацию (Синхронизатор или параллельное управление через ADB).

  3. Подключение внешних скриптов по ADB и Root-доступ: на запущенном смартфоне откройте меню карточки с тремя точками и нажмите Включить ROOT (если вашей программе нужны права суперпользователя) либо выберите пункт ADB, включите переключатель ADB включён и нажмите Получить данные подключения. После этого вы сможете напрямую подключать к телефону шаблоны Browser Automation Studio (BAS), Appium или свои скрипты на Python командой adb connect ip:port.

  4. Управление профилями через REST API: выпустите токен по кнопке Сгенерировать API-ключ в разделе Ключи API и передавайте его в заголовке X-Api-Key к адресу https://app.cyberyozh.com/api/v2/cloud-phones/profiles/, чтобы программно получать список телефонов, создавать профили в свободных слотах, запускать устройства и включать на них ADB или Root.

Шаг 1. Группировка профилей, клонирование и смена параметров железа

Перед запуском скриптов удобно навести порядок в разделе ОБЛАЧНЫЕ ТЕЛЕФОНЫ -> Мои телефоны, чтобы не путаться в десятках карточек и быстро копировать готовые настройки. После того как вы создали базовые профили (см. инструкцию по покупке слотов и первой настройке облачного телефона) и подключили к ним прокси (см. руководство по привязке прокси и геолокации), используйте возможности личного кабинета:

  • Папки проектов и быстрый поиск: переключитесь с вкладки Профили на соседнюю вкладку Группы, чтобы разделить телефоны по клиентам, странам или этапам тестирования. Нужные аппараты легко находить через поле Поиск по имени, фильтр Все группы и список Все статусы (Включён, Запускается, Выключен или Не создан).

  • Изменение названия и заметок: нажмите на меню с тремя точками в правом верхнем углу карточки телефона и выберите Редактировать, чтобы поменять имя профиля, перенести его в другую группу или обновить текстовую заметку без сброса настроек самого смартфона.

  • Клонирование готовых телефонов: нажмите Клонировать в меню карточки с тремя точками, чтобы в один клик скопировать настроенный профиль в свободный оплаченный слот (при массовом создании профилей это действие также можно автоматизировать запросом POST /api/v2/cloud-phones/profiles/ по API). Обратите внимание, что управление субпрофилями и генератор доступов (кредов) находятся в настройках ваших ротационных резидентских прокси - созданных там субпользователей можно выбрать в списке Пользователь внутри окна Сменить прокси/геолокацию и привязать к каждому склонированному смартфону свой отдельный прокси.

Рабочая область Мои телефоны в CyberYozh App с фильтрами групп и статусов, а также открытым меню карточки профиля с пунктами Редактировать, Сменить прокси/геолокацию, Клонировать, Включить ROOT, ADB, Заменить fingerprint и Удалить
Верхняя панель раздела «Мои телефоны» позволяет фильтровать устройства по группам и статусам, а меню с тремя точками на карточке открывает быстрый доступ к клонированию, включению Root, настройке ADB и замене фингерпринта.
  • Смена аппаратного отпечатка (fingerprint) на выключенном телефоне: если вам нужно получить новое устройство с другими серийными номерами и параметрами железа внутри уже оплаченного слота, сначала остановите телефон кнопкой Стоп и выберите в меню карточки пункт Заменить fingerprint. Откроется окно Новая машина (с пометкой Рандомизирует фингерпринт профиля. Профиль должен быть остановлен.). Отметьте галочками параметры, которые хотите оставить прежними (Сохранить бренд и модель, Сохранить номер телефона, Сохранить регион, Сохранить язык), и нажмите Применить.

Окно Новая машина в CyberYozh App с чекбоксами Сохранить бренд и модель, Сохранить номер телефона, Сохранить регион и Сохранить язык при рандомизации фингерпринта остановленного профиля
При нажатии «Заменить fingerprint» на выключенном профиле открывается окно «Новая машина», где можно сгенерировать новые параметры железа с сохранением выбранного бренда, модели, номера, региона или языка.

Шаг 2. Синхронное управление несколькими экранами и работа приложений в фоне

Однотипные действия внутри самого Android удобно автоматизировать двумя способами: дублировать свои клики сразу на несколько открытых телефонов либо запускать внутри смартфонов программы-макросы, которые работают самостоятельно в фоновом режиме.

2.1. Дублирование действий на группу устройств (Синхронизатор)

Синхронизатор (Synchronizer) позволяет управлять сразу несколькими облачными телефонами из одного окна. Вместо того чтобы по очереди открывать каждый смартфон, устанавливать приложения и вводить один и тот же текст, вы выполняете действия на одном главном экране, а система в реальном времени повторяет каждое нажатие, свайп, прокрутку ленты и ввод с клавиатуры на остальных выбранных устройствах.

При работе с группой запущенных телефонов в разделе Мои телефоны (статус Включён) синхронизация устроена по простому принципу:

  • Основное (ведущее) устройство: один активный облачный смартфон служит главным экраном, в окне которого вы кликаете мышкой, листаете страницы и печатаете текст.

  • Ведомые устройства: остальные запущенные телефоны из выбранной группы одновременно получают и в точности повторяют все действия с главного экрана.

  • Как настроить синхронное управление уже сейчас: встроенная кнопка запуска Синхронизатора прямо в браузере скоро появится в панели управления CyberYozh App, а уже сегодня синхронную работу группы телефонов можно запустить через подключение по ADB к многопоточным программам (подробно описано в Шаге 3) или с помощью внутренних Android-приложений для автоматизации.

2.2. Как работают фоновые приложения при закрытой вкладке браузера и как считаются минуты

Многие спрашивают, продолжит ли работать запущенный внутри телефона скрипт или кликер, если закрыть вкладку браузера на компьютере, и как при этом списываются минуты. Поскольку облачные смартфоны на базе Android работают на реальных серверах ARM в дата-центре, сама операционная система работает независимо от вашего браузера:

  • Что происходит при закрытии вкладки браузера: если ваш облачный телефон запущен (горит статус Включён и обведена зелёная рамка вокруг карточки), вы включили внутри него приложение вроде Tasker, MacroDroid или AutoX.js и закрыли вкладку с экраном в браузере, сам смартфон не выключается - все приложения внутри него продолжают работать в фоновом режиме. Закрытие вкладки в браузере просто выключает трансляцию картинки на ваш монитор, пока сервер ARM в дата-центре продолжает выполнять вашу задачу. Поэтому поминутная тарификация ($0.0069 в минуту) продолжает идти до тех пор, пока вы не выключите телефон кнопкой Стоп на карточке профиля в личном кабинете.

  • Что происходит при нажатии кнопки «Стоп»: когда вы нажимаете Стоп на карточке телефона в разделе Мои телефоны (статус меняется на Выключен, рамка карточки становится серой, а внизу появляется кнопка Старт), устройство полностью выключается. В статусе Выключен никакие фоновые программы не работают и минуты с баланса не списываются. Если вы настроили внутри телефона отложенную публикацию или задачу по расписанию, на время её срабатывания смартфон должен оставаться в статусе Включён.

  • Внутренние Android-макросы и обычные кликеры на ПК: когда автоматизация работает через приложения внутри самого Android (Tasker, MacroDroid) или через команды по ADB, вкладку браузера с экраном телефона можно спокойно закрывать. А если вы используете обычный компьютерный автокликер, который нажимает мышкой по картинке прямо на вашем мониторе, вкладку браузера с телефоном нужно держать открытой. Для такой работы выбирайте при создании профиля ближайший к вам Регион сервера (США, Сингапур или Китай), чтобы картинка с экрана передавалась без задержек.

Раздел Мои телефоны в CyberYozh App с двумя профилями: слева запущенный облачный смартфон в статусе Включён с зелёной рамкой и кнопкой Стоп, справа склонированный профиль в статусе Выключен с серой рамкой и кнопкой Старт
Карточка со статусом «Включён» (зелёная рамка и кнопка «Стоп») продолжает выполнять фоновые Android-приложения даже при закрытой вкладке браузера, тогда как профиль со статусом «Выключен» (серая рамка и кнопка «Старт») полностью остановлен и не расходует минуты.

Шаг 3. Подключение внешних скриптов по ADB и включение Root-доступа

В CyberYozh App к любому запущенному облачному телефону можно подключиться напрямую по протоколу ADB (Android Debug Bridge), а при необходимости - в один клик включить на устройстве Root-доступ.

Протокол ADB позволяет управлять смартфонами через командную строку или внешние программы без ручных кликов по экрану. Через ADB вы можете подключить к облачным телефонам свои скрипты на Python и Node.js, фреймворк Appium, а также проекты в Browser Automation Studio (BAS) (подробнее о работе с этой программой читайте в нашей инструкции по настройке прокси в BAS). Скрипты смогут сами устанавливать и открывать приложения, нажимать на кнопки по координатам или селекторам, листать ленту и вводить текст сразу на десятках устройств параллельно.

Как включить Root и подключиться к телефону по ADB из личного кабинета:

  1. Запустите облачный телефон: нажмите кнопку Старт на карточке профиля в разделе Мои телефоны и дождитесь появления статуса Включён. Включить Root и ADB можно только на работающем устройстве, при этом подключение по ADB поддерживается на профилях с версиями Android от 11 до 15.

  2. Включите Root-доступ (если он нужен для вашей задачи): когда вашему софту или скрипту требуются права суперпользователя, откройте меню с тремя точками на карточке работающего телефона и нажмите Включить ROOT. Как только права активируются, в нижней части карточки слева от кнопки Стоп появится зелёный значок робота Android.

Карточка работающего облачного смартфона Android 13 в CyberYozh App со статусом Включён, зелёной рамкой и зелёной иконкой робота Android рядом с кнопкой Стоп, подтверждающей включённый Root-доступ
После выбора пункта «Включить ROOT» в меню запущенного смартфона рядом с кнопкой «Стоп» появляется зелёный значок Android, подтверждающий активные права суперпользователя.
  1. Включите ADB и скопируйте данные для подключения: откройте меню с тремя точками на карточке запущенного телефона и выберите пункт ADB. В открывшемся окне переведите переключатель ADB включён в активное положение и нажмите кнопку Получить данные подключения. На экране появится готовая команда с IP-адресом и портом (например, adb connect 162.128.207.240:20087) и пароль для входа (например, Пароль: 3oOQMq). Скопируйте их и нажмите Закрыть.

Окно настройки ADB в CyberYozh App с уведомлением Телефон должен быть запущен, списком поддерживаемых версий Android, переключателем ADB включён и кнопкой Закрыть
Откройте окно «ADB» из меню запущенного профиля и включите переключатель «ADB включён» для запуска удалённого подключения.
Модальное окно ADB в CyberYozh App с включённым тумблером ADB включён, кнопкой Получить данные подключения и выводом терминала с командой adb connect 162.128.207.240:20087 и строкой Пароль: 3oOQMq
После включения переключателя нажмите кнопку «Получить данные подключения», чтобы скопировать команду adb connect IP:port и пароль для ваших скриптов.
  1. Подключите свой скрипт или программу: выполните скопированную команду adb connect в терминале на своём компьютере или сервере, введите пароль ADB и запускайте свои сценарии на одном или сразу нескольких облачных смартфонах.

Шаг 4. Создание и запуск смартфонов через Cloud Phones REST API

Создавать новые профили в свободных слотах, запускать телефоны и запрашивать доступы к ADB можно прямо из вашего кода без входа в браузер. Для этого используйте официальный Cloud Phones API от CyberYozh App и инструменты из нашего раздела инфраструктуры для ИИ-агентов и автоматизации.

4.1. Получение API-ключа, список методов и доступные операции

Откройте раздел Ключи API в левом боковом меню личного кабинета и нажмите кнопку Сгенерировать API-ключ, чтобы выпустить секретный токен. В правом верхнем углу этой же страницы находятся кнопки Документация и Swagger, где можно посмотреть примеры всех запросов и протестировать их прямо в браузере (в окне Swagger нажмите Authorize -> ApiKeyAuth и вставьте свой ключ). При отправке запросов из скрипта передавайте токен в HTTP-заголовке X-Api-Key (не вставляйте ключ прямо в строку ссылки URL).

Страница Ключи API в личном кабинете CyberYozh App с кнопкой Сгенерировать API-ключ, верхними кнопками Документация и Swagger и таблицей активных ключей
В разделе «Ключи API» нажмите «Сгенерировать API-ключ» для выпуска токена либо откройте «Документация» и «Swagger» в правом верхнем углу для проверки методов.

Перед вызовом методов убедитесь, что в личном кабинете у вас есть хотя бы один свободный оплаченный слот профиля, минуты на балансе и рабочий прокси с протоколом SOCKS5. Через базовый адрес Cloud Phones API (/api/v2/cloud-phones/profiles/) доступны 7 основных операций:

HTTP-метод и путь после /api/v2/cloud-phones/profiles/

Что делает метод

Основные параметры и условия

Лимит запросов

GET / (список)

Возвращает список ваших профилей

Поддерживает пагинацию и фильтры page, page_size, search, status (например, ?status=running&page_size=10) и group (UUID папки)

50 запр./сек

POST / (создание)

Создаёт новый профиль в свободном оплаченном слоте

Обязательно поле name; дополнительно note, proxy и device (android_version по умолчанию 13; region: cn, sgp или us - для региона us по API нужно указывать Android 15). Возвращает статус slot_reserved

50 запр./сек

POST /{id}/start/

Отправляет команду на запуск телефона

Без тела запроса; требует привязанного прокси и минут на балансе; переводит профиль в статус starting

20 запр./сек

GET /{id}/

Проверяет параметры профиля и готовность после запуска

Запрашивайте с небольшой паузой, пока в поле view_url не появится ссылка (телефон включился), либо остановите проверку, если в last_start_error вернулся текст ошибки

50 запр./сек

POST /{id}/adb/

Включает или выключает ADB на работающем телефоне

Передайте JSON {"enabled":true} или {"enabled":false}; телефон должен быть запущен на Android 11 - 15

5 запр./сек

GET /{id}/adb/

Возвращает данные для подключения по ADB

Вызывайте после включения ADB, чтобы получить поля ip, port, password и готовую команду connect_command

5 запр./сек

POST /{id}/root/

Включает или выключает Root-доступ

Передайте JSON {"enabled":true} или {"enabled":false}; телефон должен быть запущен

5 запр./сек

⚠️

Что важно учитывать при работе с публичным API:

Покупка новых слотов, выключение работающего телефона (stop), удаление (delete) и клонирование профиля (clone), а также установка приложений и смена GPS-координат через публичный API v2 не выполняются. Запрос POST на создание профиля занимает уже купленный свободный слот (возвращая статус slot_reserved), не списывая деньги за новые слоты и не включая сам телефон. А чтобы остановить смартфон и поставить расходование минут на паузу, нажмите кнопку Стоп на карточке профиля в личном кабинете.

4.2. Пример работы по API через cURL: создание профиля, запуск и получение ADB

Чтобы не вставлять адрес сервера и свой API-ключ в каждую команду вручную, сначала сохраните их в переменные в терминале:

bash
export BASE_URL='https://app.cyberyozh.com'
export API_KEY='replace-with-your-api-key'

1. Создайте новый профиль в свободном оплаченном слоте:

bash
curl -X POST "${BASE_URL}/api/v2/cloud-phones/profiles/" \
  -H "X-Api-Key: ${API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Automation phone","proxy":{"proxy_information":"socks5://example-user:example-password@203.0.113.10:1080"},"device":{"android_version":"13","region":"sgp"}}'

Скопируйте уникальный идентификатор созданного профиля (поле id) из ответа сервера (HTTP 201) и сохраните его в переменную export PROFILE_ID='...'.

2. Отправьте команду на запуск телефона и дождитесь его включения:

bash
curl -X POST "${BASE_URL}/api/v2/cloud-phones/profiles/${PROFILE_ID}/start/" \
  -H "X-Api-Key: ${API_KEY}"

На запуск реального смартфона в дата-центре требуется немного времени, поэтому после команды старта проверяйте статус профиля запросом GET "${BASE_URL}/api/v2/cloud-phones/profiles/${PROFILE_ID}/" с паузой в несколько секунд, пока поле status не изменится на running, а в поле view_url не появится ссылка (если при запуске возникла ошибка, её причина вернётся в поле last_start_error).

Обратите внимание:

Ссылка из поля view_url предназначена для работы в вашем браузере, где вы уже вошли в личный кабинет CyberYozh App (а если нужно поделиться доступом к экрану с коллегой по гостевой ссылке или QR-коду, используйте кнопку Share / QR на боковой панели открытого телефона).

3. Включите ADB и получите команду подключения:

bash
curl -X POST "${BASE_URL}/api/v2/cloud-phones/profiles/${PROFILE_ID}/adb/" \
  -H "X-Api-Key: ${API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true}'

Через пару секунд отправьте запрос GET "${BASE_URL}/api/v2/cloud-phones/profiles/${PROFILE_ID}/adb/" - в ответе HTTP 200 придут поля ip, port, password и готовая строка connect_command (например, adb connect 162.128.207.240:20087).

4.3. Как объединить управление телефонами с API прокси, чекером Fraud Score и приёмом СМС

Внутри самого смартфона действиями управляет ADB, а все подготовительные шаги перед запуском профиля удобно автоматизировать через внешние скрипты (на Python, в Postman, Playwright, Puppeteer, Selenium или Scrapy) с помощью других методов API CyberYozh App. Такой подход используют в самых разных сценариях автоматизации (а чем реальное ARM-железо отличается от обычных виртуальных машин, мы разбирали в статье про онлайн-эмуляторы Android):

  • Смена IP на прокси перед запуском телефона: покупайте новые прокси или вызывайте моментальную смену IP-адреса по ссылке и API на выделенных мобильных прокси LTE/4G/5G с безлимитным трафиком прямо перед стартом новой сессии.

  • Проверка чистоты IP через Fraud Score: отправляйте адрес прокси по API во встроенный чекер Fraud Score ($0.15 за проверку), чтобы скрипт автоматически проверял репутацию IP по антифрод-базам ещё до привязки к телефону.

  • Получение кодов подтверждения из СМС по API: арендуйте виртуальные номера или резидентские номера сотовых операторов США через API раздела СМС и автоматически передавайте пришедший код подтверждения в свой ADB-скрипт для ввода на экране смартфона.

В следующей части руководства мы подробно разберём установку приложений из APK и Google Play, передачу файлов, работу с камерой и приём СМС внутри смартфона (Приложения и рабочие сценарии).

Частые ошибки при автоматизации, работе с ADB и API (и как их исправить)

Ниже собраны решения для четырёх самых частых ситуаций, с которыми сталкиваются при настройке фоновых задач и вызове методов API:

Что происходит

Почему так бывает

Как решить в CyberYozh App

Минуты продолжают списываться после закрытия вкладки браузера

Закрытие вкладки в браузере выключает только картинку на вашем мониторе, а сам телефон на сервере ARM продолжает работать в фоновом режиме.

Когда фоновые задачи завершены, откройте раздел Мои телефоны, выберите в фильтре Все статусы -> Включён и нажмите кнопку Стоп на карточке профиля, чтобы перевести телефон в статус Выключен.

API возвращает ошибку HTTP 402 (no_free_slots, period_expired или no_minutes)

Метод создания профиля по API не покупает новые слоты автоматически, либо на балансе закончились минуты для запуска.

В разделе Мои телефоны докупите слоты через кнопку + Управление профилями или пополните пакет минут через + Добавить минуты перед вызовом POST /profiles/ или POST /start/.

Запрос к ADB по API возвращает HTTP 409 или HTTP 422

Код 409 означает, что телефон выключен или ADB ещё запускается; код 422 возвращается, если версия ОС не поддерживает эту функцию (для ADB по API нужен Android 11 - 15).

Проверьте через GET /profiles/{id}/, что телефон уже перешёл в статус running, убедитесь, что в профиле выбран Android 11 - 15, и подождите пару секунд перед повторным запросом GET /adb/.

API возвращает HTTP 405 Method Not Allowed при попытке выключить или удалить телефон

Выключение, удаление, клонирование, покупка слотов, установка приложений и смена GPS не входят в публичный API v2.

Выключайте, клонируйте и удаляйте профили через веб-интерфейс в разделе Мои телефоны, а для автоматической установки и запуска приложений используйте подключение по ADB.

👉 Перейти к инструментам ИИ и API-автоматизации CyberYozh App

Часто задаваемые вопросы по автоматизации и API облачных телефонов