Cos’è l’API di Facebook?
L’API di Facebook è un insieme di soluzioni utilizzate come principale metodo per ottenere e inviare dati sulla piattaforma. Consente a sviluppatori e utenti di app di accedere alle funzionalità di questa rete: informazioni utente, foto e video, messaggi e molto altro.
BONUS: Crea il tuo widget Facebook Feed in pochi minuti!
Come ottenere una chiave API di Facebook.
Se desideri ottenere l’accesso a una chiave API di Facebook, devi registrarti o accedere con il tuo account Facebook esistente sul portale per sviluppatori e verificare la tua identità. Bastano pochi semplici passaggi:
- Passaggio 1. Accedi o crea un account
Vai sul portale Facebook per sviluppatori e clicca su “Accedi”. Puoi accedere con il tuo account Facebook esistente o crearne uno nuovo
- Passaggio 2. Inizia
Una volta dentro il servizio, premi “Inizia” nell’angolo in alto a destra della pagina principale
- Passaggio 3. Verifica il tuo account
Per iniziare a lavorare con gli strumenti per sviluppatori, devi approvare il tuo account. Premi “Avanti” nel popup che appare
Puoi verificare il tuo account usando il numero di telefono o la carta di credito. Per farlo tramite numero di telefono, seleziona il tuo paese dal menu a tendina, inserisci il tuo numero con il prefisso internazionale e clicca su “Invia come SMS”. Inserisci il codice ricevuto nel campo e clicca su “Verifica”
- Passaggio 4. Crea la tua app
Successivamente il servizio ti offrirà di creare la tua prima app. Tutte le API e le statistiche delle app di Facebook vengono tracciate nella Dashboard degli sviluppatori, a cui non puoi accedere senza aver creato un’app.
- Passaggio 5. Aggiungi le app o genera token di accesso per le tue esigenze
Il modo più semplice e comodo per utilizzare le API di Facebook è aggiungere le app direttamente nella Dashboard. Basta scegliere quella che corrisponde alle tue esigenze.
Vai su Strumenti – Graph API Explorer per generare token di accesso per i vari tipi di API che desideri utilizzare nella tua app. Scegli l’app e il tipo di token che ti serve nei menu a tendina nella parte sinistra dello schermo. Poi clicca su “Genera token di accesso”. Dovrai approvare l’accesso dell’app alla tua pagina.
Esempi di utilizzo dell’API di Facebook
Il prodotto principale è la Graph API, che funge da base per tutti gli altri tipi di API di Facebook. In sostanza, sono tutte estensioni della Graph API, e tutti i prodotti Facebook interagiscono con essa in qualche modo.
Quali vantaggi puoi trarre dalla console per sviluppatori di Facebook e dai prodotti offerti? Ci sono molti modi per migliorare il tuo sito web o la tua app utilizzando i contenuti e alcune delle funzionalità di questa piattaforma social.
Puoi visualizzare diversi tipi di contenuti dei social media – post, immagini, video – sul tuo sito web o app per coinvolgere e intrattenere gli utenti.
Tieni presente che quando la Graph API viene implementata per essere utilizzata da altri utenti, anche loro dovranno prima approvare tramite un popup. Solo dopo che un utente ha autorizzato, l’applicazione riceverà un token di accesso da questo utente e potrà utilizzare le sue informazioni dal profilo Facebook.
Limiti dell’API di Facebook
Ricorda che ogni tipo di API ha sempre dei limiti. Le query Graph API effettuate con il token di accesso dell’app vengono conteggiate nel limite di frequenza di quell’applicazione. Il numero di chiamate di ogni app è la quantità di richieste che può effettuare in una finestra di un’ora e si calcola così:Chiamate in un’ora = 200 * Numero di utenti dell’app
Integrazione dell’API di Facebook
La piattaforma offre diverse soluzioni pronte per i non sviluppatori basate sulla sua Graph API. Tutte le app e le API di Facebook sono in sostanza un insieme o una raccolta di nodi della Graph API. Questo significa che devi comunque completare i passaggi 1-3 descritti sopra per creare un account e accedere alla dashboard. Di seguito descriviamo le applicazioni standard dell’API di Facebook più comunemente utilizzate.
Tipi di API per Facebook Feed
Facebook Page API
Questo tipo di API consente di accedere alle impostazioni, ai contenuti e alle metriche di una pagina. Ti permette di creare e visualizzare post, commenti di una pagina, contenuti di proprietà della pagina e altro ancora. I dettagli completi sono disponibili nella documentazione dell’API Pages. Non dimenticare che hai bisogno di un token da un utente dell’app che possiede o può eseguire un’attività richiesta sulla pagina.
Facebook Video API
Facebook offre due tipi: Video API e Live Video API. Entrambi pubblicano video su una pagina, gruppo o evento amministrato da un utente dell’app. La Video API è pensata per pubblicare video brevi e lunghi su una o più pagine e gruppi. La Live Video API, a sua volta, viene utilizzata per programmare una trasmissione in diretta, trasmettere un video su un profilo, gruppo o evento e interagire con il pubblico che guarda. Ovviamente hai bisogno di token di accesso per pagine, gruppi o eventi, o una combinazione di essi, a seconda di dove vuoi inserire il tuo video o la tua diretta.
Facebook API Events
Questo tipo di API è anch’esso una funzionalità della Graph API, ma è disponibile solo per i Facebook Marketing Partner. Richiede anche un token di accesso dall’amministratore dell’Evento o del Gruppo che ha creato questo Evento.
Facebook News Feed API
Hai due opzioni per accedere e utilizzare il news feed di Facebook. La Graph API descritta offre la possibilità di accedere a un feed separato degli aggiornamenti di stato e ottenere post e link pubblicati dall’utente o da altre persone sul profilo. Puoi leggere di più qui.
C’è anche la Public Feed API, che permette di visualizzare i contenuti contrassegnati come ‘Pubblici’ su un servizio o sito di terze parti. Ma questo tipo di chiave API viene concesso solo agli editori di media approvati, quindi devi prima fare richiesta.
Non hai bisogno dell’API per i gruppi di Facebook per visualizzare i loro contenuti sul tuo sito. Usa il widget Facebook Feed! Con esso hai il pieno controllo sui contenuti che desideri.
API per la community di Facebook
Facebook Comment API
L’accesso ai commenti su Facebook può essere ottenuto tramite la Graph API. Poiché i commenti possono essere lasciati sotto diversi tipi di contenuti, devi ottenere l’accesso a un oggetto per lavorare con i commenti su di esso.
Facebook Reviews API
Questa parte della Graph API rappresenta oggetti che contengono una raccomandazione. I campi predefiniti includono data, valutazione a stelle, testo della recensione, informazioni utente e badge ‘positivo’ o ‘negativo’.
Se desideri avere più controllo sulle recensioni visualizzate, puoi personalizzare il plugin Recensioni secondo le tue preferenze.
API per strumenti di Facebook
Facebook Login API
Un esempio di utilizzo dell’API di login di Facebook si può vedere su molti servizi web che richiedono la registrazione. Questo offre agli utenti un modo rapido e sicuro per accedere a un sito web o a un’app. Questa API raccoglie i token di accesso degli utenti per ottenere le loro informazioni di profilo, cosa possibile solo dopo l’approvazione dell’utente. Se vuoi utilizzare questo tipo di API devi far revisionare e approvare la tua app dall’amministrazione di Facebook.
Facebook Places API
Places Graph è una soluzione separata di Facebook disponibile solo per le piattaforme Android e iOS. Con essa la tua app può ottenere informazioni sulla posizione attuale degli utenti. Consente anche di cercare e scoprire luoghi, condividere la posizione e aggiungere tag geografici. Anche la Places API richiede di ottenere token di accesso dagli utenti. Per integrare e iniziare a lavorare con la Places API, devi prima ottenere l’SDK di Facebook per la tua app.
Facebook Payments API
L’API di pagamento include i dettagli di un pagamento effettuato in una determinata app. Questi pagamenti vengono creati nei pagamenti di Facebook e processati sulla base della piattaforma. Anche questo tipo di API richiede un token di accesso per un’app che crea un pagamento.
Facebook Messenger API
L’API Messenger è un’app che ti permette di organizzare un canale di conversazione sul tuo sito tramite Facebook Messenger. La soluzione Messenger API consente anche a uno sviluppatore di costruire conversazioni guidate con gli utenti. In questo modo il messenger può rispondere automaticamente a un utente utilizzando la Send API (chiamata anche Facebook Bot API), che invia webhook all’URL del server dove è ospitato il messenger.
Resta connesso con i tuoi clienti e il pubblico del sito con un pulsante Messenger gratuito e facile da installare!
Tipi di API per il marketing di Facebook
Facebook Ads API
L’API di marketing è un insieme di endpoint della Graph API che aiutano a ottimizzare la pubblicità su Facebook. L’API Ads di Facebook consente agli utenti di creare e gestire campagne pubblicitarie, set di annunci e singole unità pubblicitarie.
Facebook Marketplace API
Attualmente ci sono solo le categorie Veicoli e Immobili su Facebook Marketplace. Per accedere a questa sezione della piattaforma Facebook, devi creare un account sviluppatore e verificare la tua attività. Questa soluzione offre di utilizzare la Lead API insieme ai webhook per sviluppatori per una migliore performance. Per farlo devi creare la tua app come descritto in precedenza in questo articolo e inviarla per la revisione per ottenere l’approvazione da Facebook.
Facebook Analytics API
Questa soluzione aiuta a monitorare e ottimizzare il comportamento e il percorso dei tuoi clienti da mobile, web, bot, offline e altre risorse. Per implementarla devi integrare l’SDK di Facebook nella tua app o sito web. Puoi saperne di più nel Centro assistenza Analytics.
Facebook Business Manager API
Ultime modifiche all’API
Le modifiche all’API di Facebook includono cambiamenti versionati – quelli introdotti con il rilascio di una nuova versione dell’API. Ci sono anche modifiche non versionate che vengono introdotte al di fuori dei rilasci normali. Per aggiornare a una versione superiore dell’API di Facebook c’è uno speciale strumento di aggiornamento dell’API.
L’ultima versione è la v8.0 rilasciata ad agosto 2020. Ora include:
- tipi di app – Business, Gaming e None
- ottenimento dei Mi piace per i video in diretta
- Product Template in Messenger per i negozi per inviare prodotti come messaggi
La versione precedente v7.0 rilasciata a maggio 2020 sarà disponibile fino ad agosto 2022.
Stato e errori dell’API di Facebook
Lo stato attuale della piattaforma è sano dal 1° ottobre 2020. Ma le richieste effettuate a volte restituiscono varie risposte di errore dell’API di Facebook con i relativi codici di errore. Ad esempio, l’errore 400 dell’API di Facebook – Richiesta non valida – significa che una query non è più supportata e devi generare un nuovo token di accesso. Ecco alcuni altri:
| Codice | Nome |
| 102 | Sessione API |
| 1 | API Sconosciuta |
| 2 | Servizio API |
| 3 | Metodo API |
| 4 | Troppe chiamate API |
| 17 | Troppe chiamate API utente |
| 10 | Permesso API negato |
| 190 | Token di accesso scaduto |
| 200-299 | Permesso API (valori multipli a seconda del permesso) |
| 341 | Limite applicazione raggiunto |
| 368 | Blocco temporaneo per violazioni delle policy |
| 506 | Post duplicato |
| 1609005 | Errore pubblicazione link |
Documentazione dell’API di Facebook
La documentazione di tutti i tipi di API per sviluppatori di Facebook si trova nella sezione Docs del portale Facebook per sviluppatori. L’elenco completo dei nodi root della Graph API si trova nella sezione Facebook API Reference. Ogni documentazione API include un breve tutorial sui permessi richiesti e su come utilizzarla e implementarla. Puoi trovarlo nelle sezioni ‘Getting Started’ e ‘Guides’ di ogni specifica documentazione.
