Como agendar posts de Página do Facebook com a Graph API
As Páginas do Facebook têm agendamento integrado à Graph API: crie o post com published definido como false e scheduled_publish_time com o horário em que deve ir ao ar, e a Meta o retém e publica nesse momento. O guia de Páginas da Meta define o horário entre 10 minutos e 30 dias após a requisição, e GET /{page-id}/scheduled_posts lista o que está aguardando.
O easyCoexistence agenda posts de Página do Facebook na própria fila: peça ao Claude, ao ChatGPT ou ao seu código uma data, um horário e um fuso horário, e publish_facebook_post mantém o texto, o link, a foto ou o vídeo de 1 minuto a 90 dias à frente e os publica nesse momento, com ferramentas para listar, alterar, cancelar e repetir, e um e-mail se falhar.
A janela que o guia de Páginas da Meta define para scheduled_publish_time, contada a partir do momento da requisição à API.
Formas de informar scheduled_publish_time: um timestamp UNIX em segundos, uma string ISO 8601 ou uma string strtotime().
Campo do post que indica se uma publicação agendada de Página já foi publicada.
Maior antecedência que a referência de vídeos da Meta permite para scheduled_publish_time em um post de vídeo.
A edge da Página que retorna as publicações agendadas da Página, lida com um token de acesso de Página.
Com quanta antecedência a fila do easyCoexistence leva um post do Facebook pelo scheduled_at, em comparação com os 30 dias do agendamento próprio da Meta.
Como funciona o agendamento próprio da Meta?
O post é criado de uma vez, sem publicação, e a Meta o retém até o horário definido. Na edge de feed isso significa published definido como false e scheduled_publish_time com o momento em que deve ir ao ar, e as edges de fotos e vídeos usam o mesmo par. Até lá, o post retorna com is_published false e seu scheduled_publish_time, e a edge scheduled_posts da Página o lista.
Com quanta antecedência um post pode ser agendado?
No agendamento próprio da Meta, entre 10 minutos e 30 dias a partir do momento da requisição à API, segundo o guia de Páginas da Meta; suas páginas de referência indicam outros limites, 75 dias na edge de feed e 6 meses para um vídeo. Pelo easyCoexistence, a janela vai de 1 minuto a 90 dias para texto, links, fotos e vídeos, porque o post aguarda na fila do easyCoexistence e não na Meta, e um horário fora dela é recusado antes que qualquer coisa entre na fila.
Como agendar um post pelo MCP?
Informe em publish_facebook_post um scheduled_at em ISO 8601 com fuso horário, junto com o próprio post. A partir do Claude ou do ChatGPT, basta dizer a data, a hora e o fuso horário: o assistente escreve o scheduled_at, o easyCoexistence verifica o post e o enfileira, e o resultado traz scheduled: true e a publicação na fila com seu ID, que as demais ferramentas de fila recebem como post_id. Um post com foto para as 9h, três horas atrás do 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 com a foto ou o vídeo antes da publicação?
O easyCoexistence copia o arquivo para o seu próprio armazenamento quando o post é agendado, então o link original só precisa funcionar naquele momento. Uma página web no lugar de um arquivo, um arquivo ausente, o tipo errado, ou uma imagem acima de 30 MB ou um vídeo acima de 1 GB são recusados já nesse momento, e não no dia da publicação. O limite próprio do Facebook para foto é menor, 10 MB, e a Meta o aplica quando o post vai ao ar, então mantenha a foto da Página abaixo de 10 MB. A cópia é mantida até um dia após a publicação.
O que acontece no horário agendado?
O easyCoexistence publica o post na Página pela edge de feed, de fotos ou de vídeos, como um post comum, então nem a sua IA nem o seu próprio código precisam estar em execução naquele horário. Se a Meta pedir que ele desacelere, o post é repetido após 5 minutos, 30 minutos e 2 horas; qualquer outra falha marca o post como falho e envia um e-mail ao dono da Página, com no máximo um e-mail por Página a cada 3 horas.
Como conferir ou alterar um post agendado?
Com as ferramentas da própria fila, a partir do Claude, do ChatGPT ou do seu código. list_scheduled_posts retorna os posts aguardando, o mais próximo primeiro, ou um único post pelo post_id; update_scheduled_post move um post ou altera seu texto enquanto ele ainda está agendado; cancel_scheduled_post impede que ele seja publicado; retry_scheduled_post repete a publicação de um post que falhou, e pede confirm quando o post pode já ter chegado ao Facebook, para que não seja publicado duas vezes por engano. Para trocar a foto ou o vídeo, cancele o post e agende-o de novo.
Onde os posts agendados aparecem no painel?
Na tela Posts. Precisa de atenção reúne os posts que falharam nos últimos 14 dias, com Repetir, Reconectar e Descartar; Próximos lista os posts agendados em ordem de horário, com Cancelar; Publicados mostra o que foi ao ar, cada um com um link para abri-lo no Facebook. A tela serve para ver e controlar os posts, que vêm da sua IA ou da API.
Como a Meta lista os posts que ela retém?
GET /{page-id}/scheduled_posts, lido com um token de acesso de Página, lista os posts aguardando no agendamento próprio da Meta, e is_published diferencia um post agendado de um publicado, já que leituras de /{page-id}/feed retornam os dois. Os posts enfileirados pelo easyCoexistence não aparecem ali: a Meta os recebe somente no horário definido, então é em list_scheduled_posts que eles aparecem.
Como uma plataforma agenda pela API de parceiros?
POST /channels/:id/posts com o texto, a mídia ou um link e publish_at enfileira um post para a Página de um cliente, e POST /media envia um arquivo antes quando ele não está em uma URL pública. GET /posts lista os posts, PATCH e DELETE /posts/:id alteram ou cancelam um deles, POST /posts/:id/retry repete o envio de um que falhou, e os eventos post.published e post.failed informam cada resultado.
Erros comuns
- Deixar de fora o offset em scheduled_at. O easyCoexistence recusa um horário sem ele, como 2026-11-16T10:00:00 sozinho; acrescente -03:00 ou Z para que a hora não seja lida em outro fuso.
- Definir scheduled_publish_time com menos de 10 minutos de antecedência em uma chamada direta à Graph API. A janela da Meta só abre 10 minutos após a requisição, enquanto a fila do easyCoexistence começa em 1 minuto.
- Confiar em strings relativas de strtotime, como +2 weeks, sem conferir. A Meta sugere reler scheduled_publish_time depois de gravá-lo, para confirmar que a data é a pretendida.
- Trocar a foto de um post agendado com update_scheduled_post. A ferramenta move o post e altera apenas o texto; cancele o post e agende-o de novo com o novo arquivo.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Qual formato scheduled_publish_time aceita?
Um timestamp UNIX em segundos, uma string ISO 8601 ou uma string strtotime().
Qual fuso horário o scheduled_at usa?
O que está escrito nele: scheduled_at é ISO 8601 com um offset como -03:00 ou Z, e o easyCoexistence recusa um horário sem ele, como 2026-11-16T10:00:00 sozinho.
Fotos e vídeos também podem ser agendados?
Sim. As edges de fotos e de vídeos da Meta recebem published definido como false com scheduled_publish_time, e publish_facebook_post enfileira uma foto ou um vídeo da mesma forma que um texto.
Uma foto agendada no Facebook pode ser maior que 10 MB?
Não em uma Página. A fila do easyCoexistence aceita imagens de até 30 MB no momento do agendamento, mas o limite próprio de foto do Facebook é de 10 MB, que a Meta aplica quando o post vai ao ar.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em