O que é a API do Facebook?
A API do Facebook é um conjunto de soluções que funciona como a principal forma de obter dados dentro e fora da plataforma. Ela permite que desenvolvedores e usuários de apps acessem a funcionalidade desta rede: informações do usuário, fotos e vídeos, mensagens e muito mais.
Bônus: Crie seu widget do Feed do Facebook em apenas alguns minutos!
Como obter a chave de API do Facebook.
Se quiser obter acesso à chave de API do Facebook, registre-se ou faça login com sua conta existente no portal de desenvolvedores e aprove sua identidade. Isso levará apenas alguns passos simples a seguir:
- Passo 1. Faça login ou crie uma conta
Vá para o Portal do Facebook para desenvolvedores e clique em “Entrar”. Você pode fazer login com sua conta existente do Facebook ou criar uma nova.
- Passo 2. Começar
Ao estar dentro do serviço, pressione “Começar” no canto superior direito da página principal
- Etapa 3. Verifique sua conta
Para começar a usar as ferramentas de desenvolvedor, é necessário aprovar sua conta. Clique em “Próximo” no pop-up que aparecer.
Você pode verificar sua conta usando seu número de telefone ou cartão de crédito. Para fazer via número de telefone, selecione seu país no menu suspenso, insira o número com o código do país e clique “Enviar por SMS”. Digite o código recebido no campo e clique “Verificar”
- Passo 4. Crie seu app
Em seguida, o serviço irá orientar você a criar o seu primeiro app. Todas as APIs do Facebook e as estatísticas de Apps ficam monitoradas no Painel de Desenvolvedores, e não é possível acessá-las sem criar um app.
- Etapa 5. Adicione os Apps ou gere Tokens de Acesso para suas próprias necessidades.
A forma mais fácil e conveniente de usar as APIs do Facebook é adicionar os Apps diretamente no painel de controle. Basta escolher aquele que melhor atende às suas necessidades.
Vá para Ferramentas – Graph API Explorer para gerar Tokens de Acesso para vários tipos de API que você deseja usar em seu app. Escolha o aplicativo e o tipo de token de que precisa nos menus suspensos na parte esquerda da tela. Em seguida, clique em “Gerar Token de Acesso”. Você precisará aprovar o acesso do app à sua página.
Como usar os Exemplos da API do Facebook
O produto principal é a Graph API, que serve como base para todos os outros tipos de APIs do Facebook. Elas são, na prática, extensões da Graph API, e todos os produtos do Facebook interagem com ela de alguma forma.
Como você pode tirar proveito do console de desenvolvedores do Facebook e dos produtos disponíveis lá? Existem várias maneiras de aprimorar seu site ou aplicativo usando o conteúdo e algumas das funcionalidades dessa plataforma social.
Você pode exibir diversos tipos de conteúdo de redes sociais – publicações, imagens e vídeos – no seu site ou app para engajar e entreter os usuários.
Mas tenha em mente que, quando a Graph API for implementada para uso de outros usuários, eles também deverão aprovar primeiro em uma janela pop-up. Só depois o usuário autorizar, o aplicativo obterá um token de acesso desse usuário e poderá usar as informações do perfil do Facebook dele.
Limites da API do Facebook
Lembre-se de que cada tipo de API sempre tem limitações. Consultas da Graph API feitas com o token de acesso do app são contadas contra o limite de taxa dessa aplicação. A contagem de chamadas de cada aplicativo é a quantidade de solicitações que ele pode fazer em uma janela de uma hora e é calculada da seguinte forma:<br><br><code>Calls within one hour = 200 * Number of App Users</code>
Integração da API do Facebook
A plataforma oferece várias soluções prontas para não desenvolvedores com base na Graph API. Todos os apps e a API do Facebook são, essencialmente, um conjunto de nós da Graph API. Isso significa que você ainda precisa concluir as Etapas 1–3 descritas acima para criar uma conta e ter acesso ao painel. Abaixo descrevemos as aplicações padrão da API do Facebook mais usadas.
Tipos de API do Feed do Facebook
API da Página do Facebook
Esse tipo de API permite acesso às configurações, conteúdo e métricas de uma página. Ele permite criar e exibir postagens, comentários de uma página, conteúdo de propriedade da página e muito mais. Os detalhes completos 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 app que possua ou possa realizar a tarefa necessária na página.
A segurança de dados ganha ainda mais importância, já que a IA depende de informações pessoais. Esses sistemas precisam de acesso a consultas de clientes, histórico de compras, números de conta e dados de cobrança para funcionar com eficácia, o que implica criptografia em trânsito e em repouso, controles de acesso rigorosos e conformidade com regulamentações como GDPR e CCPA não são negociáveis.
Existem dois tipos fornecidos pelo Facebook – Video API e Live Video API. Ambos publicam vídeos em uma página, grupo ou evento administrado por um usuário de aplicativo. A Video API destina-se a publicar vídeos curtos e longos em uma única página ou em várias páginas e grupos. A Live Video API, 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 de uma combinação deles, dependendo de onde deseja publicar seu vídeo ou transmitir ao vivo.
Eventos da API do Facebook
Este tipo de API também é apresentado como a funcionalidade Graph API, mas está disponível apenas para Facebook Marketing Partners. Também requer um token de acesso do administrador do Evento ou de um Grupo que criou este Evento.
API do Feed de Notícias do Facebook
Você tem duas opções para acessar e usar o feed de notícias do Facebook. A Graph API descrita oferece a possibilidade de acessar um Feed de Usuário separado de atualizações de status e obter posts e links publicados pelo usuário ou por outra pessoa no perfil. Leia mais sobre isso aqui.
Também existe uma API de Feed Público, que permite exibir conteúdo marcado como ‘Público’ em serviços ou sites de terceiros. No entanto, essa chave de API é concedida apenas a editores de mídia aprovados, portanto você precisa se inscrever primeiro.
Você não precisa da API de Grupos do Facebook para exibir o conteúdo no seu site. Use widget de Feed do Facebook! Com ele você tem controle total sobre o conteúdo de que precisa.
API da Comunidade do Facebook
API de Comentários do Facebook
O acesso aos comentários do Facebook pode ser obtido via Graph API. Como os comentários podem aparecer em diferentes tipos de conteúdo, é necessário obter acesso a um objeto para trabalhar com esses comentários.
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 a insígnia ‘positiva’ ou ‘negativa’.
Facebook Tools APIs
API de Login do Facebook
Exemplo de login com Facebook API pode ser visto em muitos serviços web que exigem registro. Isso oferece aos usuários uma forma rápida e segura de efetuar login em um site ou aplicativo. Esta API coleta tokens de acesso dos usuários para obter suas informações de perfil, o que só é possível após a aprovação do usuário. Se você quiser usar esse tipo de API, você precisa ter seu aplicativo revisado e aprovado pela administração do Facebook.
Facebook Places API
Places Graph é uma solução separada do Facebook disponível apenas para Android e iOS. Com ele seu app pode obter informações sobre a localização atual do usuário. Também permite busca e descoberta de lugares, compartilhamento de localização e geotagging. Places API também requer obter tokens de acesso dos usuários. Para integrar e começar a trabalhar com Places API, você precisa obter o Facebook SDK para o seu app 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 no Facebook Payments e processados com base na plataforma. Esse tipo de API também requer um token de acesso para o aplicativo que cria o pagamento.
Facebook Messenger API
Messenger API é um aplicativo que permite organizar um canal de conversa no seu site por meio do Facebook Messenger. A solução Messenger API também possibilita que um desenvolvedor crie conversas guiadas com os usuários. Desse modo, o Messenger pode responder automaticamente a um usuário usando a Send API (também chamada Facebook Bot API), que envia webhooks para a URL do servidor onde o Messenger está hospedado.
Mantenha-se conectado com seus clientes e o público do site com o Botão Messenger gratuito e fácil de instalar!
Tipos de API de Marketing do Facebook
API de Anúncios do Facebook
A Marketing API é um conjunto de endpoints Graph API que ajudam a otimizar a publicidade no Facebook. A Facebook Ads API permite aos usuários criar e gerenciar campanhas, conjuntos de anúncios e unidades de anúncios distintas.
API do Facebook Marketplace
Atualmente existem apenas as categorias Veículos e Imóveis no Facebook Marketplace. Para acessar essa seção da plataforma do Facebook, você precisa criar uma conta de desenvolvedor e verificar o seu negócio. Esta solução oferece o uso da API de Leads juntamente com webhooks de 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 do Facebook Analytics
Esta solução ajuda a rastrear e otimizar o comportamento e a jornada de seus clientes desde dispositivos móveis, web, bots, offline e outras fontes. Para implementá-la, você precisa integrar o Facebook SDK ao seu aplicativo ou site. Você pode saber mais no Analytics Centro de Ajuda.
API do Facebook Business Manager
Últimas Alterações da API
As mudanças da API do Facebook incluem alterações versionadas – aquelas introduzidas com o lançamento de uma nova versão da API. Existem também mudanças não versionadas que são introduzidas fora das liberações normais. Para atualizar para uma versão superior da API do Facebook, existe uma Ferramenta de Atualização de API.
A versão mais recente é a v8.0, lançada recentemente em agosto de 2020. Ela agora traz:
- tipos de app – Negócios, Jogos e Nenhum
- Conquiste curtidas em vídeos ao vivo
- Modelo de Produto no Messenger para lojas enviarem produtos por mensagens
A versão anterior, v7.0, lançada em maio de 2020, ficará disponível até agosto de 2022.
Status da API do Facebook e erros
O status atual da Plataforma está saudável desde 1 de outubro de 2020. No entanto, as solicitações podem, às vezes, gerar várias respostas de erro da API do Facebook com os códigos de erro correspondentes. Por exemplo, o erro da API do Facebook 400 – Bad request – 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 de API |
| 1 | API Desconhecida |
| 2 | Serviço de API |
| 3 | Método de API |
| 4 | Muitas chamadas de API |
| 17 | Usuário de API: muitas chamadas |
| 10 | Permissão de API negada |
| 190 | Token de Acesso expirado |
| 200-299 | Permissão de API (Vários valores dependendo da permissão) |
| 341 | Limite de aplicações atingido |
| 368 | Bloqueado temporariamente por violações de políticas |
| 506 | Post duplicado |
| 1609005 | Erro ao postar link |
A documentação de todos os tipos de APIs para desenvolvedores do Facebook pode ser encontrada na seção Docs do portal de desenvolvedores do Facebook. A lista completa de nós raiz da Graph API pode ser encontrada na seção Facebook API Reference. Cada documentação da API inclui um breve tutorial sobre as permissões necessárias, e também como usar e implementar a API. Ela pode ser encontrada nas seções ‘Getting Started’ e ‘Guides’ de cada documentação específica.
