Redes sociais com agentes de IA · Capítulo 4 de 9 · 9 min
Publique por API só depois da aprovação, com teste reversível
A camada de publicar tem o erro mais visível das três, por isso entra por último, com chave guardada fora do chat, fluxo de mídia na ordem certa e um teste que se desfaz.
Este capítulo faz parte do curso gratuito Redes sociais com agentes de IA.
Duas semanas depois de entrar no nível 0, o Estúdio Ventana cumpriu o critério de saída: dez rascunhos seguidos aprovados por Marina sem nenhum número sem fonte, números do exemplo fictício. O primeiro carrossel do @estudioventana estava aprovado, com seis imagens e legenda revisada, e Rafael tinha diante de si a decisão que o capítulo 1 adiou: deixar o agente publicar.
A camada de publicar tem o erro mais visível das três. Um rascunho ruim fica no chat; um post errado fica no perfil com o nome da empresa, e o print costuma sair antes da correção.
Este capítulo monta a publicação do Ventana pela Publora, exemplo de API de publicação em outubro de 2026, com a chave guardada fora do chat, o plano escolhido pela fila de agendados e um teste reversível antes do primeiro post real.
O que a Publora faz e onde ficam as chaves
A Publora é uma API REST para agendar e publicar em dez redes: LinkedIn, X, Facebook, Instagram, Threads, TikTok, YouTube, Bluesky, Mastodon e Telegram. As contas sociais se conectam por OAuth no painel, na área Channels, e nunca pela API. A separação é deliberada: quem autoriza o acesso ao Instagram é uma pessoa logada, e o agente só usa o que já foi conectado.
As chamadas se autenticam pelo cabeçalho x-publora-key, e a chave aparece uma única vez, no momento da criação. Rafael guardou a chave no gerenciador de senhas da consultoria antes de fechar a janela e não a colou em chat nenhum, porque chave colada em conversa fica no histórico do agente. O capítulo 8 transforma esse cuidado em regra de governança.
Para operar pelo agente existe o servidor MCP oficial em https://mcp.publora.com/mcp, com 33 ferramentas (20 pessoais e 13 de agência), autenticado por OAuth ou por chave. No claude.ai, ele aparece no diretório de conectores. No Claude Code, o comando abaixo registra o servidor para o usuário, e a autenticação termina no menu /mcp. Estatísticas por MCP existem só para Mastodon e Bluesky.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
claude mcp add --transport http --scope user publora https://mcp.publora.com/mcpComo conectar Instagram e LinkedIn na Publora e criar a chave
Guia de referência para a configuração inicial, feita por uma pessoa logada e nunca pelo agente.
Passo 1: Confirme que o Instagram é conta profissional
A Publora publica em conta Business ou Creator, e a Meta decide se aceita Creator. Conta pessoal precisa ser convertida antes.
Deu certo quando: O perfil aparece como conta profissional nas configurações do Instagram.
Passo 2: Conecte o Instagram em Channels
No painel da Publora, abra Channels e conecte a conta por OAuth, entrando com o login da conta da empresa.
Deu certo quando: A conta aparece em Channels como conectada.
Passo 3: Conecte o LinkedIn de quem assina
Ainda em Channels, conecte o LinkedIn por OAuth, com o login da própria pessoa que assina os posts.
Deu certo quando: Os dois canais aparecem conectados, dentro do limite de canais do plano.
Passo 4: Crie a chave e guarde antes de fechar a janela
A chave do cabeçalho x-publora-key aparece uma única vez. Copie direto para o gerenciador de senhas da equipe.
Deu certo quando: A chave está no cofre e em nenhum chat, e-mail ou repositório.
Passo 5: Registre o MCP no agente
No Claude Code, rode o comando acima e autentique em /mcp. No claude.ai, adicione a Publora pelo diretório de conectores.
Deu certo quando: As ferramentas da Publora aparecem disponíveis para o agente.
Passo 6: Peça ao agente a lista de canais
Solicite apenas a listagem dos canais conectados, sem criar nenhum post.
Deu certo quando: O agente devolve os mesmos canais que o painel mostra.
No fim você tem: Canais conectados por OAuth, chave guardada fora do chat e agente enxergando as contas certas.
Escolha o plano olhando a fila de agendados
Na consulta de 22/10/2026, o Starter gratuito oferecia 15 posts por mês na conta toda, 3 canais, 3 agendados pendentes, horizonte de 7 dias, API e MCP incluídos, todas as redes menos o X e vídeo de até 50 MB. O Agency era sob consulta, com espaços isolados por cliente e aprovação por link, desenho que leva o portão para fora da equipe sem compartilhar acesso.
O Pro custava US$ 5,99 por conta por mês nas cinco primeiras contas, US$ 2,99 da 6ª à 20ª e US$ 0,99 acima de 20. No anual, os mesmos degraus caíam para US$ 3,99, US$ 1,99 e US$ 0,66, com 5.000 posts por conexão em regime de uso justo e o X incluído. Preços e degraus mudam, então confira a página antes de decidir.
O número que decide o Ventana está escondido na lista do Starter. O plano do exemplo prevê três posts por semana entre o Instagram da empresa e o LinkedIn de Marina, cerca de 13 por mês, que cabem nos 15. A trava real são os três agendados pendentes e o horizonte de sete dias, que impedem montar a fila do mês numa tarde.
Quem aprova na segunda e agenda a semana cabe no Starter; quem quer o mês inteiro na fila precisa do Pro.
O fluxo do Instagram: rascunho, upload, agendamento
Post de Instagram sem mídia é impossível, e a ordem das etapas decide se o carrossel chega inteiro. O fluxo obrigatório pela Publora tem três passos: criar o rascunho sem horário, subir cada mídia por uma URL pré-assinada e só então agendar. Agendar antes de o upload terminar faz a rede publicar sem mídia ou falhar. O horário vai em UTC, no padrão ISO 8601, com pelo menos cinco minutos de antecedência.
Como agendar um carrossel do Instagram na ordem certa
Guia de referência para todo post de Instagram com mídia publicado pela Publora.
Passo 1: Confirme que o texto é o aprovado
Compare a legenda com o registro da aprovação. Até 2.200 caracteres, com o gancho nos 125 visíveis antes do mais.
Deu certo quando: A legenda é idêntica à que recebeu o sim.
Passo 2: Prepare as imagens dentro dos limites
Até 10 itens, sem misturar imagem e vídeo, cada imagem com até 8 MB. Prefira JPEG; WebP é convertido em JPEG.
Deu certo quando: Todas as imagens cabem nos limites antes do primeiro upload.
Passo 3: Crie o rascunho sem horário
Peça ao agente que crie o post como rascunho, sem data de agendamento.
Deu certo quando: O rascunho existe e não tem horário marcado.
Passo 4: Suba cada imagem pela URL pré-assinada
Uma URL por mídia, respeitando o teto de 60 URLs de mídia por hora. Diante de um 429, espere o tempo do Retry-After.
Deu certo quando: Todos os uploads terminaram sem erro.
Passo 5: Confira as mídias anexadas
Peça ao agente o estado do rascunho e compare a contagem de mídias com a do carrossel aprovado.
Deu certo quando: O rascunho tem todas as imagens, na ordem aprovada.
Passo 6: Agende em UTC
Horário em ISO 8601, em UTC, pelo menos cinco minutos à frente. Converta do horário de Brasília antes de enviar.
Deu certo quando: O agendamento aparece no painel no horário local esperado.
Passo 7: Consulte o estado depois do horário
Peça ao agente que rode get-post depois do horário marcado. Se a rede recusou, corrija e reagende pelo portão.
Deu certo quando: O post está no ar, ou a recusa foi vista e tratada.
No fim você tem: Um carrossel que chega ao perfil inteiro, no horário certo, com a recusa vigiada.
Limites que o agente precisa respeitar ao publicar pela Publora
| Limite | ||
|---|---|---|
| Texto | 2.200 caracteres de legenda, 125 visíveis antes do mais | 3.000 caracteres, 210 visíveis antes do ver mais |
| Imagem | Até 8 MB; JPEG, PNG ou WebP, este convertido em JPEG | Até 10 imagens por post |
| Carrossel | Até 10 itens, sem misturar imagem e vídeo | Carrossel orgânico não existe pela API |
| Vídeo | Reels em MP4 ou MOV, até 15 min e 300 MB | MP4 até 30 min e 500 MB |
| Conta e ritmo | Conta profissional (Business ou Creator; a Meta decide se aceita Creator) | Cerca de 200 chamadas por hora |
Limites da Publora consultados em 22/10/2026. Para mídia vale também o teto de 60 URLs por hora, com resposta 429 e cabeçalho Retry-After. Na API da Meta, o carrossel aceita até 20 itens e a conta publica entre 50 e 100 posts por API em 24 horas (a própria página cita os dois números; confira).
Do lado da Meta, a publicação aceita só JPEG e o contêiner de mídia não publicado expira em 24 horas, motivo a mais para não deixar um upload pela metade de um dia para o outro.
Teste reversível e o post que a rede recusa
Antes do primeiro post real, Rafael rodou um teste que podia ser desfeito: um rascunho de teste no @estudioventana, uma imagem anexada, agendamento para o dia seguinte, conferência no painel e exclusão do post agendado. O teste prova a cadeia inteira (conexão da conta, chave, upload, fuso horário) sem nada ir ao ar, e o horário de Brasília, três horas atrás do UTC, foi o primeiro erro que ele pegou.
A segunda lição está no que a Publora não faz. Quando a rede recusa um post, ela não o refaz sozinha: o agente precisa consultar o estado com get-post, mostrar o motivo da recusa e reagendar depois da correção. A regra do Ventana manda esse reagendamento voltar a Marina sempre que o texto ou a mídia mudarem.
Três sintomas resumem os erros desta camada. Carrossel no ar sem imagens vem de agendamento feito antes do fim do upload, e a saída é a conferência das mídias no rascunho. Post que nunca apareceu e ninguém notou vem de recusa sem consulta ao get-post. Post publicado três horas fora do horário vem de UTC confundido com o horário local.
Na segunda-feira, conecte uma conta pelo painel, guarde a chave fora do chat e rode o teste de agendar e apagar até ele passar inteiro. No Ventana, o teste passou na segunda tentativa, o MCP ficou registrado e o primeiro carrossel aprovado por Marina, o mesmo tipo de peça que um dia foi ao ar com número inventado, está no rascunho com as seis imagens anexadas, à espera do horário que ela vai escolher.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Vídeo com IA: Claude Code, Codex e ElevenLabsPublicar por API no YouTube, Reels e TikTok com OAuth e rótulo de IAExaminar conexões de Publicar por API no YouTube, Reels e TikTok com OAuth e rótulo de IA
- Agentes de IA Autônomos: Do Conceito à ProduçãoClaude Agent SDKExaminar conexões de Claude Agent SDK
- Google Ads 2027Delegar ao Ask Advisor, scripts e API com aprovação humanaExaminar conexões de Delegar ao Ask Advisor, scripts e API com aprovação humana
- VS Code: Do Zero ao Editor ProfissionalMarketing no VS Code: landing page, UTMs e copy com agenteExaminar conexões de Marketing no VS Code: landing page, UTMs e copy com agente
Terminou a leitura?
Marque como concluído para o capítulo contar no seu painel e no certificado.
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.