Perguntas frequentes sobre a Extensão da Meta para Empresas
Respostas a perguntas frequentes sobre a integração da Extensão da Meta para Empresas (MBE).
Instalação
Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.
No, please see the updated Developer Documentation for the latest permissions.
Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.
Verifique se a caixa de seleção "Habilitar catálogo" está marcada na aba Painel do desenvolvedor > Configuração da FBE no Painel de Aplicativos.
Empresas/vendedores podem configurar os recursos comerciais na exibição Gerenciamento, mas não poderão atualizar ativos do Facebook conectados à FBE, tais como o Gerenciador de Negócios, a Conta de anúncios, a Página, o Pixel, o Catálogo etc. Como alternativa, empresas/vendedores podem editar as configurações no fluxo de configuração da FBE para se conectar a ativos diferentes.
Dependendo da necessidade da sua empresa, você pode escolher configurar um ou mais dos seguintes fluxos configurando o valor apropriado em Configuração > Canal:
- Fluxo padrão (nenhum parâmetro obrigatório para o canal) — Permite que os vendedores configurem o pixel do Facebook, a Página do Facebook, a Conta de anúncios e o Catálogo de anúncios dinâmicos.
COMMERCE— Fluxo que permite que os vendedores criem uma conta comercial com a Loja do Facebook e um canal de Compras no Instagram com finalização da compra no site. Além disso, fornece uma opção para escolher lojas externas dentro do fluxo.COMMERCE_OFFSITE— Fluxo que permite que os vendedores criem uma conta comercial com Loja do Facebook fora do site e Compras no Instagram fora do site.FEED— Fluxo que permite aos varejistas sincronizar as atualizações de seus catálogos. Recomendado apenas para parceiros que possuem recursos de feed/catálogo e não possuem hospedagem em site.MARKETPLACE— Fluxo específico a mercados que fazem a integração com a FBE. Recomendado para parceiros que só precisam das etapas de Página e Gerenciador de Negócios no fluxo de configuração da FBE e que, depois, aproveitam a exibição Gerenciamento da FBE para configurar Anúncios Colaborativos.SIGNALS— Fluxo que permite aos usuários dispararem eventos de pixel do Facebook e da API de Conversões. Esse fluxo não dá suporte ao Catálogo do Facebook como um ativo. Recomendado apenas para parceiros com recursos de hospedagem em site e que não têm recursos de catálogo.
Veja abaixo alguns cenários possíveis comuns ao selecionar Páginas durante o login da empresa na FBE. Note que as dicas de ferramentas no fluxo da FBE explicarão o motivo exato de não ser possível selecionar um ativo, podendo variar de um cenário para outro.
A Página estará disponível para seleção:
- Se a Página selecionada não for propriedade de um Gerenciador de Negócios (GN), ela será reivindicada pelo GN selecionado
- Se a Página selecionada for propriedade de outro GN e não for a página principal desse GN, ela será transferida para o GN selecionado
A Página não estará disponível para seleção:
- Se ela for propriedade, e também for a página principal, de outro GN
- Se a Página for propriedade de um GN desativado, por exemplo, por violações de política
Os parceiros podem solicitar o recurso Page Public Metadata Access para o próprio aplicativo para que o aplicativo possa consultar os campos públicos da Página. Saiba mais sobre esse recurso clicando neste documento e clicando aqui também.
Se o campo instagram_profiles não estiver incluído, isso significará que a permissão relacionada ao Instagram (por exemplo, instagram_basic) não faz parte do token de acesso e/ou que a empresa não conectou um perfil comercial do Instagram à FBE. Para saber mais sobre a API de instalação da FBE, consulte este documento.
Isso significa que o aplicativo carece de algumas permissões. Note que a permissão principal necessária para ações relacionadas ao Gerenciador de Negócios é a business_management.
Nós damos suporte à maioria das moedas desta lista, com exceção de JMD, BGN, BYN, UAH, KIP, LKR.
Aviso: a instalação da FBE apresentará falha se alguma moeda sem suporte for fornecida nas configurações da URL de Login. Recomendamos que os parceiros verifiquem se seus vendedores estão usando moedas com suporte antes de permitir que eles iniciem a FBE.
Verifique se você tem acesso de administrador no Gerenciador de Negócios do Facebook associado à conexão atual da FBE, além de acesso de administrador a sua página comercial do Facebook ou perfil comercial do Instagram. Siga estas instruções sobre como adicionar um administrador ao seu Gerenciador de Negócios do Facebook.
Teste
No, system user access tokens can't be generated for test users.
Merchants can remove assets in the management view of MBE after installation.
Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.
There are two types of test accounts available via the developer panel.
Testers: Tester role can be assigned to a user-generated Facebook profile. Reference
Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference
Review each to decide which is better for your testing use case.
Solução de problemas
For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.
A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.
Geral
Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.
Please reach out to your partner manager or engineering contact.
This is a closed beta. Please reach out to your Meta partner manager for more information.
Catálogo
A versão 2 da Extensão do Facebook para Empresas (FBE) usa o Catálogo para importar o inventário de uma empresa. Ele é usado para capacitar diversos recursos, como Anúncios dinâmicos, Lojas e Cartão de serviços da Página. Ele representa uma parte opcional da integração, mas é obrigatório para esses recursos.
Consulte a documentação da API do Catálogo da FBE para obter detalhes de implementação e os campos com suporte.
Seu aplicativo precisará obter permissão do Catálogo (catalog_management) por meio de análise do aplicativo
antes de ficar ativo.
Adicione a permissão catalog_management ao parâmetro de escopo em sua implementação do login para empresa. Assim, seu aplicativo poderá criar, ler, atualizar e excluir catálogos de propriedade da empresa.
Envie uma solicitação de análise do aplicativo assim que houver uma demonstração funcional que você possa usar para screencast como:
- A permissão do catálogo é solicitada no fluxo de integração
- O inventário é enviado para o Catálogo conectado
- Os recursos habilitados pelo Catálogo são ativados após a sincronização dele
Nossa equipe de análise do aplicativo usará as instruções e o screencast fornecidos por você para testar e verificar a integração com o Facebook do seu aplicativo para o Catálogo. Se você tiver recebido uma rejeição, leia o feedback fornecido para entender o motivo. Faça um novo envio com informações atualizadas que forneçam mais detalhes para o analista.
Acesse o nosso Guia de resultados de rejeição na análise do aplicativo para obter dicas sobre como ter sucesso na análise do aplicativo e sobre como notificar o seu gerente de parceiros do Facebook sobre rejeições a fim de obter mais assistência
A seleção de ativos é interligada e há vários motivos para o catálogo não receber a qualificação. Entre os motivos podem estar:
- A página selecionada já está vinculada a um catálogo diferente
- Seu catálogo está associado a uma conta comercial diferente
- Seu catálogo está sendo usado com o aplicativo de teste e não é possível usar o mesmo catálogo para produção
Migração
Na FBE 2.0, é possível conectar uma Página do Facebook ou perfil comercial do Instagram a mais de uma plataforma de parceiro (com base na ID do aplicativo). No entanto, só é possível conectar uma vez o mesmo perfil a uma plataforma de parceiro específica.
Não. As plataformas de parceiros podem ativar o bate-papo do Messenger configurando messenger_chat de business_config no Login de empresa. Com relação à Loja da Página, as empresas/vendedores precisam habilitá-la na exibição Gerenciamento após a migração.
There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.
Plugins
Não. Esses dois plugins estão obsoletos na exibição Gerenciamento da FBE. O bate-papo do Messenger é o único plugin com suporte desde 2021.
HTTPS é obrigatório para os domínios incluídos na lista de permissão do Messenger. Os parceiros devem validar as URLs do campo de domínios com a identificação de protocolo, ou seja, https://
Saiba mais sobre como configurar o objeto FBEMessengerChatConfigData.
Talvez os parceiros estejam em melhores condições de garantir a validade do domínio do Messenger e poupar as empresas/vendedores do incômodo de configurar os domínios. Os parceiros podem definir messenger_chat.domains no business_config do Login de empresa da FBE e definir messenger_chat.enabled=false
Posteriormente, as empresas/vendedores podem ativar o plugin do Messenger na exibição Gerenciamento, ou os parceiros podem oferecer uma forma de as empresas/vendedores fazerem isso em suas plataformas por meio da API de Configuração de Recursos.
Análise de integração
Análise de integração é o processo por meio do qual o Facebook verifica sua integração com a FBE. Após a análise de integração bem-sucedida do seu aplicativo, ele ficará disponível aos usuários públicos (ou seja, usuários comerciais e vendedores).
Após a implementação de todos os requisitos, solicite a análise de integração na aba Painel do desenvolvedor > Visão geral da FBE do seu aplicativo. Para ajudar a acelerar o processo de análise, compartilhe também com nossos analistas ou com o seu representante do Facebook um vídeo completo de demonstração funcional com todos os recursos da FBE implementados.
Apenas administradores e desenvolvedores do seu aplicativo poderão iniciar o fluxo da FBE até que a análise do seu aplicativo tenha sido concluída.
- Veja mais detalhes sobre as limitações do Painel de desenvolvedor da FBE
Please reach out to your Meta partner manager, or submit a new integration review.
SDK/API/Webhooks/Móvel
Sim, a FBE tem suporte em navegadores móveis e também pode ser iniciada usando webViews em seu aplicativo nativo para Android/iOS. Saiba mais sobre como iniciar a FBE em dispositivos móveis.
Os tokens de acesso são obrigatórios para fazer chamadas à Graph API. Veja aqui uma explicação dos tipos diferentes de tokens de acesso.
Você pode chamar o Login do Facebook para obter o access_token antes de iniciar a exibição Gerenciamento e, em seguida, usar esse access_token para chamar a API de configuração de recurso.
Exemplo de código:
function launchFBEManagementView(access_token) {
FB.ui({
display: 'popup',
method: 'facebook_business_extension',
external_business_id: <EXTERNAL_BUSINESS_ID>,
}, function(response){
// call Feature Configuration API with access_token here
});
}
FB.getLoginStatus(function(response) {
if (response.status === 'connected') {
// returns a User Access Token with scopes requested
access_token = response.authResponse.accessToken;
// launch Management View
launchFBEManagementView(access_token);
} else {
FB.login(function (response) {
if (response.authResponse) {
// returns a User Access Token with scopes requested
access_token = response.authResponse.accessToken;
// launch Management View
launchFBEManagementView(access_token);
} else {
console.log('User cancelled login or did not fully authorize.');
}
}, {});
}
});
Lojas
Para usar Compras no Instagram para fluxos internos e externos, é necessário ter uma conta empresarial do Instagram. Uma conta pessoal do Instagram não é qualificada. Se a sua conta empresarial do Instagram não tiver uma presença estabelecida, ou se não estiver vendendo produtos qualificados, talvez ela não se qualifique. Você poderá solicitar uma nova verificação em seis (6) meses. Confira os requisitos de qualificação.
Uma conta comercial pode ter lojas no site ou externas. Também é possível converter lojas no site em lojas externas e vice-versa. Se a sua empresa precisar de lojas no site e externas, você precisará de dois fluxos de integração com ativos diferentes.
A seleção de ativos é interligada e há vários motivos para o catálogo não receber a qualificação. Entre os motivos estão:
- O usuário não é administrador da empresa proprietária da Página
- A Página está associada a um Gerenciador de Negócios diferente
Fale conosco
Use a ferramenta Suporte Direto no Gerenciador de Negócios para receber assistência diretamente da nossa equipe:
- Parceiros de horas marcadas, reservas e pedidos de comida: usem o tópico Extensão do Facebook para Empresas para Serviços
- Parceiros comerciais: usem o tópico Parceiro de marketing: suporte técnico ou entrem em contato diretamente com seu gerente de parceiros do Facebook.
Se você não encontrar o tópico desejado no menu suspenso de Suporte Direto, envie um email para um representante do seu gerente de parceiros do Facebook para obter acesso.
O Suporte Direto tem uma integração sólida com o Gerenciador de Negócios. Portanto, adicione todos os membros da sua equipe que usarão a ferramenta de Suporte Direto para enviar perguntas e erros como usuários do Gerenciador de Negócios da sua empresa. Saiba como fazer isso seguindo estas instruções.
Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.