Configurar funciones de la empresa

Obtén información sobre las opciones disponibles para activar y configurar las funciones de la empresa correspondientes a la FBE.

Opciones de configuración

Para activar y configurar las funciones de la empresa para el usuario, usa una de las siguientes opciones disponibles:

OpciónDescripciónRecomendación

Configuración de funciones mediante el Inicio de sesión comercial

Se pasó al Inicio de sesión comercial para activar y desactivar funciones de la extensión Facebook Business (FBE).

Activa esta opción de función para socios mediante el Panel de desarrolladores de FBE. Con esta función, los socios deberían hacer saber a los usuarios que estas funciones se activan automáticamente para ellos.

Se recomienda si tienes un conjunto predeterminado de funciones que configurar para el usuario.

Vista de administración de funciones

La UI de Facebook de autoservicio para el usuario permite activar y desactivar funciones de la FBE.

Se recomienda si no deseas compilar una UI y quieres usar el autoservicio de UI de Facebook, no sus funciones de Instagram y Facebook.

API de configuración de funciones

Crea una vista de administración de funciones personalizada para activar y desactivar funciones de la FBE.

Se recomienda para compilar una vista propia de administración de funciones que coincida con la apariencia de la vista de tu usuario.

Funciones admitidas

La extensión Facebook Business ofrece muchas funciones que puedes activar para tus negocios.

Se agrupan las siguientes funciones por el sector en el que mejor se desempeñan:

Funciones estándar

FunciónParámetroDescripción

Llamada a la acción de la página de Facebook

page_cta(s)

Escribe lo siguiente: FBEPageCtaConfigData

Botón de llamada a la acción de la página de Facebook de la empresa.

Llamada a la acción de Instagram

ig_cta(s)

Escribe lo siguiente: FBEIGCtaConfigData

Botón de llamada a la acción del perfil de Instagram de la empresa.

Llamada a la acción de Messenger

messenger_menu

Escribe lo siguiente: FBEMessengerMenuConfigData

Botón de llamada a la acción en Messenger cuando un usuario envía mensajes a la empresa.

Chat de Messenger

messenger_chat

Escribe lo siguiente: FBEMessengerChatConfigData

Permite la integración de Messenger directamente en tu sitio web, lo que facilita la interacción de los clientes con tu empresa en cualquier momento.

APPOINTMENTS: funciones específicas

FunciónParámetroDescripción

Tarjeta de página de servicios destacados

page_card

Escribe lo siguiente: FBEPageCardConfigData

Requiere el catálogo.

Es una tarjeta con los servicios destacados de la empresa en su página de Facebook.

Intención de conversación al enviar disponibilidad en Messenger

thread_intent

Escribe lo siguiente: FBEThreadIntentConfigData

Sugerencia de Messenger para administradores del negocio que permite enviar fácilmente su disponibilidad a un usuario en el chat.

No se requiere una implementación adicional

FunciónParámetroDescripción

Llamada a la acción de la página de Facebook

page_cta

Escribe lo siguiente: FBEPageCtaConfigData

Botón de llamada a la acción de la página de Facebook de la empresa.

Llamada a la acción de Instagram

ig_cta

Escribe lo siguiente: FBEIGCtaConfigData

Botón de llamada a la acción del perfil de Instagram de la empresa.

Llamada a la acción de Messenger

messenger_menu

Escribe lo siguiente: FBEMessengerMenuConfigData

Botón de llamada a la acción en Messenger cuando un usuario envía mensajes a la empresa.

Intención de conversación al enviar disponibilidad en Messenger

thread_intent

Escribe lo siguiente: FBEThreadIntentConfigData

Sugerencia de Messenger para administradores del negocio que permite enviar fácilmente su disponibilidad a un usuario en el chat.

Se requiere una implementación adicional

FunciónParámetroDescripción

Tarjeta de página de servicios destacados

page_card

Escribe lo siguiente: FBEPageCardConfigData

Disponible solo para el sector de APPOINTMENTS.

Requiere una implementación del catálogo.

Activa la tarjeta con los servicios destacados de la empresa en su página de Facebook. Consulta el Catálogo de la FBE para ver los campos y formatos obligatorios del sector de SERVICIOS.

Chat de Messenger

messenger_chat

