Как получить токен Threads* API из России: пошаговая инструкция и скрипт
Я делаю автопостинг в Threads*, и для этого нужен токен Threads* API. Это параметр без которого вы не сможет публиковать посты от имени вашего аккаунта. Официальная инструкция Meta* рассчитана на тех, кто живет без блокировок. Я живу в РФ и сложности подстерегают на каждом шагу:
- аккаунт разработчика не подтверждался российским номером;
- нельзя войти в Threads* напрямую, чтобы подтвердить выдачу токена,.
Ниже весь путь по шагам и скрипт, который превращает ссылку из браузера в долгоживущий токен на 60 дней.
* Instagram, Facebook и Threads принадлежат компании Meta, которая признана экстремистской организацией и запрещена в России.
Что понадобится
- VPN
- аккаунт Instagram* с созданным профилем Threads*;
- аккаунт Facebook*: через него входят в кабинет разработчика Meta*;
- номер телефона, который Meta* примет для подтверждения. У меня российский не прошёл, помог только реальный казахстанский;
- компьютер с браузером: на телефоне шаг с подтверждением токена работает плохо, подробности ниже;
- терминал (macOS или Linux) с curl и python3.
Шаг 1. Аккаунт разработчика
- Зайдите на developers.facebook.com под своим Facebook*-аккаунтом и нажмите «Начать» (Get Started).
- Meta попросит подтвердить номер телефона. С российским номером код у меня не приходил, не помогли даже виртуальные номера 5sim из Великобритании. Мне повезло, у меня есть казахстанский номер, на него дошли SMS. Подойдёт любой не российский номер, на который реально приходят SMS.
- Подтвердите почту и выберите роль (например, Developer).
Шаг 2. Приложение с доступом к Threads* API
- В кабинете откройте «Мои приложения» → «Создать приложение».
- В сценариях использования (Use cases) выберите Access the Threads* API.
- В настройках этого сценария (Customize) включите разрешения:threads_basic: базовый доступ к профилю;threads_content_publish: публикация постов;threads_manage_replies: ответы под постами. Без него при попытке опубликовать цепочку из поста и комментариев получите ошибку Application does not have permission for this action (code 10).
- В разделе настроек Threads укажите адрес перенаправления (Redirect Callback URL): https://localhost/. Поля Uninstall и Delete Callback URL тоже обязательны, туда можно вписать тот же адрес.
- Там же, в настройках сценария Threads*, найдите Threads* App ID и Threads* App Secret. Это не те ID и секрет, что в общих настройках приложения, а отдельная пара именно для Threads*. Перепутать их легко, и с чужой парой обмен кода на токен не сработает.
Шаг 3. Добавьте себя в тестировщики
Пока приложение в режиме разработки, токен можно получить только для аккаунтов-тестировщиков.
- В приложении откройте «Роли приложения» (App Roles) → «Роли» и добавьте свой ник в Threads* с ролью Threads* Tester.
- Приглашение нужно принять в самом Threads*. В веб-версии это «Настройки» → «Аккаунт» → «Разрешения для сайтов» → «Приглашения».
Чтобы принять приглашение в веб-версии, нужно в неё войти. Это тот же вход, что понадобится в шаге 4.
Шаг 4. Подтвердите доступ: главная засада
Теперь нужно открыть ссылку авторизации, в которой вместо ВАШ_THREADS_APP_ID стоит ваш Threads* App ID:
https://www.threads.net/oauth/authorize?client_id=ВАШ_THREADS_APP_ID&redirect_uri=https://localhost/&scope=threads_basic,threads_content_publish,threads_manage_replies&response_type=code
Threads* покажет, какие права запрашивает приложение, вы нажмёте «Разрешить», и браузер перейдёт на https://localhost/?code=.... Так это задумано. На деле:
- на телефоне ссылка перекидывает в приложение Threads*, и там ничего не происходит;
- на компьютере напрямую войти на threads.net у меня не получилось из за региональных ограничений (даже с VPN)
Что сработало:
- В том же браузере сначала войдите в Instagram* (instagram.com).
- Откройте threads.net. Сайт сам предложит продолжить с аккаунтом Instagram*. Соглашайтесь.
- Теперь, когда вы вошли в Threads*, откройте ссылку авторизации ещё раз и нажмите «Разрешить».
Порядок важен: сначала Instagram*, потом Thread*s через Instagram*, и только потом ссылка авторизации.
После подтверждения браузер откроет что-то вроде:
https://localhost/?code=AQBx...очень_длинная_строка...#_
Страница не загрузится, потому что на вашем компьютере нет сервера по этому адресу. Это нормально: нужна только адресная строка. Скопируйте адрес целиком.
Код из ссылки одноразовый и живёт около часа, поэтому следующий шаг лучше сделать сразу.
Шаг 5. Обменяйте код на долгоживущий токен
Код из ссылки сам по себе не токен. Его нужно обменять дважды:
- код → короткоживущий токен (действует около часа);
- короткоживущий → долгоживущий (действует 60 дней).
Я завернул оба обмена в скрипт. Он сам вырезает код из скопированного адреса (вместе с хвостом #_, который добавляет Threads*), проверяет полученный токен запросом к профилю и кладёт токен в буфер обмена. Секрет и код вводятся скрыто и никуда не сохраняются.
Сохраните скрипт как threads-token.sh:
#!/usr/bin/env bash # Threads: адрес с ?code=... → долгоживущий токен (60 дней). # Запуск: bash threads-token.sh # Спросит Threads App ID, Threads App Secret и код (или адрес целиком). set -euo pipefail # должен совпадать с redirect_uri из ссылки авторизации REDIRECT_URI="${THREADS_REDIRECT_URI:-https://localhost/}" # достаёт поле из JSON-ответа или выходит с ошибкой Threads json_field() { python3 -c ' import json, sys key = sys.argv[1] try: data = json.load(sys.stdin) except ValueError: sys.exit("Ответ не JSON") if key not in data: sys.exit("Ошибка Threads: " + json.dumps(data.get("error", data), ensure_ascii=False)) print(data[key], end="") ' "$1" } read -r -p "Threads App ID: " APP_ID read -r -s -p "Threads App Secret: " APP_SECRET; echo read -r -s -p "Code (или адрес целиком): " INPUT; echo # из адреса оставляем только значение code= (без &... и #_) CODE="${INPUT#*code=}" CODE="${CODE%%&*}" CODE="${CODE%%#*}" [[ -n "$APP_ID" && -n "$APP_SECRET" && -n "$CODE" ]] || { echo "Нужны App ID, App Secret и code" >&2; exit 1; } echo "Code → краткосрочный токен…" SHORT=$(curl -sS -X POST "https://graph.threads.net/oauth/access_token" \ --data-urlencode "client_id=$APP_ID" \ --data-urlencode "client_secret=$APP_SECRET" \ --data-urlencode "grant_type=authorization_code" \ --data-urlencode "redirect_uri=$REDIRECT_URI" \ --data-urlencode "code=$CODE" | json_field access_token) echo "Краткосрочный → долгосрочный (60 дней)…" LONG=$(curl -sS -G "https://graph.threads.net/access_token" \ --data-urlencode "grant_type=th_exchange_token" \ --data-urlencode "client_secret=$APP_SECRET" \ --data-urlencode "access_token=$SHORT" | json_field access_token) # проверка: токен рабочий, если Threads отдаёт ваш ник USERNAME=$(curl -sS -G "https://graph.threads.net/v1.0/me" \ --data-urlencode "fields=id,username" \ --data-urlencode "access_token=$LONG" | json_field username) if command -v pbcopy >/dev/null; then printf %s "$LONG" | pbcopy echo "Готово: @$USERNAME. Токен в буфере обмена." else echo "Готово: @$USERNAME. Токен:" echo "$LONG" fi
Запустите:
./bash threads-token.sh
Введите App ID и App Secret (их можно вставить из буфера обмена, ввод секрета просто не отображается). Затем вставьте скопированный адрес https://localhost/?code=.... Если всё прошло, скрипт напишет Готово: @ваш_ник. На macOS токен уже будет в буфере обмена, на Linux скрипт выведет его в терминал.
Если пишет Ошибка Threads*, чаще всего причина одна из трёх:
- код уже использован или устарел. Откройте ссылку авторизации ещё раз и возьмите новый код;
- указаны общие App ID и секрет приложения вместо пары из настроек Threads*;
- redirect_uri в ссылке и в настройках приложения не совпадают до символа, включая слэш в конце.
Шаг 6. Не дайте токену протухнуть
Долгоживущий токен действует 60 дней, но его можно продлевать без повторной авторизации. Продлить можно токен, которому больше суток и который ещё не истёк:
curl -sS -G "https://graph.threads.net/refresh_access_token" \ --data-urlencode "grant_type=th_refresh_token" \ --data-urlencode "access_token=ВАШ_ТОКЕН"
В ответе будет новый токен ещё на 60 дней. В моём боте это делает ежедневная задача: продлевает токен, если до конца срока осталось меньше 10 дней. Достаточно один раз пройти инструкцию выше, дальше всё работает само.
Пара советов напоследок
- Токен даёт полный доступ к публикации от вашего имени. Не отправляйте его в чаты и не коммитьте в репозиторий: храните в переменных окружения или в базе.
- App Secret ещё важнее токена: с ним можно выпускать новые токены. Если он утёк, сгенерируйте новый в настройках приложения.
- Если решите добавить права позже, например threads_manage_replies, старый токен их не получит. Нужно пройти шаги 4 и 5 заново со ссылкой, где в scope перечислены все нужные права.
Больше про разработку в канале https://t.me/five_a_m