Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Como agendar publicações de Página do Facebook com a Graph API

As Páginas do Facebook têm agendamento integrado na Graph API: crie a publicação com published definido como false e scheduled_publish_time com a hora em que deve ir ao ar, e a Meta retém-na e publica-a nessa altura. O guia de Páginas da Meta fixa o intervalo entre 10 minutos e 30 dias após o pedido, e GET /{page-id}/scheduled_posts lista o que está à espera.

A easyCoexistence agenda publicações de Página do Facebook na sua própria fila: peça ao Claude, ao ChatGPT ou ao seu próprio código uma data, uma hora e um fuso horário, e a publish_facebook_post retém a publicação com o texto, a ligação, a foto ou o vídeo de 1 minuto a 90 dias de antecedência e publica-a nesse momento, com ferramentas para listar, alterar, cancelar e repetir e um email se falhar.

10 min to 30 days

A janela que o guia de Páginas da Meta define para scheduled_publish_time, contada a partir do momento do pedido à API.

3 formats

Formas de indicar scheduled_publish_time: um timestamp UNIX em segundos, uma cadeia ISO 8601 ou uma cadeia strtotime().

is_published

Campo da publicação que indica se uma publicação agendada de Página já foi publicada.

6 months

Prazo máximo que as referências de vídeo da Meta permitem para scheduled_publish_time numa publicação de vídeo.

scheduled_posts

Ligação (edge) de Página que devolve as publicações agendadas da Página, lida com um token de acesso de Página.

1 min to 90 days

Até quando a fila da easyCoexistence leva uma publicação do Facebook através de scheduled_at, face aos 30 dias do agendamento próprio da Meta.

Como funciona o agendamento nativo da Meta?

A publicação é criada de imediato, não publicada, e a Meta retém-na até à hora definida. Na ligação feed isso significa published definido como false e scheduled_publish_time com o momento em que deve ir ao ar, e as ligações de fotos e vídeos recebem o mesmo par. Até lá, a publicação devolve is_published false e o seu scheduled_publish_time, e a ligação scheduled_posts da Página lista-a.

Com que antecedência se pode agendar uma publicação?

Com o agendamento nativo da Meta, entre 10 minutos e 30 dias a partir do momento do pedido à API, segundo o guia de Páginas da Meta; as suas páginas de referência indicam outros limites, 75 dias na ligação feed e 6 meses para um vídeo. Através da easyCoexistence, a janela vai de 1 minuto a 90 dias, da mesma forma para texto, ligações, fotos e vídeos, porque a publicação espera na fila da easyCoexistence e não na Meta, e uma hora fora dessa janela é recusada antes de entrar na fila.

Como se agenda uma publicação através do MCP?

Indique a publish_facebook_post um scheduled_at em ISO 8601 com fuso horário, junto com a própria publicação. A partir do Claude ou do ChatGPT, basta dizer a data, a hora e o fuso horário: o assistente escreve scheduled_at, a easyCoexistence verifica a publicação e coloca-a na fila, e o resultado traz scheduled: true e a publicação agendada com o seu ID, que as outras ferramentas de fila recebem como post_id. Uma publicação com foto para as 9 da manhã, três horas atrás de UTC:

publish_facebook_post arguments for a scheduled photo
{
  "account_id": "<ACCOUNT_ID>",
  "message": "Doors open at 9 on Saturday.",
  "image_url": "https://example.com/flyer.jpg",
  "scheduled_at": "2026-11-14T09:00:00-03:00"
}

O que acontece à foto ou ao vídeo antes de a publicação ser feita?

A easyCoexistence copia-o para o seu próprio armazenamento quando a publicação é agendada, pelo que a ligação original só tem de funcionar nesse momento. Uma página web em vez de um ficheiro, um ficheiro em falta, o tipo errado, ou uma imagem acima de 30 MB ou um vídeo acima de 1 GB é recusado nesse momento, e não no dia da publicação. O limite próprio do Facebook para uma foto é mais baixo, 10 MB, e a Meta aplica-o quando a publicação é feita, por isso mantenha as fotos da Página abaixo de 10 MB. A cópia é guardada até um dia depois de a publicação ser feita.

O que acontece na hora agendada?

