Ir para o conteúdo

Configurando o Facebook no Jitterbit App Builder

O App Builder não oferece suporte nativo à Graph API do Facebook, nem como provedor de autenticação nem como provedor de dados. No entanto, como a Graph API do Facebook pode ser consumida como uma API REST, protegida usando o fluxo OAuth Client Credential, é possível usar o provedor HTTP genérico do App Builder para recuperar dados do Facebook.

A documentação do Facebook sobre como usar o fluxo OAuth Client Credentials pode ser encontrada aqui:

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

As principais tarefas envolvidas incluem:

  1. Registrar o App Builder como uma aplicação do Facebook.
  2. Criar um provedor HTTP do Facebook
  3. Criar uma fonte de dados do Facebook.

Presume-se que sua organização já possui uma conta do Facebook. Além disso, presume-se que a organização se registrou como desenvolvedora de aplicações do Facebook.

Registrar o App Builder como uma aplicação do Facebook

Comece fazendo login no Facebook App Dashboard.

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

  1. Clique no botão Add a New App.
  2. Forneça as seguintes informações:

    • Display Name: Um nome lógico para o ambiente ou aplicação do App Builder.

      Exemplo: App Builder

    • Contact Email: Seu endereço de email.

    • Category: Business
  3. Clique no botão Create App ID.

  4. Selecione Dashboard no menu.
  5. Clique no botão Show sob App Secret.
  6. Anote as seguintes propriedades:

    • App ID: Este será o valor do ClientId ao configurar o provedor HTTP de segurança no App Builder.
    • App Secret: Este será o valor do ClientSecret ao configurar o provedor HTTP de segurança no App Builder.

Criar um provedor HTTP de segurança do Facebook

Para criar um provedor HTTP de segurança, comece fazendo login no App Builder como administrador.

  1. Navegue até a IDE
  2. Selecione o botão Security Providers
  3. Clique no botão + Security Provider
  4. Forneça o seguinte:

    • Name: Facebook
    • Type: HTTP
    • Enabled: Marque
    • Authentication Type: Client Credentials
    • Clique no botão Save
  5. Configure as seguintes propriedades. No painel Properties, clique no botão + Property → Selecione o Parameter → Forneça o Value → Clique no ícone Save.

    • AuthenticationType: ClientCredentials
    • TokenEndpoint: https://graph.facebook.com/v2.8/oauth/access_token
    • O endpoint do token deve conter o número da versão. A versão deve ser 2.0 ou superior. No momento da redação, 2.8 é a versão atual da Graph API do Facebook.
    • ClientId: O {App ID} fornecido pelo Facebook
    • ClientSecret: O {App Secret} fornecido pelo Facebook

Criar uma fonte de dados do Facebook

Para criar uma fonte de dados do Facebook, comece fazendo login no App Builder como administrador.

  1. Navegue até a IDE
  2. Clique no botão Data Servers
  3. Clique em + Server
  4. Forneça o seguinte:

    • Server Name: Facebook
    • Type: REST API
    • Sub Type: REST
    • URL: https://graph.facebook.com/
    • Request Content Type: JSON
    • Response Content Type: JSON
  5. Expanda Security Settings, configure Security Provider para o valor do Facebook configurado na etapa anterior

  6. Clique em Save
  7. Clique no ícone Tables em Server Settings para configurar as informações de Endpoints
  8. No painel Endpoints, clique no botão + Endpoint
  9. Forneça o seguinte:

    • Name: Page
    • Endpoint: {{Page}}?fields=fan_count
  10. Clique no ícone de checkmark

  11. No painel Endpoint Parameters, clique no botão + Parameter
  12. Forneça o seguinte:

    • Name: Page
    • Data type: String
    • Test value: zudysoftware
  13. Clique no botão Save

  14. No painel Endpoints, clique no botão Discover e clique em Discover novamente

Este processo de importação preencherá o painel Resultados SQL.

  1. No painel Resultados SQL, localize a tabela Page e clique no ícone Resultados.

Presumindo que tudo foi configurado corretamente, você deverá ver a contagem de seguidores da conta Facebook do zudysoftware.

Solução de problemas

Erro: "Caractere inesperado encontrado ao analisar valor: a. Caminho '', linha 0, posição 0."

Isso indica que o corpo da resposta não foi serializado como JSON. Verifique se o endpoint de token contém um número de versão e se a versão é maior que 2.0.