Panoramica

L'API Instagram con Facebook Login è una raccolta di endpoint dell'API Graph di Facebook che consente alle app di accedere ai dati negli account Instagram per professionisti (sia business sia creator). Se non hai familiarità con l'API Graph di Facebook, leggi la nostra documentazione sull'API Graph prima di procedere.

URL di base

È possibile accedere a tutti gli endpoint tramite l'host graph.facebook.com.

Utenti dell'app

Gli account Instagram Professional sono accessibili indirettamente tramite gli account Facebook, quindi gli utenti dell'app devono disporre di un account Facebook e utilizzarlo per accedere all'app. L'account Facebook deve inoltre essere abilitato a eseguire attività equivalenti a quelle di un amministratore su una Pagina Facebook che è stata collegata all'account Instagram a cui tenta di accedere.

Questi requisiti si applicano a tutti gli utenti dell'app, anche a quelli che hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app.

Autenticazione

L'autenticazione dell'utente dell'app viene gestita tramite i token d'accesso. Gli account Instagram per professionisti sono accessibili indirettamente tramite gli account Facebook, quindi tutte le richieste all'API devono includere il token d'accesso utente di Facebook degli utenti dell'app. Puoi ottenere i token dagli utenti dell'app implementando Facebook Login. Facebook Login non supporta le credenziali di Instagram, quindi gli utenti dell'app devono accedere utilizzando un account Facebook.

Autorizzazione

Per ogni endpoint sono necessarie specifiche autorizzazioni e funzioni. Prima che l'app possa utilizzare un endpoint per accedere ai dati Instagram di un utente, devi richiedere all'utente tutte le autorizzazioni necessarie e ottenere le relative approvazioni. A questo punto, puoi effettuare una query sugli endpoint per accedere ai dati dell'utente.

Un'autorizzazione consente solo di accedere ai dati creati dall'utente che l'ha concessa. Sono disponibili alcuni endpoint che consentono alle app di accedere a dati non creati dall'utente dell'app, ma i dati accessibili sono limitati e pubblici.

Puoi richiedere le autorizzazioni agli utenti dell'app implementando Facebook Login. Gli utenti che hanno un ruolo nell'app possono concedere qualsiasi autorizzazione richiesta. Gli utenti che non hanno un ruolo nell'app possono concedere solo autorizzazioni e funzioni che sono state approvate tramite la procedura di analisi dell'app.

L'API utilizza le seguenti autorizzazioni e funzioni:

Consulta il riferimento per gli endpoint per determinare quali autorizzazioni e funzioni deve richiedere l'app agli utenti.

Messaggi di Instagram

Se prevedi di implementare Messaggi di Instagram dalla Piattaforma Messenger, dovrai includere l'autorizzazione instagram_manage_messages. Ulteriori informazioni sulla messaggistica di Instagram.

Collaboratori

La funzione Collaborazione di Instagram consente agli utenti dell'app di Instagram di essere coautori del contenuto (ovvero di pubblicare contenuto multimediale) insieme ad altri account (collaboratori).

A parte poche eccezioni, i dati relativi ai contenuti multimediali con coautori sono accessibili tramite API solo all'utente che ha pubblicato tali contenuti multimediali; i collaboratori non sono in grado di accedere a questi dati tramite l'API. Le sole eccezioni sono in caso di ricerca per contenuto multimediale più popolare o pubblicato di recente che è stato taggato con un hashtag specifico. Consulta Ricerca degli hashtag.

Pagine

Gli account Instagram per professionisti devono essere collegati a una Pagina Facebook prima che sia possibile accedere ai loro dati tramite l'API. Dopo aver eseguito la connessione, qualsiasi utente Facebook che può eseguire attività sulla Pagina potrà concedere all'app un token d'accesso da utilizzare nelle richieste API.

Il nostro articolo dell'assistenza Aggiunta o modifica della Pagina Facebook collegata al tuo account Instagram per professionisti spiega come connettere una Pagina Facebook a un account Instagram per professionisti.

Attività

Per poter concedere le autorizzazioni, un utente dell'app deve poter eseguire attività sulla Pagina Facebook collegata all'account Instagram a cui tenta di accedere. Le autorizzazioni possono essere concesse dagli utenti dell'app in base alle attività che sono autorizzati a eseguire:

AutorizzazioneMANAGECREATE_CONTENTMODERATEADVERTISEANALYZE