A easyCoexistence publica a publicação na Página através das ligações feed, photos ou videos, como uma publicação comum, por isso nem a sua IA nem o seu próprio código têm de estar a correr a essa hora. Se a Meta pedir que abrande, a publicação volta a ser tentada passados 5 minutos, 30 minutos e 2 horas; qualquer outra falha marca-a como falhada e envia um email ao proprietário da Página, com no máximo um email por Página em cada 3 horas.

Como se verifica ou altera uma publicação agendada?

Com as próprias ferramentas da fila, a partir do Claude, do ChatGPT ou do seu próprio código. list_scheduled_posts devolve as publicações à espera, da mais próxima para a mais distante, ou uma só publicação pelo post_id; update_scheduled_post move uma publicação ou altera o seu texto enquanto ainda estiver agendada; cancel_scheduled_post impede que saia; retry_scheduled_post volta a publicar uma publicação falhada, e pede confirm quando a publicação possa ter chegado ao Facebook de qualquer forma, para não ser publicada duas vezes por engano. Para alterar a foto ou o vídeo, cancele a publicação e agende-a de novo.

Onde aparecem as publicações agendadas no painel?

No ecrã Publicações. Requer atenção reúne as publicações que falharam nos últimos 14 dias, com Tentar novamente, Voltar a ligar e Dispensar; Próximas lista as publicações agendadas por ordem de hora, com Cancelar; Publicadas mostra o que foi publicado, cada uma com uma ligação para a abrir no Facebook. O ecrã serve para ver e controlar as publicações, que vêm da sua IA ou da API.

Como é que a Meta lista as publicações que retém?

GET /{page-id}/scheduled_posts, lido com um token de acesso de Página, lista as publicações à espera no agendamento próprio da Meta, e is_published distingue uma publicação agendada de uma publicada, já que as leituras de /{page-id}/feed devolvem as duas. As publicações em fila através da easyCoexistence não aparecem aí: a Meta só as recebe na hora definida, por isso é em list_scheduled_posts que se veem.

Como é que uma plataforma agenda através da API de Parceiros?

POST /channels/:id/posts, com o texto, o ficheiro multimédia ou uma ligação e publish_at, coloca na fila uma publicação para a Página de um cliente, e POST /media carrega primeiro um ficheiro quando este não está num URL público. GET /posts lista as publicações, PATCH e DELETE /posts/:id alteram ou cancelam uma, POST /posts/:id/retry volta a enviar uma falhada, e os eventos post.published e post.failed informam cada resultado.

Erros comuns

  • Deixar de fora o deslocamento horário em scheduled_at. A easyCoexistence recusa uma hora sem ele, como 2026-11-16T10:00:00 sozinho; acrescente -03:00 ou Z para que a hora não possa ser lida noutro fuso.
  • Definir scheduled_publish_time com menos de 10 minutos de antecedência numa chamada direta à Graph API. A janela da Meta abre 10 minutos após o pedido, enquanto a fila da easyCoexistence começa aos 1 minuto.
  • Confiar em cadeias strtotime relativas, como +2 weeks, sem verificar. A Meta sugere ler scheduled_publish_time de volta depois de o escrever, para confirmar que a data é a pretendida.
  • Mudar a foto de uma publicação agendada com update_scheduled_post. A ferramenta move a publicação e altera apenas o texto; cancele a publicação e agende-a de novo com o ficheiro novo.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Que formato tem scheduled_publish_time?

Um timestamp UNIX em segundos, uma cadeia ISO 8601 ou uma cadeia strtotime().

Que fuso horário usa scheduled_at?

O que nela está escrito: scheduled_at é ISO 8601 com um deslocamento como -03:00 ou Z, e a easyCoexistence recusa uma hora sem ele, como 2026-11-16T10:00:00 sozinho.

Também se podem agendar fotos e vídeos?

Sim. As ligações de fotos e vídeos da Meta aceitam published definido como false com scheduled_publish_time, e a publish_facebook_post agenda uma foto ou um vídeo da mesma forma que um texto.

Uma foto de Facebook agendada pode ter mais de 10 MB?

Não numa Página. A fila da easyCoexistence aceita imagens até 30 MB no momento do agendamento, mas o limite próprio de fotos do Facebook é 10 MB, que a Meta aplica quando a publicação é feita.

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