Guia de migração da FBE 1.0 para a FBE 2.0

Este guia descreve as alterações necessárias para migrar vendedores existentes da FBE 1.0 para a FBE 2.0 de forma compatível.

Alterações

A FBE 2.0 é diferente da 1.0 em relação à implementação técnica. Recomendamos que você siga os guias da FBE 2.0 para saber mais sobre a implementação e boas práticas.

FBE 1.0FBE 2.0

Tela de início

Usa o Login de empresa para autenticação e configuração. A Visualização do gerenciamento é iniciada separadamente.

Pixel

Implementação semelhante do pixel, com a inclusão da API no lado do servidor.

Catálogo

Implementação semelhante. A abordagem Push (via API) é recomendada no lugar da Pull (Feed). Veja mais informações na documentação sobre o catálogo da FBE 2.0.

Transmissão de mensagens

OBSOLETO. Há duas opções para localizar informações da empresa: Webhook e ponto de extremidade de instalações da FBE.

Login de empresa

Ao iniciar o Login de empresa na FBE 2.0, especifique o merchant_settings_id no objeto setup. O merchant_settings_id na FBE 1.0 é enviado na transmissão de mensagens via set merchant settings (referência) e já deve estar armazenado pelo parceiro para mostrar a visualização adequada da FBE aos usuários que retornam à versão 1.0.

Via URL

https://facebook.com/dialog/oauth?client_id=<YOUR_FB_APP_ID>
&display=<popup|window|page>
&redirect_uri=<REDIRECT_URI> // e.g. "https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension,catalog_management
&extras={
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", // e.g. "foo-123"
        "timezone": "<BUSINESS_TIMEZONE>", // e.g. "America/Los_Angeles"
        "currency": "<BUSINESS_SERVICES_CURRENCY>", // e.g. "USD"
        "business_vertical": "ECOMMERCE"
        "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>",
     },
     ...
}

Via SDK

function launchFBE() {
        FB.login(function (response) {
            if (response.authResponse) {
                // returns a User Access Token with scopes requested
                const accessToken = response.authResponse.accessToken;
                const message = {
                    'success':true,
                    'access_token':accessToken,
                };
                // store access token for later  
            } else {
              console.log('User cancelled login or did not fully authorize.');
            }
        }, {
            scope: 'catalog_management,manage_business_extension',
          // refer to the extras object table for details
            extras: {
                "setup":{
                  "external_business_id":"<external_business_id>",
                  "timezone":"America\/Los_Angeles",
                  "currency":"USD",
                  "business_vertical":"ECOMMERCE",
                  "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>",
                },
                ...
            }
        });
    }

Preferencialmente, o merchant_settings_id só deve ser transmitido no Login de Empresa quando o usuário ainda não tiver feito a migração para a FBE 2.0. Quando o merchant_settings_id é transmitido, localizamos os ativos do usuário selecionados na FBE 1.0 e simplificamos o processo de migração.



Quando você fornece o merchant_settings_id no fluxo de configuração da FBE, o usuário é orientado a seguir estes caminhos de migração:

  • Se tiver acesso de administrador a todos os ativos da FBE 1.0 e aos respectivos Gerenciadores de Negócios, o usuário deverá seguir a migração em uma única tela, como mostrado à esquerda. Nesse processo, o Gerenciador de Negócios pré-selecionado segue o do pixel, já que não é possível migrar o pixel para outro Gerenciador de Negócios.

  • Se tiver acesso de administrador a todos os ativos da FBE 1.0, mas o pixel não pertencer a um Gerenciador de Negócios, o usuário deverá seguir a migração em uma única tela, como mostrado à esquerda, mas com a funcionalidade Editar. Nesse caso, os usuários podem selecionar um Gerenciador de Negócios existente ou criar um novo.

  • Sem acesso de administrador a todos os ativos da FBE 1.0 e aos respectivos Gerenciadores de Negócios, os usuários serão redirecionados a uma tela de erro, como mostrado à direita. Nessa migração, eles deverão seguir o fluxo normal de configuração de FBE e selecionar cada ativo.