Planejamento centralizado
Você organiza calendário, legenda, thumbnail, redes e horário em um único composer.
Guia oficial em português
Entenda o fluxo inteiro do Agendador Online, da conexão à confirmação da publicação.
Esta página explica como a plataforma funciona hoje, o que está estável em produção, como separar contas, como montar um post, o que cada rede suporta e onde verificar falhas ou necessidade de reconexão.
Integrações separadas por conta
Cada workspace do Agendador mantém seus próprios vínculos com YouTube, Facebook, Instagram e TikTok.
Diagnóstico por plataforma
Cada destino mostra seu próprio status, erro e identificador externo quando a publicação termina.
Como começa
Primeiro acesso e separação de contas
O Agendador usa a conta do produto para decidir onde salvar posts e integrações. A conta do Google, Meta ou TikTok é usada apenas para autorização da rede.
Quando você entra no Agendador Online, a plataforma cria uma sessão da sua conta de produto. É essa sessão que separa dashboard, calendário, integrações e posts.
Em seguida, cada integração social é vinculada à conta atual. Isso significa que duas contas ou workspaces diferentes podem usar redes diferentes, sem misturar agenda, histórico ou publicação.
Se uma rede estiver com token expirado, mudança de asset ou grant inconsistente, o painel mostra Precisa reconectar antes de publicar.
Fluxo do produto
O ciclo completo de um post
O fluxo principal foi desenhado para reduzir trabalho repetido: conectar, montar, validar, agendar e acompanhar.
01
Conecte as redes
Abra Integrações, autorize cada plataforma e confira se o status está como pronto para publicar.
02
Monte o post
Envie o arquivo: as redes conectadas já saem pré-selecionadas, o TikTok já vem público com comentários, Duet e Stitch liberados, e a legenda é sugerida a partir do nome do arquivo. Ajuste só o que quiser mudar.
03
Escolha o horário
Agende uma data futura, publique agora ou use a fila recorrente para distribuir a agenda.
04
Acompanhe o retorno
O painel mostra cada plataforma em processamento, publicada ou com erro, sem misturar resultados.
Onde cada coisa fica
Dashboard, Integrações e Configurações
A plataforma foi organizada para separar operação, conexão e dados da conta.
Dashboard
Visão do dia, próximos envios, melhores horários, fila de publicação e saúde das integrações.
Integrações
Painel de conexão por rede, com estados como conectado, precisa reconectar e pronto para publicar.
Configurações
Dados da conta, nome exibido, bio, links públicos, senha e preferências do perfil.
Composer
Como o agendamento funciona na prática
O composer foi pensado para caber mais decisão útil na mesma tela.
Ao clicar em um dia vazio do calendário, o composer abre já naquela data para você montar um novo envio. Você pode publicar agora ou agendar para outro horário.
Assim que a mídia é enviada, o composer já pré-seleciona as redes conectadas compatíveis com aquele tipo de arquivo (vídeo habilita YouTube, Instagram, Facebook e TikTok; imagem habilita Instagram e Facebook), sugere uma legenda a partir do nome do arquivo e, para TikTok, já define privacidade pública com comentários, Duet e Stitch liberados. Você só precisa ajustar o que quiser mudar antes de confirmar.
O editor aceita legenda base e ajuste por rede. Isso permite manter a mesma mídia e adaptar título, descrição ou legenda sem duplicar o post inteiro.
A barra inferior do composer concentra data, hora e ação principal para evitar rolagem longa até o botão final.
Dica operacional
Antes de salvar um post grande, confirme se todas as redes marcadas estão em pronto para publicar no painel de Integrações.
Suporte por rede
O que cada plataforma suporta hoje
A documentação pública deve refletir apenas o que está operacionalmente estável.
YouTube
HojePublicação automática de vídeo
Título, descrição, thumbnail de vídeo, agendamento e confirmação por vídeo publicado.
Publicação automática de vídeo e imagem
Fluxo com status por upload e retorno do ID remoto quando o post entra no Facebook.
Publicação automática de vídeo e imagem
Reels no fluxo principal, com suporte a post de imagem no feed quando o envio é feito só para Instagram e Facebook.
TikTok
HojeDirect Post e envio para rascunhos
Publicação direta aprovada com privacidade, Duet, Stitch, comentários, consentimento e disclosure comercial.
Uso diário
Como usar no dia a dia
A ideia é que uma pessoa consiga operar sem adivinhar onde faz cada ação.
Como agendar pelo painel
Abra o dashboard, clique em um dia vazio do calendário, envie a mídia, escolha as redes, ajuste a legenda e confirme data e hora no composer.
Como ver o que já está agendado
Use a visão do calendário e a fila de publicação. Os cards pendentes mostram data, hora, plataformas e estado atual de cada destino.
Como saber se a rede está pronta
Abra Integrações. O estado pronto para publicar indica que a conexão foi validada e não há reconexão pendente.
Como entender se deu certo
Depois do disparo, cada destino do post muda para processando, publicado ou com erro. Quando publicado, o sistema grava o identificador remoto.
Leitura rápida
O que observar antes de agendar
Esses pontos evitam a maior parte das falhas operacionais.
Confira se a mídia carregou corretamente e se a legenda está humana, não com o nome bruto do arquivo.
Verifique se as redes selecionadas estão mesmo conectadas e se o card de Integrações não mostra Precisa reconectar.
Em contas com agenda longa, revise data e fuso do agendamento antes de salvar, especialmente em mudanças de horário de verão.
Depois do horário, acompanhe o post pelo dashboard ou pela API para ver o estado de cada target em vez de depender apenas do status geral.
Estados mais importantes
PENDING significa que o post ainda está na fila. PROCESSING indica que o worker já começou. PUBLISHED confirma o envio. FAILED mostra que pelo menos um target falhou e deve ser revisado.
API
Como usar a API do Agendador Online
A API autenticada permite login, upload de mídia, criação de posts e leitura de status por plataforma.
1. Autenticação
Faça login com usuário ou e-mail e senha para obter sessão autenticada. Em clientes scriptados, você também pode reaproveitar o token retornado no login.
curl -X POST https://agendador.online/api/auth/login \
-H 'Content-Type: application/json' \
--data '{"identifier":"foiumaideia","password":"SUA_SENHA"}'2. Upload da mídia
Para vídeo ou imagem, suba o arquivo antes e use a URL retornada no payload do post. Hoje, vídeo é o fluxo principal estável para publicação automática.
curl -X POST https://agendador.online/api/upload \ -H "Authorization: Bearer TOKEN" \ -F "file=@/caminho/video.mp4"
3. Criar um post
Envie data, URL da mídia, legenda e plataformas. Para publicar agora, use a data atual. Para futuro, envie a data agendada em ISO 8601.
curl -X POST https://agendador.online/api/posts \
-H "Authorization: Bearer TOKEN" \
-H 'Content-Type: application/json' \
--data '{
"date": "2026-03-30T17:30:00.000Z",
"mediaUrl": "https://agendador.online/uploads/exemplo.mp4",
"caption": "Legenda do post",
"platforms": ["YT","FB","IG"],
"isDraft": false
}'4. Ler a fila e o histórico
A rota de posts devolve pendentes, publicados e falhados, com targets separados por rede. Cada target carrega status, erro e ID remoto quando existir.
curl https://agendador.online/api/posts \ -H "Authorization: Bearer TOKEN"
5. Verificar integrações
O painel de integrações também pode ser consultado pela API para confirmar se a rede está conectada, pronta para publicar ou precisando reconexão.
curl https://agendador.online/api/social-accounts \ -H "Authorization: Bearer TOKEN"
Observação importante
A API é autenticada por conta do agendador. Isso significa que a sessão define qual dashboard, quais integrações e quais posts pertencem à conta atual. As redes sociais autorizadas entram como destino de publicação, não como substitutas da conta do produto.
Referência rápida de endpoints
| Endpoint | Uso |
|---|---|
| POST /api/auth/login | Autenticar a conta do agendador e iniciar a sessão usada nas demais chamadas. |
| GET /api/auth/me | Retornar a conta autenticada atual, plano, perfil e dados básicos da sessão. |
| POST /api/upload | Enviar vídeo ou imagem e obter a URL pública usada no post. |
| POST /api/posts | Criar um novo post, imediato ou futuro, com plataformas e conteúdo. |
| GET /api/posts | Consultar a fila, os publicados e os falhados, com targets separados por rede. |
| PUT /api/posts/:id | Editar data, legenda, destinos e outras configurações do post antes do envio. |
| DELETE /api/posts/:id | Remover um post do painel quando ele ainda não deve mais ser enviado. |
| GET /api/social-accounts | Consultar o estado real das integrações: conectado, publish_ready, needs_reconnect e erros. |
Como consultar só o que está agendado
Para olhar apenas a fila futura, filtre localmente os posts com status PENDING e data maior que agora.
curl https://agendador.online/api/posts \ -H "Authorization: Bearer TOKEN"
Como interpretar as integrações
Use os campos status, connected, publish_ready e last_refresh_error para saber se a rede pode publicar naquele momento.
curl https://agendador.online/api/social-accounts \ -H "Authorization: Bearer TOKEN"
Fila e recorrência
Agendamentos longos, melhores horários e previsão do que vai sair
A plataforma guarda a agenda futura por conta, com leitura clara do que ainda vai publicar.
A fila mostra posts pendentes com data, horário e plataformas. Quando um horário já passou, o worker pega o post e atualiza cada destino conforme a publicação termina.
O bloco de melhores horários usa o histórico real do próprio app para sugerir janelas mais fortes de publicação, sem depender de uma regra fixa para todos.
Para contas com cadência diária, a fila recorrente ajuda a manter uma sequência de posts sem recriar manualmente a mesma estrutura todos os dias.
Confiabilidade
Como o sistema protege cada conta
A plataforma foi desenhada para manter cada publicação no destino certo, com aviso claro quando algo precisa de atenção.
- Cada conta mantém sua própria agenda, seus próprios posts e suas próprias integrações.
- Antes de publicar, o sistema verifica se a rede ainda está válida e avisa quando é preciso reconectar.
- O resultado aparece por plataforma, então você consegue ver exatamente onde o post entrou e onde precisa de revisão.
- Se houver qualquer inconsistência na conexão, o sistema bloqueia o envio naquela rede em vez de correr o risco de publicar no lugar errado.
Perguntas frequentes
Como interpretar o estado do sistema
Os estados do painel foram pensados para responder o que está pronto, o que está pendente e o que exige atenção.
Conectado
A integração existe e passou na verificação atual da conta. Ela pode ser usada para novos posts.
Precisa reconectar
O vínculo existe, mas a plataforma detectou token vencido, grant insuficiente ou inconsistência na autorização da rede.
Publicado com sucesso
O destino recebeu o conteúdo e devolveu um identificador remoto. O painel mantém o histórico por plataforma para facilitar auditoria.