Integração de reservas da FBE

O fluxo de reservas da Extensão do Facebook para Empresas (FBE, 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, na Página do Facebook, na conta do Instagram e em bate-papos do Messenger com clientes. Esse fluxo não possui recursos de Catálogo.

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

Antes de começar

  1. Inscreva-se como desenvolvedor do Facebook para acessar nossas ferramentas para desenvolvedores e criar apps da Meta.
  2. Caso ainda não tenha feito isso, crie um app da Meta.
  3. Crie um app de teste.
  4. Seus apps (ao vivo/de produção e teste) devem pertencer a um Gerenciador de Negócios da Meta que seja uma empresa verificada. Saiba mais sobre como verificar sua empresa e adicionar seus apps a ela.
  5. Adicione o Painel do Desenvolvedor da FBE ao seu app da Meta.

Etapas de integração e pontos de entrada

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

  • Criação/seleção de ativos
  • Concessão de permissões
    • Gerenciar extensão de negócios
  • 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

CampoTipoDescriçã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

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

CampoDescriçã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 possíveis valores 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 {RESERVATIONS}

Obrigatório.
Setor associado à empresa.

Use RESERVATIONS 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 e mais. Cada campo inclui um "tipo" vinculado às respectivas tabelas abaixo.

CampoDescriçã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: Reserve

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: Reserve

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: Reserve

Exemplo de extras para reservas

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "RESERVATIONS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Reserve",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

Saiba como Configurar recursos empresariais.

Próximas etapas