Painel do Desenvolvedor da Extensão da Meta para Empresas

O Painel do Desenvolvedor da Extensão da Meta para Empresas é um produto que está disponível no Painel de Apps. Este guia explica como configurar e validar a integração da Extensão da Meta para Empresas usando esse painel.

Como acessar o Painel do Desenvolvedor da Extensão da Meta para Empresas

Navegue até o Painel de Apps e clique no nome do app a ser configurado para carregar o Painel. Caso ainda não tenha feito isto, crie um app da Meta e selecione o tipo Empresa.
No Painel de Apps, clique em Adicionar produto.
Na lista de produtos, selecione Extensão da Meta para Empresas (pode ser necessário clicar em Ver mais produtos).
No cartão do produto, clique em Configurar.

preencher os requisitos

configurar o catálogo

selecionar recursos

Inicie as etapas preliminares e clique na aba Configuração (que pode ser acessada no menu à esquerda) para incluir o restante das informações.
Envie a integração para análise usando a aba Análise de Integração no Painel de Desenvolvedores da MBE. Após a aprovação da integração, será possível acessar a aba Status do lançamento, onde você poderá lançar seu aplicativo para usuários públicos. Saiba mais sobre o processo de análise de integração.

Não encontrou a Extensão da Meta para Empresas na lista de produtos?

Se a Extensão da Meta para Empresas não estiver na lista de produtos, o app precisará obter a permissão privada manage_business_extension. Entre em contato com seu parceiro da Meta para incluir o app na lista de permissão e avisar você quando o processo for concluído.
O app precisa ser do tipo Empresa para obter acesso ao Painel do Desenvolvedor da Extensão da Meta para Empresas.

Aba "Visão geral"

A lista de verificação na aba de visão geral mostra todos os itens que você precisa criar, concluir e validar como parte da integração da MBE antes de enviá-la para a análise da nossa equipe.

É um guia simples para garantir que nenhuma etapa passe despercebida. Os itens na lista de verificação são marcados automaticamente com os status "Incompleto", "Opcional", "Com erros" ou "Concluído", de acordo com o preenchimento das etapas na aba Configuração.

Aba "Configuração"

Na aba Configuração, você irá configurar e validar a maior parte da sua integração. Antes de começar, pense em casos de uso, ferramentas de autenticação e recursos que seu app oferecerá às suas empresas. Assim, é possível garantir a configuração correta e a criação das ferramentas adequadas.

A quais casos de uso (verticais) meu app atende? Por exemplo, marcação de horas, comércio, reservas de restaurantes e assim por diante. Confira a lista completa dos casos de uso compatíveis com a MBE aqui.
Que recursos quero habilitar para as minhas empresas com o app? Por exemplo, chamadas para ação do Instagram, bate-papo do Messenger e assim por diante.

As diferentes seções da aba fornecem validações que ajudarão você a entender se existem erros na integração atual que precisam ser corrigidos antes da disponibilização para as empresas. Por exemplo, ao criar o Login de Empresa ou a URL de autenticação, se algum dos valores de configuração usados for inválido (moeda incompatível, objeto "extras" malformado, configurações de recurso incompletas e assim por diante), aparecerão erros ao clicar no botão Salvar, e o cartão será marcado com o status "Com erros".

Exemplo

Webhooks

Use o cartão "Webhooks" para definir e modificar a configuração de webhooks. O sistema testará e validará a URL de retorno de chamada e o token de verificação inseridos. Após a validação, você assinará automaticamente o webhook fbe_install. No entanto, é possível alternar o estado de assinatura na parte inferior do cartão.

Domínios-curinga

Use os domínios-curinga do Painel do Desenvolvedor para executar validações gerais no pixel. Essas validações também são usadas para identificar empresas que podem se beneficiar com a MBE. Solicitamos que você adicione todos os formatos possíveis para a URL de uma empresa na sua plataforma.

Exemplos

https://www.example.com
https://www.example.com/*
Caso as empresas possam ter subdomínios personalizados:
- https://www.*.example.com
Se você exigir que as empresas tenham caminhos obrigatórios:
- https://www.example.com/some_mandatory_path/*
- https://www.example.com/*/some_mandatory_path/*

Questionário sobre pixel

Use o questionário sobre pixel para refletir sobre a implementação desse recurso. O questionário está no cartão Configurar pixel, na aba Configuração. Clique no botão de configuração para iniciar o questionário. Durante a análise de integração, usaremos as respostas fornecidas no questionário para entender melhor a implementação do disparo do pixel.

Aba "Análise de integração"

É possível iniciar o processo de análise de integração nessa aba. Assim que todos os itens da lista de verificação na aba Visão geral forem concluídos, será possível enviar sua integração para análise.

Aba Status do lançamento

Após a aprovação da integração, será possível acessar esta aba. Lá, você poderá lançar seu aplicativo a usuários públicos clicando no botão Lançar aplicativo.

Aba Depurador

Nesta aba, há duas ferramentas que podem ser usadas após o lançamento. Ao iniciar a integração das empresas, você precisará dos detalhes sobre a conexão delas à FBE, além de resolver problemas que afetam a integração.

Recomendamos usar as ferramentas do depurador como primeira etapa para auxiliar a integração das empresas (por exemplo, caso elas relatem à sua equipe de suporte ao cliente que não conseguem se conectar ou caso os recursos esperados não funcionem como planejado). Ao usar as ferramentas, você pode determinar se os problemas ocorrem do seu lado e resolvê-los por conta própria.

Erros de configuração do app

Essa seção exibe os diversos tipos de erros de instalação que impedem a integração das empresas devido a problemas de configuração na integração da MBE. Você verá a quantidade de empresas afetadas para cada tipo de erro como "Número total".

Use o menu suspenso à direita para ver a lista de erros em um período específico (último mês, semana ou dia).

Exemplo

Como corrigir os erros exibidos

Todos os erros listados no painel são causados por problemas de configuração no objeto "extras". Isso precisa ser encaminhado ao Facebook quando as empresas usam seu login de empresa e a URL de autenticação para fazer a integração.

Para corrigir o problema, é necessário identificar a parte do objeto "extras" que não foi encontrada, está malformada ou usa valores inválidos. Cada tipo de erro listado informa a causa. Portanto, você pode validar os valores enviados pela integração com a referência da FBE sobre o objeto "extras".

Confira alguns exemplos comuns:

A formatação do campo currency em setup está incorreta – para algumas empresas, o valor de moeda que está sendo enviado no objeto "extras" não é aceito pelo Facebook.
O campo ig_cta em business_config contém valores inválidos – os campos ou valores usados para habilitar a chamada para ação do Instagram não são os esperados para o objeto ig_cta.

Depurador da Extensão da Meta para Empresas

Com essa ferramenta, você pode obter o status e os detalhes de uma empresa específica. Ao fornecer o external_business_id, é possível confirmar se a empresa está ou não conectada à MBE no momento. No caso de empresas conectadas, você verá detalhes sobre os ativos conectados (por exemplo, Página, Instagram, catálogo, pixel e assim por diante), além da lista de recursos da MBE ativados pela conexão.