Visão geral
A API de Páginas é um conjunto de pontos de extremidade da Graph API do Facebook que os apps podem usar para criar e gerenciar as configurações e o conteúdo de uma Página.
Componentes
Tokens de acesso
A autenticação da API é feita pelos tokens de acesso. A maioria dos pontos de extremidade exige tokens de acesso à Página, que são únicos para cada Página, usuário do app e app, além de terem uma data de validade. Para obter um token de usuário de app, o usuário deve ser proprietário da Página ou poder realizar uma tarefa nela.
Para obter tokens de acesso dos usuários do seu app, implemente o Login do Facebook.
Para as Páginas que foram migradas para a nova experiência da Página, agora é necessário ter um token de acesso à Página para todos os pontos de extremidade disponíveis com as seguintes exceções:
Graph API
Caso você não conheça a Graph API, leia a documentação correspondente antes de continuar para saber mais sobre o gráfico social da Meta.
Login do Facebook
O Login do Facebook permite que usuários entrem no seu app. Ele também permite que seu app solicite a permissão do usuário para acessar dados.
Login do Facebook para Empresas
O Login do Facebook para Empresas é a solução de autorização e autenticação mais escolhida entre Provedores de Tecnologia e desenvolvedores de apps de empresa que precisam ter acesso aos ativos de clientes comerciais.
Recursos
Após a publicação do seu app, alguns pontos de extremidade precisam de um recurso que deve ser aprovado por meio do processo de análise antes de o app poder usá-los. Os recursos permitem que você acesse dados públicos da Página sem uma permissão ou a capacidade de executar uma tarefa na Página. Consulte a referência de cada ponto de extremidade para saber qual recurso de Página é necessário.
Menções
@menções permitem que sua Página responda publicamente, por meio de um comentário ou uma resposta, para uma pessoa específica, que publicou na sua Página ou comentou na publicação da Página.
Números de identificação do usuário no escopo da Página
Os usuários que interagem com Páginas são identificados por números de identificação do usuário no escopo da Página (PSID, pelas iniciais em inglês). Os PSIDs são números de identificação únicos para cada par usuário-página. Os pontos de extremidade da API de Páginas e da Plataforma do Messenger dependem de PSIDs para que você possa identificar as interações de um usuário com uma Página, incluindo as conversas públicas entre o usuário e a Página em questão no Messenger.
Permissões
A maioria dos pontos de extremidade exige uma ou mais permissões que devem ser concedidas ao app pelos usuários. Normalmente, isso pode ser feito por meio do Login do Facebook. Caso uma empresa tenha obtido o app, também é possível usar o Gerenciador de Negócios.
Após a publicação, todas as permissões requerem uma análise do app antes de um usuário poder concedê-las. Para os apps de empresa (que não têm modos), as permissões precisam ser aprovadas para acesso avançado a fim de serem concedidas por usuários sem função no app ou na empresa que o obteve.
Pesquisa da Página
Encontre informações sobre as Páginas do Facebook, incluindo nomes, localizações e encontre Páginas para @menção, localizações de Página e marque uma Página para mostrar conteúdo de marca.
Limites de volume
Todas as solicitações de ponto de extremidade das Páginas estão sujeitas à limitação de volume. Veja o consumo atual de contagem de chamadas do seu app no Painel de Apps.
Tarefas
As tarefas permitem que os usuários desempenhem ações específicas em uma Página. Quando um usuário usa um app para interagir com uma Página, dependendo da ação pretendida, primeiro verificaremos se o usuário foi aprovado para uma tarefa que permite esse tipo de ação.
É possível aprovar usuários individuais para as seguintes tarefas:
| Tarefa | Ações permitidas |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Se tiver acesso à Página como administrador na interface do usuário, a pessoa poderá executar todas as tarefas.
Plataforma do Messenger
Tenha conversas no Messenger com clientes ou pessoas interessadas na sua Página.
Webhooks da Meta para Páginas
Receba notificações em tempo real assim que um usuário comentar em uma publicação da Página ou reagir à publicação da sua Página.
Análise do app
Todas as permissões e recursos relacionados à Página requerem aprovação por meio do processo de análise antes do seu app poder usá-los após a publicação.
No modo de desenvolvimento, os apps podem solicitar qualquer permissão de qualquer usuário que tenha uma função no app.
Como funciona
Este é um fluxo típico para acessar a API de Páginas:
- Obtenha um token de acesso do usuário do app por meio do Login do Facebook.
- Consulte o ponto de extremidade
/me/accountspara obter o ID e o token de acesso à Página que o usuário permitiu que seu app acessasse. - Capture o ID da Página retornado e o token de acesso à Página.
- Use o ID e o token para consultar o nó da Página.
Observe que o usuário pode conceder ao seu app acesso a mais de uma Página. Nesse caso, você deve capturar o ID de cada Página e o respectivo token, além de fornecer uma maneira de o usuário ser direcionado para cada uma das Páginas.
Próximas etapas
Siga nosso Guia de introdução para aprender a fazer uma publicação da Página usando a API de Páginas.
Veja também
Desenvolvimento do app com a MetaAutenticação e autorização | Guias da PáginaReferências |