Integração de Comércio da MBE

Este guia apresenta os principais pré-requisitos para o fluxo de Comércio da MBE, além de uma visão geral de alto nível das etapas necessárias para concluir o processo.

A Extensão do Meta para Empresas (MBE) permite que as empresas configurem facilmente ferramentas para gerenciar os próprios anúncios do Facebook e criar lojas do Instagram e do Facebook. O fluxo de integração de Comércio da MBE pode ser usado tanto para comércio externo quanto para lojas internas.

Uma diferença fundamental é que a finalização da compra para lojas externas é redirecionada para o site do vendedor; para lojas internas, ela ocorre no app do Facebook ou Instagram.

O fluxo de integração de comércio permite que as empresas configurem ou integrem o seguinte:

Pixel da Meta
Catálogo
Conta de anúncios
Loja da Página do Facebook
Loja do Instagram
Bate-papo do Messenger (opcional)
Gerenciador de Negócios
Gerenciador de Comércio

Para usar Compras no Instagram para fluxos internos e externos, é necessário ter uma conta empresarial do Instagram. A conta deve atender aos requisitos de qualificação.

Exemplo: fluxo de integração da superfície do parceiro (Login de Empresa)

Antes de começar

Os fluxos de integração de lojas estão atualmente disponíveis apenas para parceiros selecionados em versão beta fechada. Se você tiver interesse em obter acesso no futuro, entre em contato com seu representante do Facebook.

Inscreva-se como desenvolvedor da Meta para acessar nossas ferramentas para desenvolvedores e criar apps do Facebook.
Caso ainda não tenha feito isso, crie um app do Facebook.
Seu app do Facebook deve ser propriedade de um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa.
Crie uma versão de teste do seu app ao vivo/de produção e use-o para realizar todos os novos desenvolvimentos e testes.
Permissões privadas: manage_business_extension — Esta é uma permissão privada que exige que o representante do Facebook adicione seu app à lista de permissão. Quando esse recurso for disponibilizado para o app, você poderá encontrar o Painel do Desenvolvedor da FBE em Produtos.
Solicite as seguintes permissões por meio da análise do seu app do Facebook:
- catalog_management — Permite que um usuário com direitos de administrador crie, leia, atualize e exclua catálogos de produtos de propriedade da empresa. Como alternativa, você pode solicitar a permissão ads_management se também quiser gerenciar anúncios em nome dos vendedores que usam seu app.
- business_management — Necessário para usar a API do Gerenciador de Negócios para gerenciar ativos da empresa.
- Instagram_basic — Necessário ao usar compras no Instagram. Com a permissão instagram_basic, o app pode ler conteúdo de mídia e informações do perfil de uma conta do Instagram.
- pages_read_engagement — Necessário para gerar um token de acesso à Página posteriormente.
- [Interno] commerce_manage_accounts (leitura/gravação) ou commerce_account_read_settings (somente leitura) — Essas permissões detalhadas são necessárias por meio da análise do app para gerenciar uma conta de comércio.
- [Interno] commerce_account_manage_orders (leitura/gravação) ou commerce_account_read_orders (somente leitura) — Essas permissões detalhadas são necessárias para listar, visualizar ou atualizar pedidos por meio de uma conta de comércio.
- [Interno] commerce_account_read_reports — Permite que o app leia dados de relatórios financeiros para criar relatórios personalizados de imposto, reconciliação de caixa e reembolso para uma conta de comércio.
As compras no Instagram podem exigir a verificação de domínio se o domínio do vendedor ainda não tiver sido verificado. Saiba como verificar seu domínio.
Configure a autenticação com as configurações necessárias e inicie o fluxo de integração da FBE via Login da Empresa ou a Facebook App Store.

Configurações obrigatórias

Extras

Campo Tipo Descrição

Campo	Tipo	Descrição
`setup`	setup	Obrigatório A configuração do Facebook do vendedor, como o identificador único (`external_business_id`) ou a moeda do catálogo (`currency`). Consulte detalhes de objetos de configuração.
`business_config`	business_config	Obrigatório Objeto de configuração que a Extensão do Facebook para Empresas usa para configurar o fluxo de trabalho da Extensão do Facebook para Empresas. Consulte detalhes do objeto `business_config`.
`repeat`	booliano	Obrigatório Defina esse valor como `false`.

setup

setup

Obrigatório

A configuração do Facebook do vendedor, como o identificador único (external_business_id) ou a moeda do catálogo (currency). Consulte detalhes de objetos de configuração.

business_config