Escribe lo siguiente: FBEMessengerChatConfigData

Permite la integración de Messenger directamente en tu sitio web. Esta función facilita la interacción de los clientes con tu empresa en cualquier momento con la misma experiencia personalizada de contenido multimedia enriquecido que obtienen en Messenger.

Si messenger_chat devuelve enabled: true desde la API de configuración de funciones:

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • El page_id se puede obtener mediante el webhook o la guía de los puntos de conexión de las instalaciones de la FBE.
  • Automáticamente, Facebook recupera las personalizaciones según el page_id pasado. Por lo tanto, no requiere que se pase ninguna personalización explícitamente.

Para ver la guía de implementación completa, consulta Plugin de chat con clientes.

Configuración inicial de funciones mediante el Inicio de sesión de empresa

Puedes configurar cualquier cantidad de funciones para tu empresa. Para ello, debes especificarlas en la propiedad business_config, que se pasa mediante el parámetro extras en el Inicio de sesión comercial y en la App Store. Aquí es donde debes especificar todas las funciones que quieres activar en tu empresa en cuanto se complete la instalación de la FBE.

business_config es un objeto JSON que contiene subcampos para describir cómo configurar varias funciones. Obtén más Información sobre los subcampos que se deben especificar y sobre business_config. Por ejemplo, para configurar solo la llamada a la acción de Instagram y la llamada a la acción de la página de Facebook de la empresa, tu objeto business_config debería verse de la siguiente manera:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

Vista de administración de las funciones de la FBE

Si quieres permitir que tu empresa realice una configuración más avanzada de las funciones (más allá de lo que especificaste en business_config durante la instalación), puedes dirigir a la empresa a nuestra vista de administración de la FBE desde tu plataforma.

Si quieres agregar un punto de entrada para iniciar la vista de administración de la FBE, debes añadir cualquiera de los siguientes métodos (Javascript SDK o URL). En ambos ejemplos, se muestra un botón para hacer clic, que debería iniciar la ventana "Modo de administración de FBE". Recomendamos ocultar el botón de inicio de la FBE hasta que el cliente complete una configuración de FBE. Asegúrate de pasar fbe_external_business_id para external_business_id.

Si quieres especificar la pestaña seleccionada para la vista de administración de la FBE, debes pasar el parámetro opcional tab con el nombre de la pestaña deseada. Por ejemplo, puedes establecer "Hogar" o "Comercio". Este parámetro se puede usar en el SDK para JavaScript o con el método de URL.

SDK de Facebook para JavaScript

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

Método de URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API de configuración de funciones de la FBE

Para configurar y actualizar las funciones de una empresa desde tu entorno después de la instalación inicial, puedes usar la API de configuración de funciones de FBE.

En el caso de las funciones no personalizables, se muestra solo un identificador de instancia de función y una marca que indica que está activada. Solo las funciones personalizables se pueden actualizar con una solicitud POST.

La API de configuración de funciones es diferente de la API de instalación de la FBE, ya que proporciona información adicional acerca de las funciones más allá de los activos conectados, incluido el estado activado y las personalizaciones de características específicas. Después de llamar a la API de instalación de la FBE, usa esta API si necesitas más información sobre el estado activado o la configuración de la función.

Los siguientes puntos de conexión de la API te permiten activar, desactivar y configurar funciones para una empresa específica en tu plataforma con la FBE instalada. El access_token que se usa para estos puntos de conexión es el que se te muestra mediante el Inicio de sesión de empresa o el webhook.

Recomendamos no almacenar configuraciones de la empresa en tus servidores. Las configuraciones siempre deben consultarse y modificarse con las API que se definen a continuación. Los usuarios pueden cambiar potencialmente esas funciones en la plataforma de Facebook o mediante la Vista de administración de la FBE, y es posible que tu plataforma no cuente con las configuraciones más recientes.

Leer

Puedes leer el estado de configuración actual de las funciones de cualquier empresa mediante la siguiente solicitud:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Respuesta

Consulta el objeto business_config.

Actualizar

Para actualizar alguna de las funciones, o todas, proporciona la siguiente solicitud POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Respuesta

Un ejemplo de respuesta.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Activa y configura el botón de llamada a la acción de la página del usuario final y envía una solicitud POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Más información

Catálogo