Tudo sobre a API do Facebook: como obtê-la e usá-la
- 1. O que é o Facebook API?
- 2. Como obter a chave do Facebook API
- 3. Como usar Exemplos de API do Facebook
- 4. Integração da API do Facebook
- 5. Últimas mudanças na API
- 6. Status e Erros da API do Facebook
- 7. Documentação da API do Facebook
- Bônus: crie um widget para exibir conteúdo de Mídia Social em seu site!
O que é o Facebook API?
O Facebook API é um conjunto de soluções usado como forma principal de obter dados dentro e fora da plataforma. Ele permite que desenvolvedores e usuários de aplicativos acessem a funcionalidade dessa rede: informações do usuário, fotos e vídeos, mensagens e muito mais.
BÔNUS: Crie seu widget de Feed do Facebook em apenas alguns minutos!
Como obter a chave do Facebook API.
Se você deseja obter acesso à chave do Facebook API, deve se registrar ou fazer login com sua conta do Facebook existente no portal para desenvolvedores e aprovar sua identidade. Isso levará apenas alguns passos simples a seguir:
- Passo 1. Faça login ou crie uma conta
Acesse o portal do Facebook para desenvolvedores e clique em “Fazer login”. Você pode fazer login com sua conta do Facebook existente ou criar uma nova
- Passo 2. Comece
Quando você estiver dentro do serviço, clique em “Começar” no canto superior direito da página principal
- Passo 3. Verifique sua conta
Para começar a trabalhar com as ferramentas de desenvolvedor, você precisa aprovar sua conta. Clique em “Próximo” no pop-up que aparece
Você pode verificar sua conta usando seu número de telefone ou cartão de crédito. Para fazer isso via número de telefone, escolha seu país no menu suspenso, insira seu telefone com o código do país e clique em “Enviar por SMS”. Insira o código adquirido no campo e clique em “Verificar”
- Passo 4. Crie seu aplicativo
Então o serviço oferecerá a você a criação do seu primeiro aplicativo. Todas as APIs e estatísticas de aplicativos do Facebook são rastreadas no Painel do Desenvolvedor e não podem ser acessadas sem criar um aplicativo.
- Passo 5. Adicione os Aplicativos ou gere Tokens de Acesso para suas necessidades próprias
A maneira mais fácil e conveniente de usar as APIs do Facebook é adicionar os Aplicativos diretamente no Painel. Basta escolher aquele que corresponde às suas necessidades.
Acesse Ferramentas – Explorador de Graph API para gerar Tokens de Acesso para vários tipos de API que você gostaria de usar em seu aplicativo. Escolha o aplicativo e o tipo de token que você precisa nos menus suspensos na parte esquerda da tela. Em seguida, clique em “Gerar Token de Acesso”. Você terá que aprovar o acesso do aplicativo à sua página.
Como usar Exemplos de API do Facebook
O principal produto é o Graph API, que serve como base para todos os outros tipos de APIs do Facebook. Eles são essencialmente extensões do Graph API, e todos os produtos do Facebook interagem com ele de alguma forma.
Que uso você pode fazer do console de desenvolvedores do Facebook e dos produtos fornecidos lá? Existem várias maneiras de melhorar seu site ou aplicativo usando o conteúdo e algumas das funcionalidades desta plataforma social.
Você pode exibir vários tipos de conteúdo de mídia social – postagens, imagens, vídeos – em seu site ou aplicativo para envolver e entreter os usuários.
Mas tenha em mente que quando o Graph API é implementado para ser usado por outros usuários, eles também terão que aprovar primeiro em um pop-up. Somente após um usuário autorizar, o aplicativo receberá um token de acesso deste usuário e poderá usar suas informações do perfil do Facebook.
Limites da API do Facebook
Lembre-se de que todo tipo de API sempre tem limitações. As consultas do Graph API feitas dentro do token de acesso do aplicativo são contadas em relação ao limite de taxa desse aplicativo. A contagem de chamadas de cada aplicativo é a quantidade de solicitações que ele pode fazer durante uma janela de uma hora e é calculada da seguinte forma:Chamadas dentro de uma hora = 200 * Número de Usuários do Aplicativo
Integração da API do Facebook
A plataforma fornece várias soluções prontas para não desenvolvedores com base em seu Graph API. Todos os aplicativos e APIs do Facebook são essencialmente um conjunto ou coleção de nós do Graph API. Isso significa que você ainda precisa concluir os Passos 1-3 descritos acima para criar uma conta e obter acesso ao painel. Abaixo descrevemos os aplicativos padrão da API do Facebook mais comumente usados.
Tipos de API de Feed do Facebook
API de Página do Facebook
Este tipo de API permite acesso às configurações, conteúdo e métricas de uma página. Ele permite que você crie e exiba postagens, comentários de uma página, conteúdo de propriedade da página e muito mais. Todos os detalhes podem ser encontrados na Documentação da API de Páginas. Não se esqueça de que você precisa de um token de um usuário do aplicativo que possua ou possa realizar uma tarefa necessária na página.
API de Vídeo do Facebook
O Facebook fornece dois tipos – API de Vídeo e API de Vídeo ao Vivo. Ambos postam vídeos em uma página, grupo ou evento administrado por um usuário do aplicativo. A API de Vídeo é destinada à publicação de vídeos curtos e longos em uma ou várias páginas e grupos. A API de Vídeo ao Vivo, por sua vez, é usada para agendar uma transmissão ao vivo, transmitir um vídeo em um perfil de usuário, grupo ou evento e também interagir com o público que assiste. E, é claro, você precisa de tokens de acesso para páginas, grupos ou eventos ou uma combinação deles, dependendo de onde deseja colocar seu vídeo ou transmissão ao vivo.
Eventos da API do Facebook
Este tipo de API também é apresentado como funcionalidade do Graph API, mas está disponível apenas para Parceiros de Marketing do Facebook. Também requer um token de acesso do administrador do Evento ou de um Grupo que criou este Evento.
API de Feed de Notícias do Facebook
Você tem duas opções para acessar e usar o feed de notícias do Facebook. O Graph API descrito oferece a oportunidade de acessar um Feed de Usuário separado de atualizações de status e obter API de postagens e links publicados pelo usuário ou outra pessoa no perfil. Você pode ler mais sobre isso aqui.
Também há uma API de Feed Público, que torna possível exibir o conteúdo marcado como ‘Público’ no serviço ou site de terceiros. Mas esse tipo de chave de API é concedido apenas a editores de mídia aprovados, então você precisa se inscrever primeiro.
Você não precisa do Facebook Group API para exibir seu conteúdo em seu site. Use o widget de Feed do Facebook! Com ele, você tem controle total sobre o conteúdo que precisa.
Facebook Community API
API de Comentário do Facebook
O acesso aos comentários no Facebook pode ser obtido por meio da Graph API. Como os comentários podem ser deixados em vários tipos de conteúdo, você precisa obter acesso a um objeto para trabalhar com os comentários nele.
API de Avaliações do Facebook
Esta parte da Graph API representa objetos que contêm uma recomendação. Os campos padrão incluem data, classificação por estrelas, texto da avaliação, informações do usuário e distintivo ‘positivo’ ou ‘negativo’.
Se deseja ter mais controle sobre as avaliações exibidas, você pode ajustar o Plugin de Avaliação de acordo com suas preferências.
Facebook Tools APIs
API de Login do Facebook
O exemplo de login da API do Facebook pode ser visto em muitos serviços da web que requerem registro. Isso proporciona aos usuários uma maneira rápida e segura de fazer login em um site ou aplicativo. Esta API coleta os tokens de acesso dos usuários para obter suas informações de perfil, o que é possível apenas após a aprovação do usuário. Se você deseja usar este tipo de API, deve obter a aprovação do seu aplicativo pela administração do Facebook.
API de Lugares do Facebook
O Places Graph é uma solução separada do Facebook disponível apenas para plataformas Android e iOS. Com ele, seu aplicativo pode obter informações sobre a localização atual dos usuários. Ele também permite a pesquisa e descoberta de lugares, compartilhamento de localização e marcação geográfica. A API de Lugares também requer obtenção de tokens de acesso dos usuários. Para integrar e começar a trabalhar com a API de lugares, você precisa obter o SDK do Facebook para o seu aplicativo primeiro.
API de Pagamentos do Facebook
A API de pagamento inclui os detalhes de um pagamento feito em um determinado aplicativo. Esses pagamentos são criados nos pagamentos do Facebook e processados com base na plataforma. Este tipo de API também requer um token de acesso para um aplicativo que cria um pagamento.
API do Messenger do Facebook
A API do Messenger é um aplicativo que permite que você organize um canal de conversa em seu site por meio do Messenger do Facebook. A solução da API do Messenger também permite que um desenvolvedor crie uma conversa guiada com os usuários. Desta forma, o mensageiro pode responder automaticamente a um usuário usando a API de Envio (também chamada de API de Bot do Facebook), que envia webhooks para o URL do servidor, onde o mensageiro está hospedado.
Fique conectado com seus clientes e público do site com um Botão de Mensagem gratuito e fácil de instalar!
Tipos de API de Marketing do Facebook
API de Anúncios do Facebook
A API de Marketing é um conjunto de endpoints da Graph API que ajudam a otimizar a publicidade no Facebook. A API de Anúncios do Facebook permite que os usuários criem e gerenciem campanhas publicitárias, conjuntos de anúncios e unidades de anúncios separadas.
API de Marketplace do Facebook
Atualmente, existem apenas categorias de Veículos e Imóveis no Marketplace do Facebook. Para acessar esta seção da plataforma do Facebook, você precisa criar uma conta de desenvolvedor e verificar sua empresa. Esta solução oferece o uso da API de Lead junto com webhooks do desenvolvedor para melhor desempenho. Para isso, você precisa criar seu aplicativo conforme descrito anteriormente neste artigo e enviá-lo para Revisão para ser aprovado pelo Facebook.
API de Análise do Facebook
Esta solução ajuda a rastrear e otimizar o comportamento e a jornada de seus clientes a partir de dispositivos móveis, web, bots, offline e outros recursos. Para implementá-lo, você precisa integrar o SDK do Facebook em seu aplicativo ou site. Você pode aprender mais no Centro de Ajuda de Análise.
API do Gerenciador de Negócios do Facebook
Últimas Mudanças na API
As mudanças na API do Facebook incluem alterações versionadas – aquelas que são introduzidas com o lançamento de uma nova versão da API. Também há mudanças não versionadas que são introduzidas fora dos lançamentos normais. Para atualizar para uma versão superior da API do Facebook, existe uma Ferramenta de Atualização da API especial.
A versão mais recente é a v8.0, lançada recentemente em agosto de 2020. Agora inclui:
- tipos de aplicativo – Negócios, Jogos e Nenhum
- obtenção de Curtidas para Vídeos ao Vivo
- Modelo de Produto no Messenger para Lojas enviar produtos como mensagens
A versão anterior v7.0, lançada em maio de 2020, estará disponível até agosto de 2022.
Status e Erros da API do Facebook
O status atual da plataforma está saudável desde 1 de outubro de 2020. Mas as solicitações feitas às vezes resultam em várias respostas de erro da API do Facebook com os respectivos códigos de erro. Por exemplo, o erro 400 da API do Facebook – Solicitação inválida – significa que uma consulta não é mais suportada e você precisa gerar um novo token de acesso. Aqui estão alguns outros:
| Código | Nome |
| 102 | Sessão da API |
| 1 | Desconhecido da API |
| 2 | Serviço da API |
| 3 | Método da API |
| 4 | Demasiadas chamadas da API |
| 17 | Usuário faz demasiadas chamadas da API |
| 10 | Permissão negada da API |
| 190 | O Token de Acesso expirou |
| 200-299 | Permissão da API (Múltiplos valores dependendo da permissão) |
| 341 | Limite de Aplicativos atingido |
| 368 | Bloqueio temporário por violações de políticas |
| 506 | Postagem duplicada |
| 1609005 | Erro ao Publicar Link |
Documentação da API do Facebook
A documentação de todos os tipos de APIs de desenvolvedores do Facebook pode ser encontrada na seção Documentação do portal de desenvolvedores do Facebook. A lista completa de nós raiz da Graph API pode ser encontrada na seção Referência da API do Facebook. Cada documentação da API inclui um breve tutorial sobre as permissões necessárias e também sobre como usar e implementar. Pode ser encontrado nas seções ‘Introdução’ e ‘Guias’ de cada documentação específica.