Información general
La API Graph de Instagram es una colección de puntos de conexión de la API Graph de Facebook, que permite a las apps acceder a los datos de las cuentas profesionales de Instagram (tanto de creadores como de empresas). Si no conoces la API Graph de Facebook, lee nuestra documentación sobre la API Graph antes de continuar.
URL base
Es posible acceder a todos los puntos de conexión mediante el host graph.facebook.com.
Usuarios de la app
El acceso a las cuentas profesionales de Instagram se realiza indirectamente mediante cuentas de Facebook, por lo que los usuarios de tu app deben tener una cuenta de Facebook y usarla para iniciar sesión en tu app. Además, la cuenta de Facebook debe poder realizar tareas equivalentes a las de un administrador en una página de Facebook que se haya conectado a la cuenta de Instagram a la que se está intentando acceder.
Estos requisitos se aplican a todos los usuarios de la app, incluso a los que tienen un rol en tu app o un rol en una empresa que solicitó la app.
Autenticación
La autenticación de usuario de la app se realiza mediante tokens de acceso. El acceso a las cuentas profesionales de Instagram se realiza indirectamente mediante cuentas de Facebook, por lo que todas las solicitudes a la API deben incluir el token de acceso de usuario de Facebook del usuario de tu app. Para obtener los tokens de acceso de los usuarios de la app, implementa el inicio de sesión con Facebook. Ten en cuenta que el inicio de sesión con Facebook no admite credenciales de Instagram, por lo que los usuarios de la app deben iniciar sesión con una cuenta de Facebook.
Autorización
La autorización del punto de conexión se realiza mediante permisos y funciones. Antes de que la app pueda usar el punto de conexión para acceder a los datos de Instagram del usuario de la app, primero debes solicitar desde el usuario de la app todos los permisos que requieren dichos puntos de conexión. El usuario de la app debe otorgarle permisos a tu app. Una vez que se hayan otorgado, podrás enviar consultas a los puntos de conexión para acceder a los datos del usuario.
Ten en cuenta que un permiso solo permite acceder a los datos que creó el usuario que otorgó el permiso. Hay algunos puntos de conexión que permiten a las apps acceder a datos que no creó el usuario de la app, pero el acceso se limita a ciertos datos públicos.
Para solicitar a los usuarios de la app que otorguen los permisos, implementa el inicio de sesión con Facebook. Los usuarios de la app que tienen un rol en tu app pueden otorgar cualquier permiso que se haya solicitado. Los usuarios de la app que no tengan un rol en ella solo podrán otorgar permisos y funciones que se hayan aprobado por medio del proceso de revisión de apps.
La API usa los siguientes permisos y funciones:
Consulta nuestra referencia de puntos de conexión a fin de determinar qué permisos y funciones necesitará la app para enviar solicitudes a los usuarios de la app.
Mensajes de Instagram
Si planeas implementar mensajes de Instagram desde la plataforma de Messenger, tendrás que incluir el permiso instagram_manage_messages. Obtén más información sobre los mensajes de Instagram. 
Colaboradores
La función"Instagram Collabs" permite a los usuarios de Instagram ser coautores de contenido (es decir, publicar contenido multimedia) con otras cuentas (colaboradores).
Con algunas pocas excepciones, mediante la API, solo puede acceder a los datos del contenido multimedia de varias cuentas el usuario que publicó el contenido; los colaboradores no pueden acceder a ellos de esa manera. Las únicas excepciones son en la búsqueda de contenido multimedia con mejor rendimiento o recién publicado que se etiquetó con un hashtag específico. Consulta "Búsqueda de hashtags".
Páginas
Las cuentas profesionales de Instagram deben estar conectadas a una página de Facebook para que se pueda acceder a sus datos mediante la API. Una vez que estas se conectan, cualquier usuario de Facebook que pueda realizar tareas en esa página podrá otorgar un token de acceso a tu app, que, luego, se podrá usar en solicitudes a la API.
En nuestro artículo de ayuda Agregar una página de Facebook a una cuenta profesional de Instagram o cambiar la página conectada, se explica cómo conectar una página de Facebook a una cuenta profesional de Instagram.
Tareas
Para que un usuario de la app pueda otorgar permisos a tu app, dicho usuario debe poder realizar tareas en la página de Facebook que está conectada a la cuenta de Instagram a la que se quiere acceder. Los usuarios de la app podrán otorgarle permisos a tu app según las tareas que pueden realizar, de acuerdo con la siguiente tabla:
| Permiso | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
Puedes determinar qué tareas podrá hacer un usuario de la app en una página consultando el punto de conexión GET /me/accounts con el token de acceso del usuario de la app. El punto de conexión devolverá una lista de páginas en las que el usuario de la app puede realizar tareas, e indicará qué tareas podrá hacer en cada una de dichas páginas.
Consulta la documentación de referencia para ver qué permisos requiere cada punto de conexión. La API no admite usuarios del sistema del administrador comercial ni usuarios de la app con rol de colaborador de transmisiones.
Referencias a las tareas
Si necesitas informarles a los usuarios de la app sobre las tareas (y cuáles son las que se necesitan realizar para que la app funcione adecuadamente), te mostramos a continuación como nos referimos a ellas en nuestras varias UI.
Versión clásica para páginas
En las páginas clásicas, las tareas se conocen como roles. Los usuarios de la app con un rol de administrador en una página pueden otorgar cualquier permiso a tu app. Los usuarios de la app con otros roles pueden otorgar permisos de acuerdo con la siguiente tabla:
| Rol | Permisos que se pueden otorgar |
|---|---|
Editor | instagram_basic |
Moderador | instagram_basic |
Anunciante | instagram_basic |
Analista | instagram_basic |
Nueva experiencia para páginas
En la Nueva experiencia para páginas, hacemos referencia a las tareas con dos términos: "acceso a Facebook" o "acceso a tareas". Los usuarios de la app con acceso a Facebook en una página pueden otorgar cualquier permiso a tu app. Los usuarios de la app con acceso a tareas pueden otorgar permisos de acuerdo con la siguiente tabla:
| Acceso a tareas | Permisos que se pueden otorgar |
|---|---|
Anuncios | instagram_basic |
Contenido | instagram_basic |
Estadísticas | instagram_basic |
Mensajes y actividad de la comunidad | instagram_basic |
Para determinar si una página está usando la nueva experiencia, solicita su campo has_transitioned_to_new_page_experience. Este valor devuelve true si la página está usando la nueva experiencia.
Revisión de apps
Tu app debe completar la revisión de apps antes de que los usuarios de la app que no tienen un rol en tu app o un rol en la empresa que reclamó tu app puedan usarla. Si solo usuarios que tienen un rol en la app o un rol en la empresa que solicitó tu app usarán tu app, no tendrás que completar la revisión de apps.
No es necesario que la solicitud de revisión de apps incluya credenciales de un usuario de prueba de Facebook si implementaste el inicio de sesión con Facebook y tu app está disponible públicamente. Sin embargo, si nuestros revisores necesitan acceder a una cuenta que no sea de Facebook para activar tu implementación del inicio de sesión con Facebook, debes incluir las credenciales de la cuenta que no es de Facebook en tu solicitud.
Apps privadas
Si nuestros revisores no pueden probar tu app porque se encuentra detrás de una intranet privada, no tiene interfaz de usuario o no implementó el inicio de sesión con Facebook, solo podrás solicitar aprobación para estos permisos:
Verificación del negocio
Si usuarios que no tienen un rol en la app o un rol en la empresa que reclamó la app serán quienes usen tu app, deberás completar la verificación del negocio.
Limitación de frecuencia
Todos los puntos de conexión están sujetos a la limitación de la frecuencia para casos de uso de Instagram para empresas, salvo los puntos de conexión de descubrimiento empresarial y búsqueda de hashtags, que están sujetos a la limitación de frecuencia de la plataforma.
Webhooks
Puedes usar webhooks para recibir notificaciones siempre que alguien comenta en los objetos multimedia de los usuarios de tu app o cuando caduca alguna de sus historias. Consulta nuestra documentación sobre webhooks para aprender a usar los webhooks. Luego, configura uno para el tema Instagram y suscríbete a sus campos comments y story_insights.
Mensajes de Instagram
Se utilizan varios puntos de conexión de la API Graph de Instagram junto con los puntos de conexión de la plataforma de Messenger a fin de permitir a los usuarios de tu app interactuar con mensajes directos que reciben en sus cuentas profesionales de Instagram. Consulta la documentación sobre Mensajes de Instagram de la plataforma de Messenger para obtener información sobre cómo acceder a los mensajes en cuentas de empresa de Instagram.