API de publicações em Páginas do Facebook: publicar texto, links, fotos e vídeos
A Graph API publica quatro tipos de publicação numa Página: texto e links através de POST /{page-id}/feed, uma foto através de /{page-id}/photos a partir de um URL já disponível na internet, e um vídeo através de /{page-id}/videos a partir de um URL de ficheiro acessível. As publicações aparecem com a voz da Página, precisam de um token de acesso da Página com pages_manage_posts e podem ficar por publicar até à data agendada.
A easyCoexistence publica em Páginas do Facebook com o publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código: texto, um link, uma foto ou um vídeo, já ou agendado até 90 dias à frente a partir da fila da easyCoexistence, e o list_social_posts lê as publicações de volta.
Maior ficheiro de foto que a Meta aceita numa Página; a Meta recomenda manter os ficheiros PNG abaixo de 1 MB para evitar pixelização.
Tipos de ficheiro de foto que a Meta indica para as fotos de Página: JPEG, BMP, PNG, GIF e TIFF.
Código de erro quando a Meta não consegue obter o ficheiro de vídeo a partir do URL indicado em /{page-id}/videos.
Publicações classificadas e publicadas por ano que a API devolve ao ler o feed de uma Página, no máximo 100 por pedido.
Que conteúdo pode levar uma publicação numa Página?
Quatro tipos de conteúdo, através de três pontos de entrada da Página, e as publicações aparecem com a voz da Página. Texto e links partilham o ponto feed, onde é obrigatório haver message ou link; cada foto e cada vídeo tem um ponto próprio:
Como é que o publish_facebook_post escolhe o ponto?
Pelo que recebe. Um video_url vai para /videos com message como descrição; caso contrário, um image_url vai para /photos com message como texto; caso contrário, message e link vão para /feed. Um link só segue numa publicação de texto, por isso, com uma foto ou um vídeo, coloque o URL na message. Sem scheduled_at, a publicação sai de imediato e o resultado traz post_id, o ID devolvido pela Meta, e url, a sua ligação no Facebook; com scheduled_at, a easyCoexistence mantém a publicação na sua fila, entre 1 minuto e 90 dias à frente, e publica-a nessa altura.
Onde é que o conteúdo multimédia tem de estar?
Num endereço que a Meta consiga alcançar, porque a Meta obtém o ficheiro por si própria. No caso de uma foto, url é uma foto já carregada para a internet; num vídeo, file_url é um URL acessível do ficheiro, e um vídeo que a Meta não consiga obter falha com o erro 389. Uma publicação com link falha quando a aplicação não consegue ver o URL associado, e o erro 1609005 significa que a Meta não conseguiu extrair dados do link.
Que ficheiros de foto a Meta aceita?
Ficheiros JPEG, BMP, PNG, GIF e TIFF até 10 MB, segundo a referência de fotos da Meta, que recomenda manter os ficheiros PNG abaixo de 1 MB, porque os maiores podem aparecer pixelizados. A Meta remove os metadados de localização antes de publicar e redimensiona as imagens para serem apresentadas em vários tamanhos. Uma imagem em falta ou inválida falha com o erro 324.
O que precisa uma publicação de vídeo?
Um ficheiro que a Meta consiga obter a partir de file_url, com o texto da publicação em description, que a Meta pode mostrar com a publicação; um título é opcional, e o publish_facebook_post deixa-o por definir. A visão geral da Video API da Meta diz que a pessoa por detrás do token deve conseguir executar tarefas equivalentes às de administrador na Página, e a Resumable Upload API trata de ficheiros grandes, retomando os carregamentos interrompidos.
Como se leem e editam as publicações?
list_social_posts devolve as publicações recentes da Página, 25 por defeito e até 100 por chamada, cada uma com o seu ID, texto, data de criação, permalink e imagem. A referência da Meta limita a leitura do feed a 100 publicações por pedido e devolve cerca de 600 publicações classificadas e publicadas por ano. A API da Meta edita uma publicação com POST /{page-post-id} e a nova message, apenas em publicações feitas com a mesma aplicação; a easyCoexistence não tem ferramenta para isso, por isso uma publicação edita-se no Facebook ou no Meta Business Suite.
Erros comuns
- Passar um link com uma foto ou um vídeo. O publish_facebook_post recusa um link junto de um ficheiro, por isso coloque o URL na message quando a publicação tiver conteúdo multimédia.
- Publicar duas vezes seguidas o mesmo conteúdo. A Meta recusa publicações duplicadas consecutivas com o erro 506, por isso altere o texto antes de voltar a tentar.
- Apontar para um ficheiro atrás de um início de sessão ou para um link prestes a expirar. A Meta obtém a foto ou o vídeo a partir do próprio URL, por isso o endereço tem de continuar público até a publicação ficar online.
De US$ 9 a US$ 0.75 por ligação por mês, com descida à medida que acrescenta ligações, e com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso publicar uma foto numa Página do Facebook a partir de um URL?
Sim. POST /{page-id}/photos recebe url, o endereço de uma foto já disponível na internet, e a Meta obtém-na por si própria.
Porque falha uma publicação numa Página do Facebook com o erro 506?
A Meta recusa publicações duplicadas consecutivas com o erro 506, por isso altere o texto antes de voltar a publicar.
Pode uma publicação do Facebook levar várias fotos?
Não através da easyCoexistence: publish_facebook_post aceita uma fotografia. A Meta documenta publicações com várias fotos, criadas a partir de fotos carregadas sem publicar e anexadas a uma publicação do feed, que as suas ferramentas não cobrem.
Posso editar uma publicação numa Página do Facebook através da API?
Sim, com POST para o ID da publicação, mas apenas para publicações feitas com a mesma aplicação. A easyCoexistence não tem ferramenta para isso, por isso edite a publicação no Facebook ou no Meta Business Suite.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em