// Integración social · 9 pasos · ~15 min

Configuración de Instagram

Consigue tu Token de acceso a la página y tu ID de cuenta comercial de Instagram. Calcula entre 15 y 20 minutos la primera vez. Una vez guardado en ArtDrop, el token es prácticamente permanente.

// Con qué terminarás
  • social_instagram_token, un Token de acceso a la página de larga duración (no caduca mientras sigas siendo administrador)
  • social_instagram_business_id, un ID de cuenta comercial de Instagram numérico como 17841400000000000
// Antes de empezar, confirma las tres cosas
  • Eres dueño de una página de Facebook (no solo un perfil personal) y eres administrador de ella.
  • Tu cuenta de Instagram es comercial o de creador, no personal. (El paso 1 cubre el cambio.)
  • La cuenta de Instagram está vinculada a la página de Facebook. (El paso 1 cubre el vínculo.)
  1. 1
    App de Instagram

    Cambia a una cuenta comercial o de creador y vincula tu página de Facebook

    Abre la app móvil de Instagram (la versión web no muestra estas opciones):

    1. Toca tu foto de perfil y luego el menú de hamburguesa (arriba a la derecha).
    2. Toca Configuración y actividad y luego Tipo de cuenta y herramientas.
    3. Toca Cambiar a cuenta profesional, elige una categoría y luego selecciona Empresa (Creador también funciona).
    4. De vuelta en Tipo de cuenta y herramientas, toca Compartir en otras apps, luego Facebook, y selecciona la página que quieres vincular.

    Las cuentas personales de Instagram no pueden publicar a través de la API. Si te saltas este paso, todos los demás pasos parecerán haber funcionado hasta el paso 8, donde instagram_business_account volverá vacío.

  2. 2
    Meta for Developers

    Crea una app de desarrollador en Meta

    1. Ve a developers.facebook.com e inicia sesión con la misma cuenta de Facebook que administra tu página.
    2. Arriba a la derecha, entra en Mis apps y luego en Crear app.
    3. Caso de uso: elige Otro y luego Siguiente.
    4. Tipo de app: elige Empresa y luego Siguiente. (La opción de consumidor no muestra el producto Instagram Graph.)
    5. Ponle un nombre a la app, algo como ArtDrop Personal, agrega un correo de contacto, elige o crea un portafolio empresarial y luego Crear app. Pasa la verificación de seguridad.
  3. 3
    Agregar productos

    Agrega el producto Instagram a la app

    1. En el panel de la app, en el menú de la izquierda, haz clic en Configuración de la app y luego en la fila + Agregar productos al final.
    2. Busca la tarjeta de Instagram y haz clic en Configurar.
    3. En la barra lateral de Instagram, abre Configuración de API con inicio de sesión de Facebook. Esta es la ruta que coincide con los permisos que ArtDrop necesita.
    4. En 1. Generar tokens de acceso, haz clic en Agregar cuenta, completa el inicio de sesión de Facebook y concede todos los permisos cuando se te pidan.
  4. 4
    Permisos

    Confirma los permisos requeridos

    Cuando aparezca la pantalla de consentimiento del inicio de sesión de Facebook, o en Revisión de la app, Permisos y funciones, estos cinco deben estar presentes:

    • instagram_basic
    • instagram_content_publish
    • pages_show_list
    • pages_read_engagement
    • pages_manage_posts

    Sobre la revisión de la app: no necesitas enviar nada para una configuración de un solo usuario. Mientras la app esté en modo de desarrollo, cualquiera que aparezca en Roles de la app, Roles (administrador, desarrollador o tester) puede usar cada permiso por completo. Ya tienes el rol de administrador porque tú creaste la app. Sáltate la revisión de la app por completo.

  5. 5
    Graph API Explorer

    Genera un token de acceso de usuario de corta duración

    1. Abre developers.facebook.com/tools/explorer.
    2. Arriba a la derecha, en el menú desplegable Meta App: elige la app que acabas de crear.
    3. En el menú desplegable Usuario o página: selecciona Token de usuario.
    4. Haz clic en Agregar un permiso y marca cada uno de los cinco permisos del paso 4.
    5. Haz clic en Generar token de acceso. Inicia sesión en la ventana emergente, elige Continuar como [tú] y concede acceso a la página que quieres usar.
    6. Copia el token que aparece en el campo del token. Es válido durante aproximadamente 1 hora, así que completa los pasos del 6 al 8 de una sola vez.
  6. 6
    Intercambio de token

    Cambia el token de corta duración por uno de larga duración (60 días)

    En la barra de direcciones del Explorer, o con curl, llama al endpoint de intercambio de token. Necesitas tu App ID y tu App Secret: los encuentras en Configuración de la app, Básica en el panel (haz clic en Mostrar junto al secreto).

    GET https://graph.facebook.com/v21.0/oauth/access_token
        ?grant_type=fb_exchange_token
        &client_id={APP_ID}
        &client_secret={APP_SECRET}
        &fb_exchange_token={SHORT_USER_TOKEN}

    La respuesta tiene un access_token válido durante aproximadamente 60 días.

  7. 7
    Token de página

    Obtén el Token de acceso a la página que nunca caduca

    Llama a /me/accounts con el token de usuario de larga duración del paso 6:

    GET https://graph.facebook.com/v21.0/me/accounts
        ?access_token={LONG_LIVED_USER_TOKEN}

    Recibes un arreglo de páginas. Encuentra la página vinculada a tu cuenta de Instagram y copia dos campos:

    • id, este es el ID de la página. Lo necesitarás en el paso 8.
    • access_token, este es el Token de acceso a la página. Pégalo en el campo Token de acceso a la página de ArtDrop para Instagram.

    Los tokens de página derivados de un token de usuario de larga duración no caducan, siempre y cuando sigas siendo administrador de la página y no cambies tu contraseña de Facebook. Si cualquiera de esas cosas cambia, repite los pasos del 5 al 7 para generar uno nuevo.

  8. 8
    Encuentra tu ID de IG

    Busca tu ID de cuenta comercial de Instagram

    Usa el ID de la página y el Token de acceso a la página del paso 7:

    GET https://graph.facebook.com/v21.0/{PAGE_ID}
        ?fields=instagram_business_account
        &access_token={PAGE_ACCESS_TOKEN}

    La respuesta se ve así:

    { "instagram_business_account": { "id": "17841400000000000" } }

    Copia el id numérico. Ese es tu ID de cuenta comercial de Instagram, pégalo en ArtDrop.

    Si instagram_business_account falta o es nulo, el paso 1 no se completó. Vuelve a la app de Instagram, Tipo de cuenta y herramientas, Compartir en otras apps, Facebook, y asegúrate de que la página esté seleccionada.

  9. 9
    Pega y guarda

    Pega ambos valores en ArtDrop

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

    • Token de acceso a la página: el token de página que nunca caduca del paso 7.
    • ID de cuenta comercial: el ID numérico del paso 8.

    Pulsa Guardar. ArtDrop ejecuta al instante una prueba de ida y vuelta contra /me?fields=id, así que sabrás en un segundo si algo está mal.

// Problemas comunes
  • "Instagram business account not found", la cuenta de IG sigue siendo personal, o la página no está vinculada. Rehaz el paso 1 dentro de la app móvil.
  • El token muere después de 1 hora, te detuviste en el paso 5 y nunca hiciste el intercambio de larga duración. Repite los pasos del 5 al 7.
  • 100 publicaciones cada 24 horas es el límite de frecuencia de publicación de IG. ArtDrop se organiza para respetarlo, pero las cargas masivas por encima de ese tope se detendrán.
  • Autorización de publicación de la página (PPA): algunas páginas te piden completar la PPA antes de que la publicación funcione. Si ves un error de PPA required, abre la configuración de la página en Facebook y completa el aviso.
  • Cambiar la contraseña invalida todos los tokens derivados. Cuenta con tener que regenerarlos después de cualquier restablecimiento de contraseña de Facebook.
// ¿Atascado?

Nueve pasos son muchos. Si algo no coincide con lo que ves, es probable que Meta haya vuelto a mover un botón. Escríbenos a support@getartdrop.com con una captura de pantalla y te guiaremos, o iniciamos sesión por ti si compartes un rol de administrador temporal.

Referencia oficial: Instagram Platform Overview, Content Publishing.