Información general
La API Graph de Instagram es una colección de extremos de la API Graph de Facebook que permite a las aplicaciones acceder a los datos de cuentas profesionales de Instagram (tanto empresariales como de creador). Si no tienes experiencia con la API Graph de Facebook, lee nuestra documentación sobre la API Graph antes de continuar.
URL base
Se puede acceder a todos los extremos desde el host graph.facebook.com.
Usuarios de la aplicación
Se accede a las cuentas profesionales de Instagram indirectamente desde cuentas de Facebook, de modo que los usuarios de la aplicación deben tener una cuenta de Facebook y utilizarla para iniciar sesión en la aplicación. Además, la cuenta de Facebook debe poder realizar tareas de administración equivalentes en una página de Facebook conectada a la cuenta de Instagram a la que se intenta acceder.
Estos requisitos se aplican a todos los usuarios de la aplicación, incluso los que tienen un rol en la aplicación o en una empresa que la ha reclamado.
Autenticación
La autenticación de los usuarios de la aplicación se gestiona mediante identificadores de acceso. Se accede a las cuentas profesionales de Instagram indirectamente desde cuentas de Facebook, de modo que todas las solicitudes de la API deben incluir el identificador de acceso de usuario de Facebook de los usuarios de la aplicación. Para obtener los identificadores de los usuarios de la aplicación, implementa el inicio de sesión con Facebook. Ten en cuenta que el inicio de sesión con Facebook no admite las credenciales de Instagram, de modo que los usuarios de la aplicación deben iniciar sesión con una cuenta de Facebook.
Autorización
La autorización de los extremos se gestiona mediante permisos y funciones. Para que la aplicación pueda utilizar un extremo para acceder a los datos de Instagram del usuario de la aplicación, primero debes solicitar todos los permisos que requieren los extremos al usuario de la aplicación. A continuación, el usuario de la aplicación debe conceder los permisos a la aplicación. Una vez concedidos, puedes consultar los extremos para acceder a los datos del usuario.
Ten en cuenta que un permiso solo permite acceder a datos creados por el usuario que otorgó dicho permiso. Algunos extremos permiten a las aplicaciones acceder a datos que no ha creado el usuario de la aplicación, pero los datos accesibles son limitados y públicos.
Para solicitar permisos a los usuarios de una aplicación, implementa el inicio de sesión con Facebook. Los usuarios de la aplicación que tienen un rol en esta pueden otorgar cualquier permiso que se solicite. Los usuarios de la aplicación que no tengan ningún rol en esta solo pueden conceder permisos y funciones que se hayan aprobado mediante el proceso de revisión de la aplicación.
La API utiliza los siguientes permisos y funciones:
Consulta nuestra referencia de extremos para determinar los permisos y funciones que la aplicación deberá solicitar a los usuarios de la aplicación.
Mensajes de Instagram
Si tienes pensado implementar los 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 de colaboraciones de Instagram permite a los usuarios de la aplicación de Instagram crear contenido (es decir, publicar archivos multimedia) con otras cuentas (colaboradores).
Aunque hay algunas excepciones, el usuario que publicó el contenido multimedia con varios autores es el único que puede usar la API para acceder a los datos de dicho contenido o sobre él; los colaboradores no pueden acceder a estos datos mediante la API. Las únicas excepciones son al buscar el contenido multimedia con mayor rendimiento o el contenido multimedia publicado recientemente que se ha etiquetado con un hashtag concreto. Consulta Búsqueda de hashtags.
Páginas
Las cuentas profesionales de Instagram se deben conectar a una página de Facebook para que sus datos sean accesibles desde la API. Una vez conectada, cualquier usuario de Facebook que pueda realizar tareas en la página puede otorgar a la aplicación un identificador de acceso que, a continuación, se puede utilizar en las solicitudes de la API.
En nuestro artículo de ayuda Añadir o cambiar la página de Facebook vinculada a tu cuenta empresarial de Instagram se explica cómo conectar una página de Facebook a una cuenta profesional de Instagram.
Tareas
Para que un usuario de la aplicación pueda conceder permisos a la aplicación, este debe poder realizar tareas en la página de Facebook conectada a la cuenta de Instagram a la que intenta acceder. Los usuarios de la aplicación pueden conceder permisos a la aplicación en función de las tareas que pueden realizar, como se indica a continuación:
| Permiso | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
Para determinar qué tareas puede realizar un usuario de la aplicación en una página, consulta el extremo GET /me/accounts con el identificador de acceso del usuario de la aplicación. El extremo devolverá una lista de páginas en que el usuario de la aplicación puede realizar tareas e indicará qué tareas puede realizar en cada una de ellas.
Consulta la documentación de referencia para ver qué permisos requiere cada extremo. La API no admite usuarios del sistema de Business Manager ni usuarios de la aplicación con el rol de colaborador de la transmisión.
Referencia a tareas
Si necesitas informar a los usuarios de la aplicación acerca de las tareas (y cuáles son necesarias para poder utilizar correctamente la aplicación), consulta cómo se hace referencia a estas en nuestras distintas IU.
Páginas clásicas
Las páginas clásicas hacen referencia a las tareas como roles. Los usuarios de la aplicación con un rol de administrador en una página pueden conceder cualquier permiso a la aplicación. Los usuarios de la aplicación con otros roles pueden conceder permisos según se indica a continuación:
| Rol | Permisos que se pueden conceder |
|---|---|
Editor | instagram_basic |
Moderador | instagram_basic |
Anunciante | instagram_basic |
Analista | instagram_basic |
Nueva experiencia para páginas
La nueva experiencia para páginas hace referencia a las tareas con el acceso de Facebook o el acceso a tareas. Los usuarios de la aplicación con acceso de Facebook a una página pueden conceder cualquier permiso a la aplicación. Los usuarios de la aplicación con acceso a tareas pueden conceder permisos según se indica a continuación:
| Acceso a tareas | Permisos que se pueden conceder |
|---|---|
Anuncios | instagram_basic |
Contenido | instagram_basic |
Insights | instagram_basic |
Mensajes y actividad de la comunidad | instagram_basic |
Para determinar si una página utiliza la nueva experiencia, debes solicitar su campo has_transitioned_to_new_page_experience. Si la página la utiliza, este valor devuelve true.
Revisión de la aplicación
La aplicación debe completar la revisión de la aplicación para que la puedan utilizar los usuarios que no tienen ningún rol en ella ni ningún rol en una empresa que la haya reclamado. Si solo utilizarán la aplicación los usuarios que tengan un rol en la aplicación o empresa, no es necesario completar la revisión de la aplicación.
No es necesario que el envío para la revisión de la aplicación incluya credenciales de usuario de prueba de Facebook si has implementado el inicio de sesión con Facebook y la aplicación está disponible públicamente. Sin embargo, si nuestros revisores necesitan iniciar sesión en una cuenta que no sea de Facebook para activar la implementación del inicio de sesión con Facebook, debes incluir las credenciales de la cuenta que no es de Facebook en el envío.
Aplicaciones privadas
Si nuestros revisores no pueden probar la aplicación porque está detrás de una intranet privada, no tiene interfaz de usuario o no ha implementado el inicio de sesión con Facebook, solo podrás solicitar la aprobación de estos permisos:
Verificación del negocio
Si utilizarán la aplicación usuarios que no tienen ningún rol en esta o en la empresa que la ha reclamado, debes completar la verificación del negocio.
Limitación de frecuencia
Todos los extremos están sujetos a la limitación de frecuencia del caso de uso empresarial de Instagram, excepto los extremos de detección de empresas y búsqueda de hashtags, que están sujetos a la limitación de frecuencia de la plataforma.
Webhooks
Puedes utilizar Webhooks para recibir notificaciones cuando alguien haga algún comentario sobre los objetos de contenido multimedia de los usuarios de la aplicación o cuando caduque alguna de sus historias. Consulta nuestra documentación sobre webhooks para obtener información sobre cómo utilizar Webhooks. A continuación, configura un webhook para el tema Instagram y suscríbete a sus campos comments y story_insights.
Mensajes de Instagram
Varios extremos de la API Graph de Instagram se utilizan con los extremos de la plataforma de Messenger para permitir a los usuarios de la aplicación interactuar con mensajes directos enviados a sus cuentas profesionales de Instagram. Consulta la documentación Mensajes de Instagram de la plataforma de Messenger para obtener información sobre cómo acceder a los mensajes en cuentas empresariales de Instagram.