Configurazione delle funzioni aziendali

Scopri le opzioni disponibili per abilitare e configurare le funzioni aziendali per l'estensione Facebook Business.

Opzioni di configurazione

Per abilitare e configurare le funzioni aziendali per l'utente, usa una di queste opzioni disponibili:

OpzioneDescrizioneConsiglio

Configurazione delle funzioni tramite Business Login

Passata a Business Login per abilitare e disabilitare le funzioni dell'estensione Facebook Business (FBE).

Abilita questa opzione di funzione per i partner tramite il panel per sviluppatori dell'estensione Facebook Business. Quando viene utilizzata questa funzione, i partner devono informare gli utenti che queste funzioni vengono abilitate automaticamente per loro.

Consigliata se si dispone di un set predefinito di funzioni da configurare per l'utente.

Vista di gestione delle funzioni

Interfaccia utente self-service di Facebook per consentire all'utente di abilitare e disabilitare le funzioni dell'estensione Facebook Business.

Consigliata se non desideri creare un'interfaccia utente e utilizzare il self-service dell'interfaccia utente di Facebook, né le relative funzioni di Facebook e Instagram.

API Feature Configuration

Crea una vista di gestione delle funzioni personalizzata per abilitare e disabilitare le funzioni dell'estensione Facebook Business.

Consigliata per creare una vista di gestione delle funzioni personalizzata che corrisponda all'aspetto della vista dell'utente.

Funzioni supportate

L'estensione Facebook Business offre molte funzioni che puoi abilitare per le tue aziende.

Le seguenti funzioni sono raggruppate in base al settore a cui meglio si adattano:

Funzioni standard

FunzioneParametroDescrizione

Call to action della Pagina Facebook

page_cta(s)

Tipo: FBEPageCtaConfigData

Pulsante di call to action (CTA) sulla Pagina Facebook dell'azienda.

Call to action di Instagram

ig_cta(s)

Tipo: FBEIGCtaConfigData

Pulsante di call to action (CTA) sul profilo Instagram dell'azienda.

Call to action di Messenger

messenger_menu

Tipo: FBEMessengerMenuConfigData

Pulsante di call to action (CTA) su Messenger quando un utente invia messaggi all'azienda.

Chat di Messenger

messenger_chat

Tipo: FBEMessengerChatConfigData

Consente l'integrazione di Messenger direttamente sul tuo sito web, permettendo ai clienti di interagire con la tua azienda in qualsiasi momento.

Funzioni specifiche per gli APPUNTAMENTI

FunzioneParametroDescrizione

Scheda della Pagina con servizi in evidenza

page_card

Tipo: FBEPageCardConfigData

Richiede il Catalogo.

Scheda con i servizi in evidenza dell'azienda sulla relativa Pagina Facebook.

Invio della disponibilità tramite Messenger con lo scopo di avviare una conversazione

thread_intent

Tipo: FBEThreadIntentConfigData

Suggerimento di Messenger per gli amministratori strumenti business per poter inviare facilmente la propria disponibilità per un appuntamento a un utente in chat.

Nessuna implementazione aggiuntiva richiesta

FunzioneParametroDescrizione

Call to action della Pagina Facebook

page_cta

Tipo: FBEPageCtaConfigData

Pulsante di call to action (CTA) sulla Pagina Facebook dell'azienda.

Call to action di Instagram

ig_cta

Tipo: FBEIGCtaConfigData

Pulsante di call to action (CTA) sul profilo Instagram dell'azienda.

Call to action di Messenger

messenger_menu

Tipo: FBEMessengerMenuConfigData

Pulsante di call to action (CTA) su Messenger quando un utente invia messaggi all'azienda.

Invio della disponibilità tramite Messenger con lo scopo di avviare una conversazione

thread_intent

Tipo: FBEThreadIntentConfigData

Suggerimento di Messenger per gli amministratori strumenti business per poter inviare facilmente la propria disponibilità per un appuntamento a un utente in chat.

Richiesta implementazione aggiuntiva

FunzioneParametroDescrizione

Scheda della Pagina con servizi in evidenza

page_card

Tipo: FBEPageCardConfigData

Disponibile solo per il settore APPUNTAMENTI.

Richiede l'implementazione del Catalogo.

Abilita la scheda con i servizi in evidenza dell'azienda sulla relativa Pagina Facebook. Consulta il Catalogo dell'estensione Facebook Business per i campi e i formati richiesti per il settore SERVIZI.

Chat di Messenger

messenger_chat

