Кабинет Socialift: что делает каждый раздел
Кабинет Socialift (socialift.uz/dashboard) состоит из семи разделов: «Tokenlar» (токены) — лицензионные ключи SDK, «Playground» — 191 методов без кода, «Ulanishlar» (подключения) — аккаунты и боты, «Kalitlar» (ключи) — ваши ключи developer app, «Statistika» (статистика) — активации SDK и запросы к API, «Hisob» (счёт) — баланс и оплата, «Qo'llanma» (руководство) — инструкция для старта.
Обновлено:
Зачем нужен кабинет?
Для двух задач. Первая — получить лицензионный ключ для SDK и следить за его состоянием («Tokenlar», «Statistika», «Hisob»). Вторая — пробовать методы на настоящих аккаунтах без кода («Ulanishlar», «Kalitlar», «Playground»). Подключённые в кабинете аккаунты и ключи остаются на сервере Socialift: SDK в вашем приложении их не использует и работает с вашими ключами и токенами.
Интерфейс кабинета на узбекском, поэтому ниже названия пунктов меню и кнопок даны как на экране, с переводом в скобках.
Разделы кратко
| Раздел | Адрес | Что делает |
|---|---|---|
| «Tokenlar» (токены) | /dashboard | Получение, просмотр, продление и проверка лицензионных ключей |
| «Playground» | /dashboard/playground | Документация, форма и живой запрос для 191 методов |
| «Ulanishlar» (подключения) | /dashboard/connections | Подключение Facebook, Instagram, LinkedIn, TikTok, аккаунта и бота Telegram |
| «Kalitlar» (ключи) | /dashboard/apps | Хранение и проверка ваших ключей developer app |
| «Statistika» (статистика) | /dashboard/usage | Активации SDK и запросы Playground/API, с ошибками |
| «Hisob» (счёт) | /dashboard/billing | Баланс и пополнение |
| «Qo'llanma» (руководство) | /dashboard/guide | Установка, настройка ключа, примеры первого вызова |
«Tokenlar» (токены): лицензионные ключи
«Yangi token» (новый токен) создаёт лицензионный ключ: первый месяц бесплатно, и в это время открыты все возможности SDK; токен выдаётся с 1 seat. Одновременно может быть до 5 активных токенов. На карточке видны key_id, тариф, статус, отметка «bepul sinov» (бесплатный пробный период) и оставшиеся дни.
«Kalitni ko'rsatish» (показать ключ) раскрывает полный ключ slk_..., «Nusxa» (копировать) копирует его в буфер. «30 kunga uzaytirish» (продлить на 30 дней) списывает оплату с баланса и добавляет 30 дней: к оставшемуся сроку, если он не истёк, или от сегодняшнего дня, если истёк (тогда кнопка называется «Qayta faollashtirish» — активировать снова). Если средств не хватает, появится сообщение — для этого рядом ссылка «Hisobni to'ldirish» (пополнить счёт). Возможности продлённого токена зависят от его тарифа, а ключ переподписывается с тем же key_id: SDK 1.3+ сам получает новый срок с сервера, а с версией 1.2.x из PyPI или при SOCIALIFT_LICENSE_OFFLINE=1 замените SOCIALIFT_LICENSE_KEY на новый ключ из «Kalitni ko'rsatish» (показать ключ).
«Tekshirish va muhitlar» (проверка и окружения) seat не занимает. Показывает, работает ли ключ с SDK, тариф, занятые seats, срок lease, последнюю активацию, открытые возможности и таблицу окружений, занявших seats. Если все seats заняты, предупреждает, что новый сервер или контейнер получит отказ.
«Playground»: 191 методов без кода
Слева — список методов: поиск, фильтр по платформе (Facebook, Instagram, LinkedIn, TikTok, аккаунт Telegram, бот Telegram, CRM и лиды, подключённые аккаунты) и группы. У выбранного метода видны HTTP-метод и путь, тип действия, нужные разрешения (scope), документация и заметки.
На панели «So'rov» (запрос) список «Qaysi akkaunt nomidan» (от имени какого аккаунта) показывает подходящие подключённые аккаунты; если подходящего нет, появляется ссылка на «Ulanishlar» (подключения). Параметры заполняются формой или JSON. «Yuborish» (отправить) отправляет запрос через сервер Socialift от имени вашего аккаунта на настоящую платформу.
На панели «Javob» (ответ) — код статуса, время (мс), размер, тело и заголовки; файловые ответы (например, изображение) показываются и скачиваются. На панели «Kod» (код) три вкладки: «Python SDK» — код SDK, который обращается к платформе напрямую (ключи и токены в вашем приложении); «cURL» и «JavaScript» — тот самый запрос к серверному API Socialift, который отправляет Playground, с JWT сессии кабинета. Некоторые действия есть только в серверном API — вкладка Python прямо об этом сообщает.
История последних запросов и выбранный для каждого метода аккаунт хранятся только в вашем браузере (localStorage).
Типы действий в Playground и подтверждения
| Метка | Значение | Перед отправкой |
|---|---|---|
| «Faqat o'qiydi» (только чтение) | Ничего не меняет | Подтверждение не нужно |
| «O'zgartiradi» (изменяет) | Реальное изменение на платформе: пост, сообщение, настройка | Подтверждение не запрашивается — но запрос настоящий |
| «O'chiradi» (удаляет) | Необратимое действие; красная точка в списке | «Yuborish» неактивна, пока не отмечено «Tushundim, yuborilsin.» (понимаю, отправить) |
| «Byudjetga ta'sir» (влияет на бюджет) | Может тратить рекламный бюджет; жёлтая точка в списке | «Yuborish» неактивна, пока не отмечено «Tushundim, yuborilsin.» |
| «Ulanish» (подключение) | Работает с подключением или токеном | Подтверждение не нужно |
Примечания и ограничения
Подтверждение запрашивается заново после каждой отправки. Защита есть и в других разделах: «Uzish» (отключить) в «Ulanishlar» открывает окно подтверждения браузера; в «Kalitlar» попытка удалить ключ, через который подключены аккаунты, останавливается со списком этих аккаунтов и продолжается только кнопкой «Baribir o'chirish va uzish» (всё равно удалить и отключить).
«Ulanishlar» (подключения): как подключить аккаунты?
Facebook, «Instagram (Page'siz)» (Instagram без страницы), LinkedIn и TikTok подключаются через OAuth кнопкой «Ulash» (подключить). После подключения Facebook нажмите «Page'larni sinxronlash» (синхронизировать страницы) — добавятся страницы и привязанные к ним аккаунты Instagram. «Instagram (Page'siz)» — профессиональный аккаунт (Business или Creator) через Instagram Login.
«Telegram akkaunt» (аккаунт Telegram): номер телефона → код подтверждения (обычно приходит не по SMS, а в само приложение Telegram) → пароль, если включена двухэтапная проверка. «Telegram bot»: токен от @BotFather, ключ приложения не нужен. Если бот в группах видит только адресованные ему сообщения, кабинет советует отключить Group Privacy в BotFather.
Токены хранятся на сервере в зашифрованном виде и в браузер не передаются. В строке аккаунта: дата окончания токена (или «muddatsiz» — бессрочный), отметка «qayta ulash kerak» (нужно переподключить), «Token'ni yangilash» (обновить токен — для Instagram без страницы, LinkedIn, TikTok), быстрая ссылка в Playground и «Uzish» (отключить). Отключение аккаунта Telegram завершает и сеанс Telegram; для личного аккаунта Facebook и TikTok выданный доступ отзывается.
Если для платформы есть и ваше приложение, и приложение Socialift, на карточке появляется выбор «Qaysi kalit bilan» (каким ключом): «O'z app'im» (моё приложение) или «Socialift app'i» (приложение Socialift).
«Kalitlar» (ключи): своё developer app или общее приложение Socialift?
В разделе «Kalitlar» хранятся ваши ключи для пяти провайдеров: «Meta (Facebook) app», «Instagram Login app», «LinkedIn app», «TikTok app» и «Telegram API (my.telegram.org)». Со своим приложением в окне входа видно название вашего приложения, вебхуки подписываются вашим секретом, а лимиты — ваши. Если ключ не задан, используется общий ключ Socialift (если он доступен).
Поля: client ID, secret, при необходимости config_id и scopes, название и отметка «Faol» (активен). Secret хранится зашифрованным и никогда не возвращается целиком — видны только последние символы; чтобы не менять его, оставьте поле пустым.
«Saqlash va tekshirish» (сохранить и проверить) проверяет ключ у самого провайдера. Результатов три: проверен, отклонён или заранее проверить нельзя (например, из-за сетевой ошибки) — последний не выдаётся ни за верный, ни за сломанный. Метка статуса: «O'z kalitingiz ishlatiladi» (используется ваш ключ), «Socialift kaliti ishlatiladi» (используется ключ Socialift) или «Sozlanmagan» (не настроен).
Справа — «Qanday olinadi» (как получить: шаги со ссылкой на консоль) и «Konsolga ko'chiring» (скопируйте в консоль): в зависимости от провайдера Redirect URI, Webhook URL, Webhook verify token, Deauthorize callback и Data deletion callback. Webhook URL и verify token появляются после сохранения ключа.
Какой ключ используется при новом подключении?
1. Ваш ключ
Если в «Kalitlar» есть активный ключ для этого провайдера, используется он.
2. Ключ Socialift
Если вашего ключа нет или он неактивен, используется общий ключ Socialift (если доступен).
Если есть оба
На карточке в «Ulanishlar» вы сами выбираете «O'z app'im» или «Socialift app'i».
Если нет ни одного
Карточка пишет «Kalit sozlanmagan» (ключ не настроен) и даёт ссылку на «Kalitlar».
После подключения
Аккаунт остаётся привязан к приложению, через которое подключён:
appsecret_proofу Meta и обновление токенов TikTok и LinkedIn требуют секрета именно этого приложения. Если сделать ключ неактивным, существующие аккаунты продолжат работать, а новые подключения пойдут через ключ Socialift. Если удалить ключ, через который подключены аккаунты, они отключатся и их токены перестанут работать.
«Statistika» (статистика): что считается, а что нет?
| Источник | Считается | Как |
|---|---|---|
| Лицензионные активации SDK | Да | При старте и при каждом продлении lease (по умолчанию 12 часов), по токену; отклонённые активации ключа с верной подписью — как ошибки |
| Playground и серверный API с JWT кабинета | Да | Только endpoint'ы платформ (Facebook, Instagram, LinkedIn, TikTok, Telegram, CRM), по пользователю |
| Каждый вызов SDK к платформам | Нет | SDK не ходит через сервер Socialift — видны только активации |
| Внутренние запросы кабинета | Нет | Профиль, токены, счёт, статистика, ключи и каталог Playground |
| Вебхуки и анонимные запросы | Нет | Их вызывают платформы или неизвестные клиенты |
Примечания и ограничения
Ошибка — запрос, завершившийся HTTP 4xx или 5xx. Endpoint хранится шаблоном, а не с ID (например, /facebook/posts/{post_id}); запросы без подходящего маршрута собираются в одну строку «(noma'lum endpoint)» (неизвестный endpoint).
Что видно на странице «Statistika»?
Период: 7, 30 или 90 дней. Сверху четыре показателя: всего запросов, ошибки (с процентом), «SDK aktivatsiyalari» (активации SDK) и «Playground / API». График «Kunlik so'rovlar» (запросы по дням) показывает SDK и Playground/API разными цветами и переключается в вид «Jadval» (таблица).
Таблица «Kalitlar bo'yicha» (по ключам) показывает для каждого источника (токена или пользователя) запросы, ошибки и последний день; «Eng ko'p ishlatilgan endpoint'lar» (самые используемые endpoint'ы) — метод, endpoint, число запросов и ошибок.
«Hisob» (счёт) и «Qo'llanma» (руководство)
«Hisob» показывает текущий баланс. Пополнение: введите сумму в сумах, выберите тип карты (Humo или Uzcard) и нажмите «Davom etish» (продолжить). Кабинет покажет номер карты и точную сумму — переведите именно её, потому что система находит платёж по сумме, затем нажмите «To'ladim — tekshirish» (я оплатил — проверить). Если выбранная сумма занята, кабинет предложит близкие варианты. Баланс используется для «30 kunga uzaytirish» (продления токена на 30 дней).
«Qo'llanma»: ссылка в Playground, проверка токена без расхода seat (тариф, seats, оставшиеся дни, возможности), команды установки, настройка SOCIALIFT_LICENSE_KEY и SOCIALIFT_INSTANCE_ID, примеры первого вызова для Facebook/Instagram, TikTok, Telegram и рекламы, пример обработки ошибок и адрес поддержки hello@socialift.uz.
Как перенести код из Playground в своё приложение?
Код на вкладке «Python SDK» обращается к платформе напрямую. Перенося его в приложение, вынесите ключи и токены из кода в переменные окружения.
import asyncio
import os
from socialift import Telegram
async def main():
# В Playground: bot = Telegram(token="123456:AA...") и me = await bot.get_me()
async with Telegram(token=os.environ["TELEGRAM_BOT_TOKEN"]) as bot:
me = await bot.get_me()
print(me["username"])
asyncio.run(main())В приложении нужен и SOCIALIFT_LICENSE_KEY — возьмите его в «Tokenlar» (токены). Бот или аккаунт, подключённый в кабинете, в SDK не передаётся: токен должен быть у вас.
Безопасность в кабинете: на что обратить внимание
- Не публикуйте раскрытый ключ
slk_...в чатах и репозиториях; при утечке напишите на hello@socialift.uz. - Запросы Playground настоящие: методы с меткой «O'zgartiradi» (изменяет) тоже публикуют посты и отправляют сообщения.
- Для «O'chiradi» (удаляет) и «Byudjetga ta'sir» (влияет на бюджет) ставьте отметку подтверждения только после проверки тела запроса.
- Токены платформ и секреты приложений зашифрованы на сервере: токены не уходят в браузер, secret не показывается целиком.
- Отключайте ненужные аккаунты кнопкой «Uzish» (отключить) — для аккаунта Telegram это завершает и сеанс.
Частые вопросы
Можно ли использовать токен аккаунта из кабинета в своём коде?
Нет. Токены в кабинете хранятся на сервере в зашифрованном виде и даже в браузер не передаются. В своём приложении токен получают через OAuth (login_url() → exchange_code()) и хранят в своей базе.
Занимает ли кнопка «Tekshirish va muhitlar» (проверка и окружения) seat?
Нет. Она не вызывает активацию SDK, а только читает сохранённое состояние, поэтому нажимать её можно сколько угодно. Seat занимает только настоящая активация SDK в новом окружении.
Запросы в Playground настоящие или тестовые?
Настоящие: запрос уходит через сервер Socialift на платформу от имени подключённого вами аккаунта — пост публикуется, сообщение отправляется. Поэтому удаление и действия, влияющие на рекламный бюджет, требуют отдельного подтверждения.
Что будет с уже подключёнными аккаунтами, если добавить свой ключ приложения?
Они продолжат работать, оставаясь привязанными к приложению, через которое были подключены. Новый ключ используется для следующих подключений; чтобы перевести аккаунт на своё приложение, переподключите его.
Почему в «Statistika» так мало вызовов SDK?
SDK обращается к Instagram, TikTok и другим платформам напрямую, а не через сервер Socialift. Поэтому считаются только лицензионные активации — при старте и при каждом продлении lease (по умолчанию 12 часов). Статистика по методам есть только для Playground и серверного API.
Пополнил счёт, но баланс не изменился. Что делать?
Проверьте, что перевели на указанную карту именно ту сумму, которую показал кабинет, — система находит платёж по сумме. Затем нажмите «To'ladim — tekshirish» (я оплатил — проверить); если платёж ещё не найден, кабинет об этом сообщит. Если проблема остаётся, напишите на hello@socialift.uz.