Saltar al contenido

Configuración de Facebook en Jitterbit App Builder

App Builder no es compatible de forma nativa con la API Graph de Facebook, ni como proveedor de autenticación ni de datos. Sin embargo, como la API Graph de Facebook se puede consumir como una API REST asegurada mediante el flujo OAuth Client Credential, es posible utilizar el proveedor HTTP genérico de App Builder para recuperar datos de Facebook.

La documentación de Facebook sobre el uso del flujo OAuth Client Credentials se encuentra aquí:

https://developers.facebook.com/docs/facebook-login/access-tokens#apptokens

Las tareas principales incluyen:

  1. Registrar App Builder como una aplicación de Facebook.
  2. Crear un proveedor HTTP de seguridad de Facebook
  3. Crear una fuente de datos de Facebook.

Se presupone que tu organización ya cuenta con una cuenta de Facebook existente. Además, se presupone que la organización se ha registrado como desarrollador de aplicaciones de Facebook.

Registrar App Builder como una aplicación de Facebook

Comienza por iniciar sesión en el Panel de control de aplicaciones de Facebook.

https://developers.facebook.com/apps/

  1. Haz clic en el botón Agregar una aplicación nueva.

  2. Proporciona la siguiente información:

    • Nombre para mostrar: Un nombre lógico para el entorno o aplicación de App Builder.

      Ejemplo: App Builder

    • Correo electrónico de contacto: Tu dirección de correo electrónico.

    • Categoría: Business

  3. Haz clic en el botón Crear ID de aplicación.

  4. Selecciona Panel de control del menú.
  5. Haz clic en el botón Mostrar debajo de Secreto de aplicación.

  6. Anota las siguientes propiedades:

    • ID de aplicación: Este será el valor de ClientId al configurar el proveedor HTTP de seguridad dentro de App Builder.
    • Secreto de aplicación: Este será el valor de ClientSecret al configurar el proveedor HTTP de seguridad dentro de App Builder.

Crear un proveedor HTTP de seguridad de Facebook

Para crear un proveedor HTTP de seguridad, comienza por iniciar sesión en App Builder como administrador.

  1. Navega al IDE
  2. Selecciona el botón Proveedores de seguridad
  3. Haz clic en el botón + Proveedor de seguridad

  4. Proporciona lo siguiente:

    • Nombre: Facebook
    • Tipo: HTTP
    • Habilitado: Marcar
    • Tipo de autenticación: Client Credentials
    • Haz clic en el botón Guardar

  5. Establece las siguientes propiedades. En el panel Propiedades, haz clic en el botón + Propiedad → Selecciona el Parámetro → Proporciona el Valor → Haz clic en el icono Guardar.

    • AuthenticationType: ClientCredentials
    • TokenEndpoint: https://graph.facebook.com/v2.8/oauth/access_token
    • El punto final del token debe contener el número de versión. La versión debe ser 2.0 o superior. En el momento de escribir esto, 2.8 es la versión actual de la API Graph de Facebook.
    • ClientId: El {ID de aplicación} proporcionado por Facebook
    • ClientSecret: El {Secreto de aplicación} proporcionado por Facebook

Crear una fuente de datos de Facebook

Para crear una fuente de datos de Facebook, comienza por iniciar sesión en App Builder como administrador.

  1. Navega al IDE
  2. Haz clic en el botón Servidores de datos
  3. Haz clic en + Servidor

  4. Proporciona lo siguiente:

    • Nombre del servidor: Facebook
    • Tipo: REST API
    • Subtipo: REST
    • URL: https://graph.facebook.com/
    • Tipo de contenido de solicitud: JSON
    • Tipo de contenido de respuesta: JSON

  5. Expande Configuración de seguridad y establece Proveedor de seguridad al valor de Facebook configurado en el paso anterior

  6. Haz clic en Guardar
  7. Haz clic en el icono Tablas desde Configuración del servidor para configurar la información de Puntos finales
  8. En el panel Puntos finales, haz clic en el botón + Punto final

  9. Proporciona lo siguiente:

    • Nombre: Page
    • Punto final: {{Page}}?fields=fan_count

  10. Haz clic en el icono de marca de verificación

  11. En el panel Parámetros de punto final, haz clic en el botón + Parámetro

  12. Proporciona lo siguiente:

    • Nombre: Page
    • Tipo de datos: String
    • Valor de prueba: zudysoftware

  13. Haz clic en el botón Guardar

  14. En el panel Puntos finales, haz clic en el botón Descubrir y vuelve a hacer clic en Descubrir

Este proceso de importación rellenará el panel de Resultados SQL.

  1. En el panel SQL Results, localiza la tabla Page y haz clic en el icono Results.

Si todo se ha configurado correctamente, deberías ver el conteo de seguidores de la cuenta de Facebook de zudysoftware.

Solución de problemas

Error: "Unexpected character encountered while parsing value: a. Path '', line 0, position 0."

Esto indica que el cuerpo de la respuesta no se serializó como JSON. Asegúrate de que el extremo de token contenga un número de versión y que la versión sea mayor a 2.0.