instagram_basic

instagram_content_publish

instagram_manage_comments

instagram_manage_insights

Puoi determinare quali attività possono essere eseguite da un utente dell'app su una Pagina interrogando l'endpoint GET /me/accounts con il token d'accesso dell'utente dell'utente dell'app. L'endpoint restituisce una lista di Pagine su cui l'utente può eseguire attività e indica quali può eseguire su ciascuna Pagina.

Consulta la documentazione di riferimento per vedere le autorizzazioni necessarie per ogni endpoint. L'API non supporta gli utenti dell'app che hanno il ruolo di collaboratore per i video in diretta.

Riferimento alle attività

Se devi informare gli utenti sulle attività (e su quali sono necessarie per utilizzare correttamente l'app), di seguito è indicato come vengono indicate le attività nelle varie interfacce utente.

Pagine classiche

Nelle Pagine classiche ci si riferisce alle attività con il termine ruoli. Gli utenti dell'app con un ruolo di amministratore su una Pagina possono concedere all'app qualsiasi autorizzazione. Gli utenti dell'app con altri ruoli possono concedere le autorizzazioni nel modo seguente:

RuoloAutorizzazioni che possono essere concesse

Editore

instagram_basic
instagram_content_publish

Moderatore

instagram_basic
instagram_manage_comments
instagram_manage_insights

Inserzionista

instagram_basic
instagram_manage_insights

Analista

instagram_basic
instagram_manage_insights

Nuova esperienza delle Pagine

Con Nuova esperienza sulle Pagine ci si riferisce ad attività come Accesso a Facebook o Accesso alle attività. Gli utenti dell'app con un Accesso a Facebook su una Pagina possono concedere all'app qualsiasi autorizzazione. Gli utenti dell'app con Accesso alle attività possono concedere le autorizzazioni nel modo seguente:

Accesso alle attivitàAutorizzazioni che possono essere concesse

Inserzioni

instagram_basic

Contenuti

instagram_basic
instagram_content_publish

Insight

instagram_basic
instagram_manage_insights

Messaggi e attività della community

instagram_basic
instagram_manage_comments

Per determinare se una Pagina sta usando la nuova esperienza, richiedi il campo has_transitioned_to_new_page_experience. Se il valore restituito è true, la Pagina usa la nuova esperienza.

Analisi dell'app

La tua app deve completare l'analisi dell'app prima di poter essere utilizzata dagli utenti dell'app che non hanno un ruolo al suo interno o un ruolo in un Business Manager che ha reclamato l'app. Se la tua app verrà utilizzata solo dagli utenti che hanno un ruolo al suo interno o in Business Manager, non è necessario completare l'analisi dell'app.

La richiesta di analisi dell'app non deve includere alcuna credenziale di utente test Facebook se hai implementato Facebook Login e l'app è disponibile pubblicamente. Tuttavia, se le persone addette al controllo devono accedere a un account non Facebook per attivare l'implementazione di Facebook Login, devi includere nella richiesta le credenziali di tale account.

App private

Se le persone addette al controllo non riescono a testare l'app perché risiede dietro una intranet privata, non ha un'interfaccia utente o Facebook Login non è implementato, puoi richiedere l'approvazione solo per queste autorizzazioni:

Verifica dell'azienda

Devi completare la Verifica dell'azienda se la tua app verrà utilizzata da utenti dell'app che non hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app.

Rate limiting

Tutti gli endpoint sono soggetti a rate limiting per casi d'uso Instagram Business ad eccezione degli endpoint Aziende suggerite e Ricerca degli hashtag, che sono soggetti al rate limiting della piattaforma.

Webhook

Puoi usare i webhook per ricevere notifiche quando qualcuno commenta gli elementi multimediali della tua app o quando le Storie scadono. Consulta la nostra documentazione sui webhook per scoprire come usare i webhook, configurare un webhook per l'argomento Instagram e attivare l'iscrizione ai campi comments e story_insights.

Messaggi di Instagram

Diverse API Instagram con gli endpoint di Facebook Login vengono usate insieme agli endpoint della Piattaforma Messenger per consentire agli utenti della tua app di interagire con i messaggi diretti inviati ai loro account Instagram per professionisti. Consulta la documentazione Messaggi di Instagram della Piattaforma Messenger per scoprire come accedere ai messaggi negli account business di Instagram.