Adset.ProAdset.ProKnowledge base
Home/Встановлення FB-агента та підключення антидетекта: ключ Local API для Dolphin Anty, AdsPower, Vision, Multilogin

Встановлення FB-агента та підключення антидетекта: ключ Local API для Dolphin Anty, AdsPower, Vision, Multilogin

Коротка інструкція: як встановити FB-агент Adset.pro — розширення, яке синхронізує витрати Facebook із профілів антидетект-браузера, — і де взяти ключ API антидетекта для Dolphin Anty, AdsPower, Vision і Multilogin X. Усі налаштування архіву докладно розібрано в статті «Глобальная установка антидетект-агента» (російською).


Що знадобиться

  • Антидетект-браузер: AdsPower, Dolphin Anty, Vision або Multilogin X (бета). Можна обійтися й без антидетекта — агент працює у звичайному Chrome.

  • Проксі в кожного профілю. Витрати Adset.pro забирає з Facebook через проксі профілю — без проксі синхронізації немає.

  • У профілі — виконаний вхід у Facebook і відкрита вкладка Ads Manager.

  • Акаунт Adset.pro у складі команди: розширення завантажує сам учасник команди.


Крок 1. Ключ API антидетекта

Антидетект

Чи потрібен ключ

Де взяти

AdsPower

Лише якщо в AdsPower увімкнено перевірку API-ключа

AdsPower → API & MCP → блок API Settings → Generate api-key

Dolphin Anty

Так — API-токен

Особистий кабінет Dolphin Anty на сайті → розділ API

Vision

Так — X-Token

Застосунок Vision → Налаштування → Розширені можливості (Settings → Extended Features)

Multilogin X (бета)

Так — automation token

Випускається через API Multilogin — інструкція «Automation token» у базі знань Multilogin

Без антидетекта

Ні

—

Ключ антидетекта вкладається лише в архів, що завантажується, і на сервері Adset.pro не зберігається. Не пересилайте його в чатах — ні в підтримку, ні асистенту.

AdsPower: Local API і ключ

Агент знаходить профіль через Local API AdsPower, тому його має бути увімкнено: перевірте це в розділі API & MCP (у старих версіях — «Автоматизація» → API). Стандартна адреса — http://127.0.0.1:50325, змінювати її не потрібно.

Ключ потрібен, лише якщо в блоці API Settings увімкнено перевірку API-ключа. Тоді натисніть Generate api-key і скопіюйте ключ. Якщо перевірку вимкнено — поле ключа залиште порожнім.

Dolphin Anty: API-токен

Вмикати Local API в застосунку Dolphin Anty не потрібно: агент працює через хмарний API Dolphin, і для цього потрібен лише API-токен.

  1. Відкрийте особистий кабінет Dolphin Anty на сайті, розділ API.

  2. Вкажіть назву токена й оберіть максимальний строк дії: коли токен спливе, агент перестане бачити профілі.

  3. Створіть токен і одразу скопіюйте його — він показується один раз.

Свій профіль у Dolphin агент упізнає за відбитком браузера, тому тримайте в профілі відкритою вкладку із сайтом — Facebook підходить.

Vision: X-Token

У застосунку Vision відкрийте Налаштування → Розширені можливості і скопіюйте X-Token. Якщо застосунок працює в командному режимі, замість нього показується X-Team-Token — використовуйте його.

Multilogin X (бета): automation token

Потрібен automation token робочого простору. Multilogin видає його через свій API (інструкція «Automation token» у базі знань Multilogin); під час випуску вкажіть максимальний строк дії. Проксі з Multilogin агент не читає: логін і пароль проксі один раз вкажіть у налаштуваннях розширення.


Крок 2. Завантажити розширення в Adset.pro

  1. Відкрийте Meta / TikTok → Соціальні профілі і натисніть «Завантажити розширення».

  2. У полі «Антидетект-браузер» оберіть свій.

  3. Вставте ключ із кроку 1. Поле називається за браузером: «API-токен Dolphin Anty», «Ключ Local API AdsPower», «X-Token Vision», «Токен Multilogin».

  4. «Адреса API антидетекта» залиште порожньою — вона потрібна лише в нестандартних випадках (див. «Типові помилки»).

  5. Оберіть «Джерело трафіку за замовчуванням» — тоді профілі підключатимуться самі, без запитань.

  6. Натисніть «Завантажити архів».

