Agendamento programático

Um agendador de posts que vive na sua API, não num dashboard.

Em vez de um calendário visual que alguém precisa preencher à mão, o PostGate expõe um recurso de schedules: templates recorrentes com expressão cron ou horários de fila fixos, que materializam posts automaticamente a partir do mesmo envelope usado em uma publicação avulsa.

Comece a construir Ver a documentação de schedules
Dois jeitos de agendar

Cron para regra fixa, filas para o próximo horário livre

Agendamento cron

Um schedule do tipo cron usa o mesmo post, perfis e mídia de POST /api/posts, mas com uma expressão cron e um fuso horário IANA — por exemplo, toda segunda a sexta às 9h.

Filas de horários

Um schedule do tipo slots define horários fixos no dia, como 09:00, 13:30, 18:00. Um post criado com scheduled_at: "queue" pega o próximo horário livre da fila.

Pausar sem perder a configuração

Definir active: false interrompe novas materializações sem apagar o schedule. Mudar a expressão ou o fuso horário reinicia o horizonte de materialização — ajuste com cuidado em produção.

Exemplo

Um template,
posts recorrentes

O template usa o mesmo formato de post da criação avulsa — inclusive suporte a mídia e opções por plataforma. Cada execução materializa um post normal, rastreável pelo ciclo de vida de publicação.

Ver a referência de /api/schedules
POST/api/schedules201 Created
curl -X POST https://postgate.studio/api/schedules \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -d '{
    "name": "Atualização de segunda a sexta",
    "kind": "cron",
    "expression": "0 9 * * 1-5",
    "timezone": "America/Sao_Paulo",
    "template": {
      "post": { "body": "Bom dia da equipe." },
      "profiles": ["pro_linkedin456"],
      "media": []
    }
  }'
Antes de agendar em volume

O que vale saber antes de escalar

01

YouTube não entra na fila recorrente

Cada upload no YouTube exige público, privacidade e confirmação de diretrizes explícitos — por isso o PostGate bloqueia schedules recorrentes para essa plataforma de propósito. Use posts agendados individuais em vez de um template genérico.

03

Agências gerenciam vários clientes na mesma API

Agrupe schedules por profile_group_id e mantenha o agendamento de cada cliente isolado. Veja agendamento de posts para agências.

Comece a construir com o PostGate

Sandbox gratuito, documentação completa e uma API para cada rede social que os seus clientes usam.

Comece a construir Leia a documentação