Tipo: FBEMessengerChatConfigData

Consente l'integrazione di Messenger direttamente sul tuo sito web. Questa funzione consente ai clienti di interagire con la tua azienda in qualsiasi momento con la stessa esperienza personalizzata e ricca di contenuti rich media di Messenger.

Se messenger_chat restituisce enabled: true dall'API Feature Configuration:

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • Il page_id può essere ottenuto tramite webhook o la guida degli endpoint di installazione dell'estensione Facebook Business.
  • Facebook recupera automaticamente le personalizzazioni in base al page_id passato; pertanto, non richiede il passaggio esplicito di alcuna personalizzazione.

Per la guida completa all'implementazione, consulta Plugin per la chat con i clienti.

Configurazione iniziale delle funzioni tramite Business Login

Puoi configurare un numero qualsiasi di funzioni per la tua azienda specificandole nella proprietà business_config, che viene passata tramite il parametro extras sia a Business Login che all'App Store. Qui è dove devi specificare tutte le funzioni che desideri abilitare per la tua azienda al completamento dell'installazione dell'estensione Facebook Business.

business_config è un oggetto JSON contenente sottocampi per descrivere la modalità di configurazione di varie funzioni. Scopri di più sui sottocampi da specificare e su business_config. Ad esempio, per configurare solo la CTA della Pagina Facebook e di Instagram delle aziende, il tuo oggetto business_config risulterebbe simile al seguente:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

Vista di gestione delle funzioni dell'estensione Facebook Business

Per consentire alle tue aziende di configurare ulteriormente le funzioni (al di là di quanto specificato per loro in business_config durante l'installazione), puoi indirizzare le aziende alla nostra vista di gestione dell'estensione Facebook Business dalla tua piattaforma.

Puoi aggiungere un punto di accesso per lanciare la vista di gestione dell'estensione Facebook Business aggiungendo uno dei seguenti metodi (SDK Javascript o URL). Entrambi gli esempi mostrano un pulsante su cui cliccare, che avvia la finestra della modalità di gestione dell'estensione Facebook Business. Consigliamo di nascondere il pulsante di avvio dell'estensione Facebook Business fino a quando il cliente non completa una configurazione dell'estensione. Assicurati di passare il fbe_external_business_id per external_business_id.

Puoi specificare la scheda selezionata per la vista di gestione dell'estensione Facebook Business passando il parametro opzionale tab con il nome della scheda desiderata. Ad esempio, può essere impostato su "Home" o "Commerce". Questo parametro può essere usato nell'SDK Javascript o con il metodo URL.

SDK JavaScript di Facebook

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

Metodo URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API FBE Feature Configuration

Per configurare e aggiornare le funzioni di un'azienda dopo l'installazione iniziale, puoi utilizzare l'API FBE Feature Configuration.

Per le funzioni non personalizzabili, vengono visualizzati solo un ID istanza della funzione e il contrassegno che indica che la funzione è abilitata. Solo le funzioni personalizzabili possono essere aggiornate con una richiesta POST.

L'API Feature Configuration differisce dall'API FBE Installation perché fornisce informazioni aggiuntive sulle funzioni oltre alle risorse connesse, quali lo stato di abilitazione e personalizzazioni specifiche. Dopo aver chiamato l'API FBE Installation, usa l'API Feature Configuration se sono necessarie più informazioni sullo stato di abilitazione o sulla configurazione della funzione.

I seguenti endpoint API consentono di abilitare, disabilitare e configurare le funzioni per un'azienda specifica sulla piattaforma che ha installato l'estensione Facebook Business. L'access_token utilizzato per questi endpoint è quello che ti è stato restituito tramite Business Login o il webhook.

Si consiglia di non memorizzare le configurazioni aziendali sui server. Le configurazioni devono essere sempre interrogate e quindi modificate tramite le API definite di seguito. Gli utenti possono potenzialmente modificare tali funzioni sulla piattaforma Facebook o tramite la Vista di gestione dell'estensione Facebook Business e la tua piattaforma potrebbe non disporre delle configurazioni più aggiornate.

Lettura

Puoi leggere lo stato attuale della configurazione delle funzioni di qualsiasi azienda emettendo la seguente richiesta:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Risposta

Consulta l'oggetto business_config.

Aggiornamento

Per aggiornare tutte le funzioni, effettua la seguente richiesta POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Risposta

Un esempio di risposta.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Abilita e configura il pulsante di call to action della pagina dell'utente finale e invia una richiesta POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Scopri di più

Catalogo