В архіві — ваш особистий ключ доступу. Не передавайте архів іншим людям. Якщо він потрапив до чужих рук, натисніть «Відкликати ключ» у тому ж діалозі: усі завантажені копії перестануть працювати.


Крок 3. Встановити розширення в антидетект

Розширення встановлюється один раз, як глобальне (спільне) — через розділ розширень самого антидетекта, а не в кожен профіль:

  • AdsPower: Extensions → вкладка Team → Add extension → оберіть zip-архів. Потім увімкніть розширення для профілів: для наявних — Profile → Edit extension, для нових зручно створити категорію розширень.

  • Dolphin Anty: розділ «Розширення» → «+» → додайте розширення із zip-архіву.

  • Vision: розділ «Розширення» → додайте zip-архів. Розширення діє на профілі поточної папки — якщо папок кілька, додайте його в кожну.

  • Multilogin X: розділ розширень → завантажте архів і призначте його потрібним профілям.

  • Звичайний Chrome: розпакуйте архів, відкрийте chrome://extensions, увімкніть «Режим розробника» і натисніть «Завантажити розпаковане розширення».


Крок 4. Запустити профіль

  1. Запустіть профіль антидетекта, увійдіть у Facebook і відкрийте Ads Manager.

  2. За хвилину агент визначить профіль, візьме його проксі й створить соц-профіль в Adset.pro — він з’явиться в Meta / TikTok → Соціальні профілі.

  3. Якщо агенту чогось бракує (не обрано джерело, не визначився проксі, немає впевненості в профілі), він один раз відкриє вкладку «Підключення профілю»: перевірте дані й натисніть «Підключити».

Витрати з’являться після першого серверного прогону — протягом 30 хвилин.


Типові помилки

Що бачите

Що робити

«Антидетект не відповідає»

Застосунок антидетекта не запущено, вимкнено його API або ключ неправильний чи прострочений. Запустіть антидетект і перевірте ключ. Новий ключ — завантажте архів заново й замініть ним розширення в антидетекті.

«Антидетект не відповідає», хоча AdsPower запущено

Змінився порт Local API: AdsPower бере інший, коли стандартний 50325 зайнятий. Повністю закрийте AdsPower і запустіть знову — порт зазвичай повертається. Не допомогло — подивіться поточну адресу в AdsPower (API & MCP або «Автоматизація» → API) і завантажте архів заново, вказавши в «Адреса API антидетекта» http://127.0.0.1:ПОРТ. Саме 127.0.0.1, а не local.adspower.net: до імені хоста профіль звертається через свій проксі.

Dolphin Anty, Vision або Multilogin не бачать профілів

Ключ (API-токен, X-Token, automation token) не вказано, він неправильний або прострочений. Випустіть новий і завантажте архів заново.

«Підтвердьте профіль антидетекта, у якому запущено цей браузер»

Агент не впевнений, у якому профілі запущений: наприклад, у двох профілів однаковий відбиток або в профілі немає вкладки із сайтом. Оберіть профіль у формі один раз — далі його закріплено.

Не визначився проксі або немає логіна й пароля

Перевірте, що в профілю в антидетекті задано проксі. Якщо логін і пароль не підтягнулися — вкажіть їх у налаштуваннях розширення.

Розширення встановлено, але нічого не відбувається

У профілі немає входу у Facebook — без нього агент нічого не робить. Відкрийте вікно розширення: на вкладці «Синхронізація» написано, чого бракує.

«Цей профіль антидетекта вже підключив інший учасник команди»

Цей профіль підключив колега. Якщо профіль передали вам, попросіть тімліда передати його в Adset.pro або колегу — закрити свій соц-профіль.

Профіль підключено, а витрат немає

Відкрийте соц-профіль у кабінеті → вкладка «Підключення» → блок «Проксі». «Не працює» — змініть проксі в профілі антидетекта. Помилка «HTTP 407» — у проксі неправильні логін або пароль.

Вийшла нова версія розширення

Саме розширення не оновлюється: завантажте архів заново й замініть його в антидетекті. Ключ лишається тим самим.


Якщо не вийшло

Напишіть у підтримку Adset.pro: який антидетект і яка в нього версія, що написано у вікні розширення. Ключі API та сам архів не надсилайте.