Autenticazione di app business

Le app business, disponibili sulle piattaforme Facebook, sono il luogo in cui le piccole aziende possono andare a scoprire e connettersi ad app business di terze parti per configurare facilmente strumenti aziendali con un basso costo in termini di tecnologia al fine di crescere e raggiungere i propri obiettivi di business.

A differenza di Business Login, considerato che il flusso delle app business viene avviato dalle nostre piattaforme, esiste un passaggio aggiuntivo che richiede all'utente di accedere alla tua piattaforma tramite un browser popup in cui autenticarsi e selezionare la propria azienda per connettersi (identificata da un external_business_id definito da te). Una volta completata correttamente l'autenticazione, l'utente verrà reindirizzato al flusso per completare l'onboarding.

Se desideri che la tua app venga visualizzata sulla nostra piattaforma delle app business, devi creare un URL di autenticazione, un endpoint Webhook e farli configurare e convalidare tramite il pannello per sviluppatori.

Tutte le app devono essere inviate per l'Analisi di integrazione; una volta ottenuta l'approvazione dell'integrazione dell'estensione Facebook Business, l'app sarà disponibile per gli utenti pubblici.

Implementazione dell'URL di autenticazione

Le app business lanciano un flusso analogo a Business Login da una Pagina Facebook, da Instagram e da Facebook Business Suite. Per abilitare questo flusso e includere la tua app, devi fornire un'interfaccia utente di autenticazione personalizzata che consenta all'utente di selezionare la propria azienda sul tuo sito e poi reindirizzarla al flusso Facebook, Instagram o Facebook Business Suite.

Come funziona

1. Fornisci un endpoint URL personalizzato (URL di autenticazione) che carichi il flusso di autenticazione della tua piattaforma.
• Il tuo URL di autenticazione deve portare l'utente (titolare di azienda) a un flusso di accesso sulla tua piattaforma.
• Fornisci un'opzione per registrare un nuovo account sulla tua piattaforma (ad es. "iscriviti"). Dopo la registrazione, l'utente dovrebbe essere reindirizzato a Facebook per completare il collegamento del proprio account.
• Se supporti più aziende per account nella tua piattaforma, l'URL di autenticazione dopo un accesso eseguito correttamente dovrebbe visualizzare un'interfaccia utente per consentire all'utente di selezionare l'azienda sulla tua piattaforma che desidera associare alle proprie risorse Facebook.
Esempio: URL di autenticazione

https://yourwebsite.com/fbe-auth

2. Facebook carica l'URL di autenticazione fornito durante il flusso di registrazione e aggiunge alla fine un parametro di query redirect_uri (si tratta di un URI di reindirizzamento che potrebbe includere altri parametri di query):

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   Esempio: un URI di reindirizzamento codificato che potrebbe essere aggiunto al parametro di query redirect_uri:

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   Alla fine di questo passaggio, Facebook carica il tuo URL di autenticazione con il parametro di query redirect_uri aggiunto codificato che potrebbe assomigliare a questo:

   https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

   Nota importante: per assicurarti di non condividere alcun dato utente con altre parti, reindirizza al redirect_uri solo se corrisponde alla seguente espressione regolare:

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. Dopo che l'utente ha effettuato l'accesso/l'iscrizione e ha selezionato un'azienda sulla tua piattaforma (se applicabile), reindirizzalo all'URL da redirect_uri dopo avervi aggiunto un oggetto extras codificato come parametro di query (come per Business Login) con business_config e setup definiti al suo interno (a seconda delle configurazioni di registrazione che vuoi implementare):

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

Autenticazione iframe

Per consentire un'esperienza utente più semplice all'interno delle app business e supportare meglio la creazione di nuovi account sulla tua piattaforma, devi abilitare il tuo URL di autenticazione in modo che venga caricato in un iframe su una piattaforma Facebook. Consulta le linee guida sull'implementazione e le specifiche post-messaggio nella documentazione sugli iframe.

Implementazione webhook

I Webhooks ti consentono di ricevere notifiche HTTP in tempo reale di modifiche a oggetti specifici nel Social Graph di Facebook. Per l'estensione Facebook Business ciò significa che dopo che un utente installa o disinstalla l'estensione utilizzando la tua app (ad es. tramite app business), riceverai i dettagli per quell'azione tramite Webhooks.

Dovresti creare un endpoint su un server sicuro in grado di elaborare le richieste da Facebook. Ciò è richiesto per tutti i partner della piattaforma che desiderano che la propria app sia disponibile nelle app business. Consulta la Guida all'implementazione dei webhook per dettagli su come creare questo endpoint.

Configurazione e convalida dei webhook

