Configurar recursos empresariais

Conheça as opções disponíveis para habilitar e configurar recursos empresariais da Extensão do Facebook para Empresas.

Opções de configuração

Para habilitar e configurar recursos empresariais para o usuário, use uma destas opções disponíveis:

Recursos compatíveis

A FBE oferece diversos recursos que podem ser habilitados para as empresas.

Os recursos a seguir são agrupados pela vertical adequada:

Recursos padrão

Recursos específicos para horas marcadas

Nenhuma implementação adicional necessária

Implementação adicional necessária

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>

Configuração inicial do recurso via login da empresa

Você pode configurar quantos recursos quiser para a sua empresa. Basta especificá-los na propriedade business_config, que é transmitida pelo parâmetro extras no login da empresa e na App Store. Especifique aqui todos os recursos que você quer habilitar para a sua empresa assim que a instalação da FBE for concluída.

business_config é um objeto JSON que contém subcampos para descrever como configurar vários recursos. Saiba mais sobre os subcampos que devem ser especificados e o objeto business_config. Por exemplo, se você configurasse somente a CTA do Instagram e da Página do Facebook da empresa, o objeto business_config teria esta aparência:

{
  "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"
  },
}

Visualização de gerenciamento de recursos da FBE

Para permitir uma configuração ainda mais detalhada de recursos (além do que foi especificado em business_config durante a instalação), você pode direcionar as empresas para a visualização de gerenciamento da FBE na sua plataforma.

É possível adicionar um ponto de entrada para iniciar a visualização de gerenciamento da FBE incluindo um dos seguintes métodos (SDK para JavaScript ou URL). Os dois exemplos exibem um botão para clicar, que abriria a janela do modo de gerenciamento da FBE. Recomendamos ocultar o botão de inicialização da FBE até que um cliente conclua a configuração da extensão. Transmita a fbe_external_business_id para external_business_id.

É possível especificar a aba selecionada para a visualização de gerenciamento da FBE transmitindo o parâmetro opcional tab com o nome desejado. Por exemplo, pode ser definido como "Página inicial" ou "Comércio". Esse parâmetro pode ser usado no SDK para JavaScript ou com o método de URL.

SDK do Facebook para JavaScript

<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>;

Método de 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 de Configuração de Recursos da FBE

Para poder configurar e atualizar os recursos de uma empresa após a instalação inicial, use a API de Configuração de Recursos da FBE.

Para recursos que não podem ser personalizados, você verá apenas uma identificação da instância do recurso e uma sinalização que indica o status de habilitado. A atualização com uma solicitação POST só pode ser realizada em recursos que permitem a personalização.

A API de Configuração de Recursos é diferente da API de Instalação da FBE porque fornece informações de recursos adicionais além dos ativos conectados, incluindo o status de habilitado e personalizações específicas. Depois de fazer uma chamada para a API de Instalação da FBE, use a API de Configuração de Recursos para ver mais informações sobre o status de habilitado ou a configuração do recurso.

Os pontos de extremidade da API a seguir permitem que você habilite, desabilite e configure recursos na sua plataforma para uma empresa que tem a FBE instalada. O access_token usado para esses pontos de extremidade é o mesmo retornado via login da empresa ou Webhook.

Ler

É possível ler o status de configuração do recurso atual de qualquer empresa, emitindo a seguinte solicitação:

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

Resposta

Consulte o objeto business_config.

Atualizar

Para atualizar todos os recursos, faça esta solicitação 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"

Resposta

Um exemplo de resposta.

    {
  "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,
    },
  ],
  ...
}

Habilite e configure o botão de chamada para ação da página do usuário final e envie uma solicitação 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"

Saiba mais

Catálogo

Próximas etapas

Acionar eventos de pixel