Configuración de las funciones empresariales

Obtén más información sobre las opciones disponibles para activar y configurar las funciones empresariales de la extensión de Facebook para empresas.

Opciones de configuración

Para activar y configurar las funciones empresariales para el usuario, utiliza una de las siguientes opciones disponibles:

OpciónDescripciónRecomendación

Configuración de la función mediante el inicio de sesión empresarial

Se envía al inicio de sesión empresarial para activar y desactivar las funciones de la extensión de Facebook para empresas (FBE).

Activar esta opción de función para socios desde el panel de desarrolladores de FBE. Al utilizar esta función, los socios deben comunicar a los usuarios que estas funciones se activan automáticamente para ellos.

Opción recomendada si tienes un conjunto predeterminado de funciones que configurar para el usuario.

Visualización de administración de funciones

IU de Facebook de autoservicio para que el usuario active y desactive funciones de FBE.

Opción recomendada si no quieres crear una IU y utilizar el autoservicio de IU de Facebook ni sus funciones de Facebook e Instagram.

API de configuración de funciones

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

Opción recomendada para crear tu propia visualización de administración de funciones para que coincida con la apariencia de la del usuario.

Funciones compatibles

La extensión de Facebook para empresas ofrece varias funciones que puedes activar para tus empresas.

Las siguientes funciones se han agrupado según el sector al que mejor se ajustan:

Funciones estándar

FunciónParámetroDescripción

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

page_cta(s)

Tipo: FBEPageCtaConfigData

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

Llamada a la acción de Instagram

ig_cta(s)

Tipo: FBEIGCtaConfigData

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

Llamada a la acción de Messenger

messenger_menu

Tipo: FBEMessengerMenuConfigData

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

Chat de Messenger

messenger_chat

Tipo: FBEMessengerChatConfigData

Activa la integración de Messenger directamente en tu sitio web, lo que permite a los clientes interactuar con tu empresa en cualquier momento.

Funciones específicas de citas

FunciónParámetroDescripción

Tarjeta de página de servicios destacados

page_card

Tipo: FBEPageCardConfigData

Requiere el catálogo.

Tarjeta con los servicios destacados de la empresa en su página de Facebook.

Intención de conversación de envío de disponibilidad de Messenger

thread_intent

Tipo: FBEThreadIntentConfigData

Sugerencia de Messenger para que los administradores de la empresa envíen fácilmente su disponibilidad para las citas a un usuario en el chat.

No se requiere ninguna implementación adicional

FunciónParámetroDescripción

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

page_cta

Tipo: FBEPageCtaConfigData

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

Llamada a la acción de Instagram

ig_cta

Tipo: FBEIGCtaConfigData

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

Llamada a la acción de Messenger

messenger_menu

Tipo: FBEMessengerMenuConfigData

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

Intención de conversación de envío de disponibilidad de Messenger

thread_intent

Tipo: FBEThreadIntentConfigData

Sugerencia de Messenger para que los administradores de la empresa envíen fácilmente su disponibilidad para las citas 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

Tipo: FBEPageCardConfigData

Disponible únicamente para el sector de CITAS .

Requiere la 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 FBE para ver los campos y formatos obligatorios para el sector de servicios.

Chat de Messenger

messenger_chat

Tipo: FBEMessengerChatConfigData

Activa la integración de Messenger directamente en tu sitio web. Esta función permite que los clientes puedan interactuar con tu empresa en cualquier momento y disfrutar de la misma experiencia personalizada con contenido multimedia enriquecido que obtienen en Messenger.

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

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • El valor de page_id puede obtenerse mediante el webhook o la guía del extremo de descargas de FBE.
  • Facebook recupera automáticamente las personalizaciones en función del valor page_id. Por lo tanto, no requiere que se envíe ninguna personalización explícitamente.

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

Configuración de funciones inicial mediante el inicio de sesión empresarial

Puedes configurar cualquier número de funciones para tu empresa especificándolas en la propiedad business_config, que se envía mediante el parámetro extras tanto en el inicio de sesión empresarial como en la tienda de aplicaciones. Es aquí donde debes especificar todas las funciones que quieres activar para tu empresa en cuanto se complete la descarga de 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 debes especificar y business_config. Por ejemplo, para configurar solo las llamadas a la acción de la página de Facebook y de Instagram de las empresas, tu objeto business_config tendría el aspecto siguiente:

{
  "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"
  },
}

Visualización de administración de funciones de FBE

Para que tus empresas puedan configurar todavía más las funciones (más allá de lo que especifiques en business_config durante la instalación), puedes dirigirlas a nuestra visualización de administración de FBE desde tu plataforma.

Puedes añadir un punto de entrada para iniciar la visualización de administración de FBE agregando cualquiera de los siguientes métodos (Javascript SDK o URL). Ambos ejemplos muestran un botón en el que se puede hacer clic, que iniciaría la ventana de modo de administración de FBE. Recomendamos ocultar el botón de inicio de FBE hasta que un cliente complete una configuración de FBE. Asegúrate de indicar fbe_external_business_id para external_business_id.

Puedes especificar la pestaña seleccionada para la visualización de administración de FBE enviando el parámetro opcional tab con el nombre de la pestaña deseada. Por ejemplo, se puede establecer en "Inicio" o "Comercio". Este parámetro puede utilizarse en 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 FBE

Para configurar y actualizar las funciones de una empresa por tu parte después de su descarga inicial, puedes utilizar la API de configuración de funciones de FBE.

En el caso de las funciones que no se pueden personalizar, solo se muestran el identificador de la instancia de la función y una marca activada. Solo se pueden actualizar las funciones que se pueden personalizar con una solicitud POST.

La API de configuración de la función es diferente de la API de instalación de FBE, ya que proporciona información adicional sobre las funciones aparte de los activos conectados, lo que incluye el estado conectado y personalizaciones específicas de la función. Tras llamar a la API de instalación de FBE, usa la API de configuración de la función si necesitas más información sobre la configuración o el estado activado de la función.

Los extremos de la API siguientes te permiten activar, desactivar y configurar las funciones de una empresa específica que tenga FBE instalada en tu plataforma. El valor access_token utilizado para estos extremos es el que se te devuelve mediante el inicio de sesión empresarial o el webhook.

Recomendamos no almacenar las configuraciones empresariales en tus servidores. Siempre se deben consultar y modificar las configuraciones mediante las API definidas a continuación. Los usuarios pueden cambiar estas funciones en la plataforma de Facebook o mediante la visualización de administración de FBE y es posible que tu plataforma no tenga las configuraciones más recientes.

Lectura

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

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.

Actualización

Para actualizar una función o todas ellas, 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

Ejemplo de una 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,
    },
  ],
  ...
}

Activar y configurar el botón de llamada a la acción de la página del usuario final y enviar 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