Configuración de Threads

Crea una app de Meta con el caso de uso de Threads

1. Ve a developers.facebook.com/apps e inicia sesión.
2. Haz clic en Create App.
3. En Use cases, elige Access the Threads API. (Está en la lista, desplázate si hace falta.)
4. Ponle nombre a la app, añade un correo de contacto y créala.

También puedes añadir el caso de uso de Threads a una app de Meta existente. Barra lateral izquierda, Use cases, Add use case, Access the Threads API.

Copia el Threads App ID y el Threads App Secret

Aquí está la trampa: una app con el caso de uso de Threads tiene dos App IDs y dos App Secrets, uno para la app padre de Meta y otro específico de Threads. Necesitas el par de Threads, no el de la app padre.

1. Barra lateral izquierda, Use cases, Access the Threads API, Customize.
2. Desplázate hasta Settings y encuentra el Threads App ID y el Threads App Secret.
3. Copia ambos.

Si por accidente usas el App ID de la app padre de Meta en las llamadas OAuth, obtendrás errores confusos de invalid_client. Usa siempre el par de Threads.

Añade permisos y URLs

Todavía dentro de Use cases, Access the Threads API, Customize:

1. Abre Permissions y añade:
   • threads_basic (requerido para todo)
   • threads_content_publish (requerido para publicar)
   • threads_manage_insights (opcional, métricas)
2. Abre Settings (dentro del caso de uso) y añade:
   • Redirect Callback URL, cualquier URL HTTPS que controles (por ejemplo https://getartdrop.com/).
   • Deauthorize Callback URL, la misma u otra distinta.
   • Data Deletion Request URL, la misma.

Añádete como Threads Tester (evita la revisión de la app)

Una app con el caso de uso de Threads empieza en modo Development. En modo de desarrollo, solo los administradores y testers de la propia app pueden autorizarla. Eso está perfecto para uso de un solo usuario, no necesitas la revisión de la app (App Review).

1. Barra lateral izquierda, App roles, Roles.
2. Desplázate hasta Threads Testers y haz clic en Add Threads Testers.
3. Introduce tu nombre de usuario de Threads y envía la invitación.
4. En threads.net/settings, acepta la invitación (revisa la sección Website permissions o Invites).

NO cambies la app a modo Live. El modo Live requiere una revisión completa de la app (App Review), que tarda de 2 a 4 semanas y necesita una grabación de pantalla del flujo del usuario. Totalmente innecesario para uso personal.

Abre la URL de autorización de Threads en un navegador

Arma esta URL, sustituyendo tu THREADS_APP_ID y tu URL de redirección:

https://threads.net/oauth/authorize
    ?client_id={THREADS_APP_ID}
    &redirect_uri={REDIRECT_URL}
    &scope=threads_basic,threads_content_publish,threads_manage_insights
    &response_type=code
    &state=artdrop-setup

Pégala en un navegador donde tengas la sesión iniciada en Threads. Pulsa Authorize. Threads te redirige de vuelta a tu URL de redirección con un parámetro ?code=... en la barra de direcciones.

Copia el valor de code de la URL. Úsalo en el siguiente paso dentro de unos minutos. Los códigos caducan rápido.

Cambia el código por un token de acceso de corta duración

Haz un POST al endpoint del token. Lo más fácil es con curl:

curl -X POST https://graph.threads.net/oauth/access_token \
     -F client_id={THREADS_APP_ID} \
     -F client_secret={THREADS_APP_SECRET} \
     -F grant_type=authorization_code \
     -F redirect_uri={REDIRECT_URL} \
     -F code={CODE_FROM_STEP_5}

Respuesta:

{ "access_token": "THAAx...", "user_id": 123456789012345 }

Copia el access_token. Esa es la versión de corta duración (~1 hora). Toma también el user_id, ese es el Threads User ID para ArtDrop.

Cambia el token corto por uno de 60 días

curl -G https://graph.threads.net/access_token \
     -d grant_type=th_exchange_token \
     -d client_secret={THREADS_APP_SECRET} \
     -d access_token={SHORT_TOKEN_FROM_STEP_6}

La respuesta te da un nuevo access_token válido durante 60 días.

ArtDrop renueva este token automáticamente antes de que caduque. Si ArtDrop está desconectado o desinstalado más allá de los 60 días, el token muere y tendrás que rehacer todo desde el Paso 5.

Introduce ambos valores en ArtDrop

De vuelta en la página Social de ArtDrop, sección Threads:

• Threads Access Token: el token de larga duración del Paso 7.
• User ID: el ID numérico del Paso 6.

Pulsa Save. ArtDrop llama a /me?fields=id,username para verificar, y verás el nombre de usuario vinculado de inmediato si funcionó.