Criar um token de acesso a eventos do Facebook

Gostaria de exibir os seus eventos do Facebook no seu site do WordPress?

Neste guia, vamos explicar-lhe o processo em 3 passos. Irá registar-se como programador do Facebook, criar a sua própria aplicação do Facebook e obter o token de acesso que liga os seus eventos ao plugin. Tudo o que precisa é de acesso de administrador à Página do Facebook cujos eventos pretende apresentar.

Requisitos: Os feeds de eventos requerem o nível de licença «Elite» do Custom Facebook Feed Pro e a versão 4.9.0 ou superior do plugin.

Antes de começar, certifique-se de que o Custom Facebook Feed Pro está instalado e ativado no seu site WordPress.

O Facebook restringe o acesso aos dados dos eventos. Por esse motivo, os feeds de eventos funcionam de forma um pouco diferente dos outros tipos de feed. Estes ligam-se através de uma aplicação do Facebook que o utilizador cria na sua própria conta do Facebook.

Demora apenas alguns minutos. Só precisas de o fazer uma vez.

Passo 3

Obter o token de acesso à página

Nesta etapa, irá gerar um token de acesso de utilizador temporário e fornecê-lo ao plugin. Durante a ligação, o Custom Facebook Feed Pro troca-o por um token de acesso à página que não expira.

O plugin vai pedir o ID e o segredo da tua aplicação. Vamos copiá-los agora.

Na barra lateral esquerda, aceda a «Definições da aplicação» » «Básicas».

Na parte superior da página, encontrará os campos «App ID » e «App secret ». Para revelar o segredo, clique em «Mostrar». Mantenha esta página aberta ou copie ambos os valores para um local seguro, para a etapa de ligação que se seguirá.

Nota: Trate o segredo da sua aplicação e o token de acesso como se fossem palavras-passe. Nunca os partilhe publicamente nem com ninguém fora da sua equipa, incluindo a nossa equipa de apoio. Se precisar de ajuda com a sua fonte de eventos, gere um link de início de sessão com um clique na parte inferior do plugin’s Ajuda página e envie-nos juntamente com o Informações do sistema nessa mesma página.

Com ambos os valores à mão, já está pronto para gerar o seu token de acesso.

Agora vamos gerar o Token de Acesso do Utilizador que associa a tua aplicação à tua conta do Facebook.

No menu superior do Facebook para Desenvolvedores, aceda a Ferramentas » Graph API Explorer ou abra diretamente o Graph API Explorer. No painel da direita, a sua nova aplicação deve estar selecionada na secção «Meta App».

Em seguida, abra o menu suspenso «Adicionar uma permissão» e selecione todas as 5 permissões: business_management, pages_manage_engagement, pages_read_engagement, pages_read_user_content e pages_show_list. As permissões que adicionou anteriormente definiram o que a sua aplicação está autorizada a utilizar. Ao selecioná-las aqui, estas são aplicadas a este token específico. É por isso que é necessário selecionar novamente todas as 5, apesar de 2 já terem vindo incluídas no caso de utilização.

Antes de continuar, verifique se todas as 5 aparecem na lista de permissões. Depois de definir as permissões, clique em «Gerar token de acesso».

Em seguida, surge uma janela de início de sessão do Facebook, perguntando se pretende continuar com a conta na qual está a utilizar. Se for essa a conta correta, clique em «Continuar».

O Facebook pergunta então a quais Páginas e Empresas a aplicação pode aceder. A opção predefinida, «Aceitar todas as Páginas atuais e futuras», é a escolha mais simples. Qualquer Página que criar posteriormente fica automaticamente incluída, sem necessidade de repetir esta configuração. Voltará a ver a mesma opção para as Empresas no ecrã seguinte.

Se preferir restringir o acesso da aplicação, a opção «Opt in to current Pages» também funciona na perfeição. Com esta opção, inclua a Página cujos eventos pretende apresentar. O plugin apresenta apenas as Páginas às quais o seu token tem acesso. Terá de repetir esta configuração para adicionar uma Página que crie posteriormente.

Depois de efetuar a sua seleção em cada ecrã, clique em «Continuar».

No ecrã final, verifique o resumo de acesso e clique em «Guardar».

A janela pop-up fecha-se. O seu novo token de acesso de utilizador aparece no campo «Token de acesso». Em seguida, clique no ícone de cópia ao lado para copiar o token.

Nota: Este token é temporário e tem uma validade de cerca de uma hora, por isso cole-o no plugin ainda nessa mesma sessão. Quando o ligar, o Custom Facebook Feed Pro troca-o por um token da Página que não expira.

Com o ID da aplicação, o segredo da aplicação e o token à mão, volte ao seu site do WordPress. No painel de controlo do WordPress, aceda a Feed do Facebook » Definições.

Na secção «Gerir fontes», clique na seta à direita do botão «Adicionar fonte» e selecione «Fonte de eventos» no menu suspenso.

