Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

10 MB

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.

5 types

Tipos de ficheiro de foto que a Meta indica para as fotos de Página: JPEG, BMP, PNG, GIF e TIFF.

389

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.

About 600

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:

TextPOST /{page-id}/feed with message, the body of the post
LinkPOST /{page-id}/feed with link, the URL to attach
PhotoPOST /{page-id}/photos with url, a photo already online
VideoPOST /{page-id}/videos with file_url and a description

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.
Fazer isto com a EasyCoexistence

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