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:
- Registrar o App Builder como uma aplicação do Facebook.
- Criar um provedor HTTP do Facebook
- 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/
- Clique no botão Add a New App.
-
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
-
-
Clique no botão Create App ID.
- Selecione Dashboard no menu.
- Clique no botão Show sob App Secret.
-
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.
- Navegue até a IDE
- Selecione o botão Security Providers
- Clique no botão + Security Provider
-
Forneça o seguinte:
- Name: Facebook
- Type: HTTP
- Enabled: Marque
- Authentication Type: Client Credentials
- Clique no botão Save
-
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.
- Navegue até a IDE
- Clique no botão Data Servers
- Clique em + Server
-
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
-
Expanda Security Settings, configure Security Provider para o valor do Facebook configurado na etapa anterior
- Clique em Save
- Clique no ícone Tables em Server Settings para configurar as informações de Endpoints
- No painel Endpoints, clique no botão + Endpoint
-
Forneça o seguinte:
- Name: Page
- Endpoint:
{{Page}}?fields=fan_count
-
Clique no ícone de checkmark
- No painel Endpoint Parameters, clique no botão + Parameter
-
Forneça o seguinte:
- Name: Page
- Data type: String
- Test value: zudysoftware
-
Clique no botão Save
- No painel Endpoints, clique no botão Discover e clique em Discover novamente
Este processo de importação preencherá o painel Resultados SQL.
- 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.