Integração de Mensagens da FBE

A Extensão do Facebook para Empresas (FBE) permite que as empresas configurem e gerenciem facilmente conversas com seus clientes em grande escala no Facebook e Instagram. O fluxo de integração de Mensagens da FBE permite que as empresas configurem ou integrem o seguinte:

Gerenciador de Negócios
Página do Facebook
Conta do Instagram (se já estiver conectada à Página do Facebook)
Conta de anúncios
Bate-papo do Messenger (opcional)

Este documento descreve os principais pré-requisitos para o fluxo de Mensagens da FBE, juntamente com uma visão geral de alto nível das etapas necessárias para concluir o processo. Consulte o guia da Extensão do Facebook para Empresas para obter detalhes específicos sobre integrações gerais.

Exemplo - Fluxo de integração da superfície do Facebook (Aplicativos de negócios)

Antes de começar

Seu app deve pertencer a um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa.
Um app do Facebook é obrigatório com o seguinte nível de acesso, recurso e permissões:
- Nível de acesso: acesso avançado
- Recurso: Acesso Padrão ao Gerenciamento de Anúncios
- Permissões públicas: ads_management, ads_read, business_management, pages_manage_ads, pages_manage_metadata, pages_messaging, pages_show_list, page_events
- Permissões privadas: manage_business_extension — Esta é uma permissão privada que exige que o representante do Facebook adicione seu app à lista de permissões. Entre em contato com seu representante da Meta para receber ajuda.
Configure a autenticação com as configurações obrigatórias e inicie o fluxo de integração da FBE via Login de Empresa (na plataforma do parceiro) ou Apps de negócios (no Facebook).

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

Use esse objeto para definir as configurações para a presença do usuário final no Facebook

Campo	Descrição
`external_business_id` Tipo: 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` Tipo: string	Obrigatório. O fuso horário em que a empresa está localizada. Consulte os valores possíveis de fuso horário.
`currency` Tipo: string	Obrigatório. Código de moeda ISO de três letras da moeda padrão usada para itens do catálogo da empresa. Consulte os códigos de moeda compatíveis.
`business_vertical` Tipo: enumeração	Obrigatório. Vertical associado à empresa . Valores:`MESSAGING`
`channel` Tipo: enumeração	Obrigatório. Fornece uma forma para o parceiro configurar o fluxo da FBE. Para o fluxo de Mensagens, esse valor deve ser `MESSAGING`. `MESSAGING` — Fluxo que permite aos usuários finais criar ou selecionar Gerenciador de Negócios, Conta de anúncios, Página do Facebook e conta do Instagram. Realizar a configuração com esses ativos permite que o usuário final gerencie as conversas com seus clientes em grande escala.
`business_manager_id` Tipo: string	Opcional. Identificação do Gerenciador de Negócios existente do usuário que um parceiro pode inserir para fazer a pré-seleção no fluxo de configuração.
`ad_account_id` Tipo: string	Opcional. Identificação 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` Tipo: string	Opcional. Identificação 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` Tipo: 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.

Configuração da empresa

Use este objeto para definir as configurações da empresa para um usuário final. Isso inclui CTAs, cartão de serviços e muito mais. Cada campo inclui um "tipo" vinculado às respectivas tabelas abaixo.

Campo	Descrição
`business` Tipo: FBEBusinessPropertiesConfigData	Obrigatório. Informações para a empresa do usuário final.
`messenger_chat` Tipo: FBEMessengerChatConfigData	Opcional. Recursos de bate-papo do Messenger na Página do Facebook do usuário final, como `enabled` e `domains`.
`messenger_menu` Tipo: FBEMessengerMenuConfigData	Opcional. Características do recurso de menu persistente do Messenger, como `cta_button-text` e `cta_button_url`.

Próximas etapas

Receba notificações de Webhooks sobre empresas instalando e desinstalando a FBE.
Dispare eventos do pixel para cada empresa integrada à FBE na sua plataforma.
Adicione um ponto de entrada à nossa Visualização de gerenciamento de recursos a partir da sua superfície.
Permita que as empresas desinstalem a FBE.
Faça um envio para a análise de integração com a FBE. Assim que a integração for aprovada, seu app estará disponível para usuários públicos.