Integração de horas marcadas da MBE

O fluxo de horas marcadas da Extensão da Meta para Empresas (MBE, pelas iniciais em inglês) permite que vendedores na sua plataforma acessem uma ampla variedade de ferramentas para empresas, como botões de chamada para ação Reservar agora, na Página do Facebook, na conta do Instagram e em bate-papos do Messenger com clientes.

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

Antes de começar

Inscreva-se como desenvolvedor da Meta para acessar nossas ferramentas para desenvolvedores e criar apps do Facebook.
Caso ainda não tenha feito isto, crie um app da Meta, selecionando o tipo Empresa.
Crie uma versão de teste do seu app publicado/em produção e use-a para executar todos os novos desenvolvimentos e testes.
Seus apps (publicados/em produção) devem ser do tipo Empresa e pertencer a um Gerenciador de Negócios que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa e adicionar seus apps a ela.
Adicione o Painel do desenvolvedor da MBE ao seu app.
Se você quiser habilitar o recurso do cartão da página de serviços em destaque, o app precisará obter permissão de catálogo (catalog_management) via análise do app antes de ser publicado. O catalog_management permite que o app crie, leia, atualize e exclua catálogos de propriedade de empresas (inventário de serviços). Envie uma solicitação de análise do aplicativo assim que você tiver uma demonstração funcional para fazer o screencast do seguinte:
- A permissão do catálogo é solicitada no fluxo de integração.
- O inventário de serviços é enviado para o catálogo conectado.
- O cartão de serviços é ativado na Página conectada.

Etapas de integração e pontos de entrada

Os empresários (clientes) precisam de um mecanismo para conectar os negócios em uma plataforma de parceiro aos perfis do Facebook ou Instagram e vice-versa. O fluxo de integração pode ser usado para isso. O fluxo de horas marcadas inclui o seguinte:

Criação/seleção de ativos
- Gerenciador de Negócios
- Conta de anúncios
- Catálogo (opcional)
- Perfil do Instagram
- Página do Facebook
- Pixel da Meta
Concessão de permissões
- Gerenciar a extensão para empresas
- Gerenciar catálogos (opcional)
Configuração da empresa e recursos

Para permitir a conexão, você precisa dar suporte a dois fluxos de autenticação, dependendo de onde o usuário (empresário) inicia a conexão:

Superfície do parceiro (conhecida como Login de Empresa) – permite que as empresas iniciem essa conexão por meio da sua plataforma, usando um botão exibido no seu site.
Autenticação de Apps de Negócios – permite que as empresas iniciem a conexão a partir do Facebook/Instagram. Para habilitar esse fluxo e disponibilizar o app em "Apps de Negócios", é preciso fornecer uma interface para autenticação personalizada que permita ao usuário selecionar a empresa dele no seu site e retornar ao fluxo do Facebook ou do Instagram.

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.

setup

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

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` 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 os itens do catálogo da empresa. Consulte os códigos de moeda compatíveis.
`business_vertical` Tipo: enumeração {`APPOINTMENTS`}	Obrigatório. Setor associado à empresa. Use `APPOINTMENTS` como o setor associado à empresa.

business_config

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.
`ig_cta` Tipo: FBEIGCtaConfigData	Obrigatório. Recursos para o botão de chamada para ação (CTA) do Instagram, como `enabled`, `cta_button_text`, `cta_button_url` e assim por diante. Texto de CTA compatível: `Book Now`
`page_cta` Tipo: FBEPageCtaConfigData	Obrigatório. Recursos para o botão de chamada para ação (CTA) da Página do Facebook, como `cta_button_text`, `cta_button_url` e assim por diante. Texto de CTA compatível: `Book Now`
`page_card` Tipo: FBEPageCardConfigData	Opcional. Habilita o cartão com os serviços em destaque da empresa (até três) na Página do Facebook. É preciso implementar um catálogo.
`messenger_menu` Tipo: 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`. Texto de CTA compatível: `Book Now`
`thread_intent` Tipo: FBEThreadIntentConfigData	Opcional. Sugestão do Messenger para que os administradores da empresa enviem facilmente a disponibilidade de horas marcadas a um usuário do bate-papo.

Exemplo de extras para horas marcadas

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "APPOINTMENTS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "page_card": {
            "enabled": true,
            "see_all_text": "See All",
            "see_all_url": "<BUSINESS_URL_FOR_CTA>",
            "cta_button_text": "Book"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "thread_intent": {
            "enabled": true,
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

Saiba como Configurar recursos empresariais.

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.
Envie para nós um inventário completo e mantenha o catálogo atualizado (opcional).
Permita que empresas desinstalem a FBE.
Faça um envio para a análise de integração com a FBE. Assim que sua integração for aprovada, será possível lançar o aplicativo para usuários públicos.