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.
A janela que o guia de Páginas da Meta define para scheduled_publish_time, contada a partir do momento do pedido à API.
Formas de indicar scheduled_publish_time: um timestamp UNIX em segundos, uma cadeia ISO 8601 ou uma cadeia strtotime().
Campo da publicação que indica se uma publicação agendada de Página já foi publicada.
Prazo máximo que as referências de vídeo da Meta permitem para scheduled_publish_time numa publicação de vídeo.
Ligação (edge) de Página que devolve as publicações agendadas da Página, lida com um token de acesso de Página.
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:
{
"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.
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