Isto abre o formulário «Ligar uma fonte de eventos».

No formulário, cole o seu ID da aplicação, o segredo da aplicação e o token de acesso do utilizador. Em seguida, clique em «Ligar».

O plugin recupera as Páginas do Facebook que gere e apresenta-as numa lista. Na lista, selecione a Página cujos eventos pretende apresentar. Em seguida, clique em «Adicionar».

Nota: Tem de ser administrador da página do Facebook da qual pretende apresentar eventos; caso contrário, não serão apresentados eventos.

É tudo o que o plugin precisa. A sua página aparece agora na secção «Gerir fontes» como uma fonte de eventos.

O Custom Facebook Feed Pro trata do token a partir daqui: converte o seu token temporário num token de acesso à Página que não expira. O seu ID da aplicação e o seu segredo da aplicação não são armazenados no seu site.

Assim que vir a sua Página listada aqui, a ligação estará concluída. A fonte aparece como «ainda não utilizada», porque nenhum feed está a extrair dados dela. É exatamente isso que vamos configurar a seguir.

A sua fonte de eventos está pronta a utilizar. Vamos criar o seu primeiro feed de eventos.

No painel de controlo do WordPress, aceda a Feed do Facebook » Todos os feeds e clique em «Adicionar novo». Em seguida, selecione o tipo de feed «Eventos ».

E pronto! A tua fonte de Eventos do Facebook está ligada, sem necessidade de renovação posterior. A seguir, consulta o nosso guia sobre como apresentar eventos do Facebook no seu site para obter o guia completo sobre como criar e personalizar o seu feed de eventos.

Cole o seu Token de acesso do passo 11 no campo abaixo e clique em Ampliar o meu token.

Parabéns! Gerou com êxito o seu Token de Acesso a Eventos. Está a receber um erro ou está bloqueado? Consulte a nossa secção de Resolução de problemas abaixo ou contacte o Apoio ao cliente.

Se estiver a receber a seguinte mensagem de erro:

(#10) Para utilizares o "Acesso ao conteúdo público da página", a tua utilização deste ponto final tem de ser revista e aprovada pelo Facebook. Para enviar esta funcionalidade "Acesso ao conteúdo público da página" para revisão, lê a nossa documentação sobre funcionalidades passíveis de revisão: https://developers.facebook.com/docs/apps/review.

Em seguida, verifique os três aspectos seguintes:

  1. Que é um administrador da página do Facebook da qual está a tentar apresentar publicações
  2. O facto de a aplicação estar no modo "Desenvolvimento" e não "Em direto"
  3. Que selecionou a aplicação e a página do Facebook corretas nos passos 2.2-2.3 e 3.8

Perguntas mais frequentes

A seguir, respondemos a algumas das perguntas mais frequentes sobre como associar os teus eventos do Facebook.

O meu token de acesso tem prazo de validade?

Não. O token que geras no Graph API Explorer é temporário. Quando clicas em «Ligar», o plugin troca-o por um token de acesso à Página que não expira. Não precisas de renovar nada manualmente.

Preciso de publicar a minha aplicação do Facebook ou submetê-la para revisão?

Não. A sua aplicação pode permanecer no modo de desenvolvimento. Uma vez que a aplicação apenas lê eventos de uma página que o utilizador gere, funciona sem necessidade de revisão da aplicação nem de publicação.

De que autorizações precisa a minha aplicação?

A sua aplicação necessita de 5 autorizações no total: business_management, pages_manage_engagement, pages_read_engagement, pages_read_user_content e pages_show_list. A primeira e a última são incluídas automaticamente quando configura o caso de utilização «Gerir tudo na sua Página». O token que gerar no Graph API Explorer tem de ter todas as 5 autorizações selecionadas.

O que significa «Não foram encontradas páginas do Facebook para este token»?

Isso significa que o token que o plugin recebeu ainda não tem acesso a nenhuma das suas Páginas. Gere um novo token no Graph API Explorer com as 5 permissões selecionadas, especialmente a «business_management». Quando a janela pop-up perguntar, autorize o acesso às suas Páginas e Empresas. Se atualizou o plugin recentemente, atualize a página de Configurações com uma atualização completa antes de tentar novamente.

Configurei o meu feed de eventos com um URL do iCal. Preciso de alterar alguma coisa?

Não. Os feeds de eventos existentes que utilizam um URL iCal continuam a funcionar normalmente. A ligação à «Fonte de Eventos» descrita neste guia é a forma de configurar novas ligações de eventos.

As informações da minha aplicação do Facebook ficam armazenadas no meu site?

Apenas o token de acesso da Página associada é armazenado, de forma encriptada. O ID da aplicação e o segredo da aplicação são utilizados uma única vez durante a ligação para recuperar as suas Páginas e não são guardados pelo plugin.

apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto

Este artigo foi útil?