business_config

Obrigatório

Objeto de configuração que a Extensão do Facebook para Empresas usa para configurar o fluxo de trabalho da Extensão do Facebook para Empresas. Consulte detalhes do objeto business_config.

repeat

booliano

Obrigatório

Defina esse valor como false.

Configuração

Campo	Descrição
`external_business_id` string	Obrigatório identificação da empresa única para representar a empresa do seu cliente. Usamos isso como um identificador único. Por exemplo, se a empresa do vendedor se chama "Fubar", "fubar-123" poderá ser seu `external_business_id`.
`timezone` string	Obrigatório O fuso horário em que a empresa está localizada. Consulte possíveis valores de fuso horário.
`currency` string	Obrigatório Código de moeda ISO de três letras da moeda-padrão usada nos itens do catálogo da empresa. Consulte os códigos de moeda compatíveis.
`business_vertical` enumeração	Obrigatório Vertical associado à empresa. Valor: `ECOMMERCE`
`merchant_settings_id` string	Opcional Usado ao fazer a atualização da Extensão do Facebook para Empresas 1.0. Entre em contato com seu representante do Facebook se estiver migrando da v1 para a v2.
`domain` string	Obrigatório para os canais COMMERCE e COMMERCE_OFFSITE Domínio usado para aprovação manual do Instagram. Por exemplo: `https://exampleshop.partnersite.com`.
`channel` enumeração	Obrigatório Fornece uma forma para o parceiro expressar a intenção do usuário em relação aos recursos que exigem etapas ou restrições adicionais: `COMMERCE` e `COMMERCE_OFFSITE`. `COMMERCE` — Fluxo que permite que os vendedores criem uma conta de comércio com a Loja da Página e o Canal de Compras no Instagram com checkout no site. A opção de selecionar checkout externo também está disponível nesse fluxo. `COMMERCE_OFFSITE` — Fluxo que permite que os vendedores criem uma conta de comércio com a Loja do Facebook e Compras no Instagram externas. Nota: os parceiros devem solicitar a permissão `instagram_basic` para todos os fluxos de comércio (`COMMERCE` e `COMMERCE_OFFSITE`). A permissão `instagram_basic` é necessária para que um app dê suporte à política de acesso do vendedor/integração do Instagram. Essa permissão exige a análise do app.
`business_manager_id` string	Opcional Identificação do Gerenciador de Negócios existente do usuário que um parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`ad_account_id` string	Opcional Identificação da Conta de anúncios para a conta de anúncios existente do usuário que um parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`page_id` string	Opcional Identificação da Página para a Página do Facebook existente do usuário que o parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`ig_profile_id` string	Opcional Identificação do perfil comercial do Instagram existente do usuário que um parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`pixel_id` string	Opcional Identificação do Pixel existente do usuário que o parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.
`catalog_id` string	Opcional ID do Catálogo existente do usuário que o parceiro pode inserir a fim de pré-selecionar para o usuário no fluxo de configuração.

Configuração da empresa

Use este objeto para definir as configurações da empresa para um usuário final; isso inclui o Messenger e muito mais. Cada campo inclui um "tipo" vinculado às respectivas tabelas abaixo.

Campo	Descrição
`business` FBEBusinessPropertiesConfigData	Obrigatório Informações para a empresa do usuário final
`messenger_chat` FBEMessengerChatConfigData	Opcional Recursos de bate-papo do Messenger na página do usuário final do Facebook, como `enabled` e `domains`
`catalog_feed_scheduled` FBECatalogFeedConfigData	Opcional Determina se a Extensão do Facebook para Empresas deve usar uma abordagem de feed, que obtém itens do catálogo de uma `feed_url`
`page_cta` FBEPageCtaConfigData	Opcional Botão de chamada para ação (CTA) na página do usuário final, como `cta_button_text`, `cta_button_url` etc.
`ig_cta` FBEIGCtaConfigData	Opcional Características do recurso de chamada para ação do Instagram, como `enabled`, `cta_button_text`, `cta_button_url` etc.
`messenger_menu` FBEMessengerMenuConfigData	Opcional Recursos para o botão de chamada para ação (CTA) do Messenger quando o usuário envia mensagens para a empresa, como `cta_button_text` e `cta_button_url`.

Após a instalação

Obtenha identificações de ativos, verifique notificações de Webhooks e eventos de Pixel.
Configure as informações sobre impostos e envio para lojas no local na visualização de gerenciamento de contas de Comércio.
Verifique o acesso às APIs de Comércio.