Una volta pronto l'endpoint Webhook, per configurarlo e convalidarlo devi procedere come segue:

1. Usa la scheda Webhook nella sezione Facebook Business -> Configurazione della Dashboard gestione app per convalidare l'endpoint ed effettuare l'iscrizione al webhook fbe_install. Consulta la guida all'implementazione dei webhook per maggiori dettagli.
2. Una volta configurato correttamente il prodotto Webhooks, il cerchio in alto a destra della scheda dovrebbe diventare verde e mostrare un segno di spunta.

Configurazione e convalida tramite il Pannello sviluppatori

Il Facebook Business Extension Developer Panel è un prodotto della Dashboard gestione app per sviluppatori. Una volta che alle tue app è stata concessa la funzionalità estensione Facebook Business, dovresti utilizzare il pannello sviluppatori per configurare e convalidare l'URL di autenticazione, l'endpoint Webhooks e per aggiungere dettagli su ciò che la tua applicazione offre a un'azienda.

Configurazione e convalida dell'URL di autenticazione

Una volta che l'URL di autenticazione è pronto, per la sua configurazione e convalida procedi in questo modo:

1. Vai al Pannello sviluppatori dell'estensione Facebook Business nella Dashboard gestione app. Nota: se non lo hai configurato, segui queste istruzioni per aggiungerlo.
2. Clicca sulla tab Configurazione e cerca la scheda Piattaforma App business.
3. Seleziona la casella di controllo Visualizza la mia app sulla piattaforma App business.
4. Nell'input URL di autenticazione, inserisci il tuo URL di autenticazione.
5. Clicca sul pulsante Verifica autenticazione.
• Si apre una finestra pop-up e il tuo URL viene caricato per imitare il modo in cui Facebook lo utilizzerà sulle piattaforme delle app business.
• Procedi con l'accesso e la selezione dell'azienda (se applicabile).
• Dopo il reindirizzamento, la finestra pop-up si chiude. Se sono presenti errori nella tua implementazione (ad es. valori non validi sugli extras), verranno visualizzati nella parte inferiore di questa scheda in modo che tu sappia cosa correggere. La funzione Verifica autenticazione convaliderà solo l'input su redirect_uri e non installerà l'estensione Facebook Business.
6. Una volta che i passaggi di implementazione e la configurazione degli extras sono stati implementati come previsto, questo passaggio verrà contrassegnato come valido (segno di spunta verde nell'angolo in alto a destra della scheda). Ciò consentirà di testare end-to-end questo flusso di registrazione (installazione dell'estensione Facebook Business) direttamente da Facebook (consulta la sezione seguente).

Test end-to-end

Una volta che il tuo URL di autenticazione e l'endpoint Webhook sono stati configurati e convalidati correttamente sul Pannello sviluppatori, puoi effettuare test end-to-end del flusso di registrazione, basato sulla tua app, prima di pubblicarlo. Questa operazione può essere eseguita direttamente da Facebook Business Suite o dalla piattaforma della Pagina Facebook nel modo seguente:

Tramite Facebook Business Suite

1. Accedi a Facebook Business Suite.
2. Sulla sinistra, clicca su Altri strumenti e quindi su App business.
3. Qui sono elencate tutte le app disponibili. La tua sarà elencata nella categoria selezionata come Verticale/i nella tab Configurazione pannello sviluppatori.
4. All'app sarà associata l'etichetta Solo test - Non pubblica. Ciò significa che è disponibile per il test solo per gli utenti che hanno un ruolo nella tua app, non ancora per gli utenti pubblici.
5. Clicca su Connetti e inizia a testare l'esperienza fornita dal tuo URL di autenticazione:
   • Il flusso di registrazione esegue installazioni reali dell'estensione Facebook Business e attiva le notifiche webhook.

Tramite la Pagina Facebook

1. Vai alla Pagina Facebook per la quale hai accesso come amministratore.
2. Sulla sinistra della Pagina Facebook, clicca su App business.
3. Qui sono elencate tutte le app disponibili. La tua sarà elencata nella categoria selezionata come Verticale/i nella tab Configurazione pannello sviluppatori.
4. All'app sarà associata l'etichetta Solo test - Non pubblica. Ciò significa che è disponibile per il test solo per gli utenti che hanno un ruolo nella tua app, non ancora per gli utenti pubblici.
5. Clicca su Connetti e inizia a testare l'esperienza fornita dal tuo URL di autenticazione:
   • Il flusso di registrazione esegue installazioni reali dell'estensione Facebook Business e attiva le notifiche webhook.

Per saperne di più

• Cosa usare Business Login per l'estensione Facebook Business
• extras
• business_config
• setup
• Come disinstallare l'estensione Facebook Business