// Integración social · 7 pasos · ~10 min

Configuración de Pinterest

Consigue un token de acceso de la API v5 de Pinterest y el ID del tablero donde quieres que aterricen los pines. El OAuth de Pinterest es más sencillo que el de Meta, pero hay una trampa de nivel de acceso escondida en el Paso 6 que hace tropezar a casi todo el mundo. Léela antes de empezar a pinear.

// Con qué vas a terminar
  • social_pinterest_token, un token de acceso (vigencia de 30 días, el token de actualización dura 60 días)
  • social_pinterest_board_id, un ID de tablero numérico de 18 dígitos como 987654321098765432
// Antes de empezar
  • Tienes una cuenta de Pinterest.
  • Es una cuenta de empresa (el Paso 1 la convierte, gratis).
  • Ya pensaste en qué tablero quieres que aterricen los pines de ArtDrop.
  1. 1
    Pinterest

    Convierte a una cuenta de empresa

    La API v5 de Pinterest rechaza de plano las cuentas personales. El cambio es gratis, reversible y no afecta a tus pines existentes.

    1. Inicia sesión en pinterest.com.
    2. Haz clic en tu foto de perfil (arriba a la derecha), luego en la pequeña flecha, Convertir a empresa, Actualizar.
    3. Responde la breve encuesta empresarial (nombre del negocio, tipo, sitio web).

    Atajo: pinterest.com/business/convert/.

  2. 2
    Portal de desarrolladores

    Crea una app en developers.pinterest.com

    1. Abre developers.pinterest.com e inicia sesión con tu nueva cuenta de empresa.
    2. Haz clic en Connect app. (Se llama "Connect app", no "Create app". No te pongas a buscar el botón equivocado.)
    3. Completa el formulario: nombre de la app, descripción breve, uso previsto, tu sitio web y al menos una URI de redirección (cualquier URL HTTPS sirve para una app de uso personal, incluso algo como https://getartdrop.com/).
    4. Envía.

    Pinterest revisa las solicitudes de apps en horario laboral. En la mayoría de los casos recibirás un correo de aprobación (o rechazo) el mismo día hábil.

  3. 3
    Credenciales de la app

    Copia tu App ID y App secret

    1. Una vez aprobada, abre My apps en el panel de desarrollador.
    2. Haz clic en Manage en tu app.
    3. Copia el App ID.
    4. Junto a App secret key, haz clic en Show key, revélala y cópiala. Solo se muestra cuando haces clic, guárdala ahora.
  4. 4
    Permisos (scopes)

    Conoce qué permisos otorgar

    ArtDrop necesita estos cuatro scopes:

    • boards:read, lista tus tableros para que puedas elegir el ID de tablero correcto.
    • pins:read, lee el estado de los pines (detección de duplicados, programación).
    • pins:write, crea nuevos pines. Este es el requisito principal.
    • user_accounts:read, verifica la identidad al usar el token.

    Todavía no los ingresas en ninguna parte. Se le pasan a Pinterest en el Paso 5 cuando generas un token.

  5. 5
    Genera un token

    Usa el asistente "Generate access token" del panel

    El camino más fácil para una configuración de un solo usuario:

    1. En la página Manage de tu app, haz clic en Generate access token.
    2. Marca las casillas de los cuatro scopes del Paso 4.
    3. Haz clic en generar. Pinterest devuelve un token de acceso para tu propia cuenta, sin el baile de redirección de OAuth.
    4. Copia el token de acceso.

    Hay una trampa, lee el Paso 6 antes de pegarlo.

  6. 6
    Lee esto con atención

    Acceso de prueba vs. Acceso estándar (importante)

    Las apps nuevas quedan por defecto en Acceso de prueba (Trial Access). Los pines que crees con Acceso de prueba solo son visibles para ti. Cualquier otra persona que entre a tu tablero no verá nada nuevo. Eso es una característica, no un error, Pinterest lo usa para poner a los nuevos desarrolladores en un espacio de pruebas (sandbox).

    Para tráfico real necesitas Acceso estándar (Standard Access), que requiere una breve demostración en video del flujo de OAuth:

    1. En el panel de tu app, busca Apply for Standard Access (o similar).
    2. Graba una captura de pantalla rápida que muestre la página de consentimiento de OAuth de Pinterest otorgando acceso a tu app. Con ~30 segundos basta.
    3. Sube el video y envíalo.
    4. Pinterest revisa manualmente. Los plazos van desde 2 días hasta 2 semanas.

    Si te saltas este paso, ArtDrop parecerá que funciona, los pines se publican sin errores, pero nadie excepto tú puede verlos. Aprueba el acceso y prueba con un segundo navegador con la sesión cerrada después de actualizar.

  7. 7
    ID de tablero

    Encuentra el ID del tablero al que quieres enviar los pines

    Las URL web de Pinterest no contienen el ID numérico del tablero, muestran el slug (/mike/my-art-board/). La forma más rápida de conseguir el ID real es una llamada a la API de una sola línea.

    Ejecuta esto en un navegador o con curl, sustituyendo tu token:

    curl -H "Authorization: Bearer {ACCESS_TOKEN}" \
     https://api.pinterest.com/v5/boards

    Respuesta:

    {
  "items": [
    { "id": "987654321098765432", "name": "My Art Board", ... },
    { "id": "987654321098765431", "name": "Seasonal Drops", ... }
  ]
}

    Copia el id del tablero que quieras, ese es el ID de tablero.

    Si tienes más de 25 tableros, la respuesta viene paginada con un campo bookmark. Agrega ?bookmark={value} para seguir avanzando.

// Pega y guarda

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

  • Access Token: el token del Paso 5.
  • Board ID: el ID numérico de 18 dígitos del Paso 7.

Pulsa Guardar. ArtDrop valida el token con una llamada a /v5/user_account y el ID de tablero con /v5/boards/{id}, así que sabrás al instante si alguno está mal.

// Trampas comunes
  • Rechazo de cuenta personal: la API devuelve un claro 400 con "not a business account". Vuelve al Paso 1.
  • El token expira en 24 horas: usaste el token de prueba del asistente. Para un token de 30 días, completa una vez el flujo completo de OAuth (la colección de Postman de Pinterest tiene un asistente "Generate access token" de un clic, o ArtDrop puede guiarte, escribe a soporte).
  • Pines invisibles: sigues en Acceso de prueba. Solicita el Estándar (Paso 6) y vuelve a verificar con una pestaña de incógnito.
  • URI de redirección no coincide: los errores de OAuth que se quejan de la URI de redirección significan que la URL de la solicitud de autenticación no coincide exactamente con la que pusiste en el Paso 2 (incluida la barra final). Edita la configuración de tu app o la solicitud.
  • Actualiza antes de los 60 días: los tokens de actualización de Pinterest duran 60 días. ArtDrop los renueva automáticamente cuando falta menos de 7 días para que expiren, pero si la herramienta está fuera de línea durante 2 meses el token muere y tendrás que rehacer el Paso 5.
  • Límites de tasa: 1000 lecturas, 100 escrituras, por app, por minuto. ArtDrop marca el ritmo de publicación muy por debajo de esto, pero cargas masivas de 500+ pines pueden alcanzarlo.
  • Tablero secreto: los pines en un tablero secreto no son públicamente detectables, sin importar si es Acceso de prueba o Estándar.
// ¿Atascado?

La aprobación del Acceso estándar es la parte más lenta. Si llevas esperando más de 10 días hábiles, escribe a support@getartdrop.com con el nombre de tu app y le daremos seguimiento con Pinterest en tu nombre.

Referencia oficial: documentación de autenticación de Pinterest, referencia del token de OAuth.

// Otras plataformas
Instagram Facebook Threads Bluesky