Conceitos
Organizações, projetos, artigos, posts, destinos, revisão e créditos.
Organização
A organização é a conta: membros, papéis, plano, créditos, tokens de API, webhooks e assistentes conectados. Tudo na API acontece dentro de uma organização, e um token nunca enxerga outra.
Os papéis são dono, admin, membro, revisor e leitor. Donos e admins criam tokens e webhooks; quem só lê não escreve, nem pela API nem por um assistente.
Projeto
Um projeto é uma marca: o site, o público, a voz, o calendário, os destinos e as métricas. Cada artigo e cada post pertence a um projeto. Um token de API pode ficar preso a um projeto ou alcançar todos.
Artigos
O artigo é o conteúdo longo, para o blog. O texto mora em revisões imutáveis: cada edição cria uma revisão nova, e o site lê só a revisão publicada. O slug é único por projeto e idioma.
O status de um artigo:
draft → generating → in_review → approved → scheduled → published| Status | Quer dizer |
|---|---|
draft | Rascunho, editável. |
generating | O modelo do Postline está escrevendo. |
in_review | Esperando aprovação. |
approved | Uma revisão exata foi aprovada. Editar depois pede nova aprovação. |
scheduled | Tem data para ir ao ar. |
published | O site mostra uma revisão dele. |
A publicação tem o seu próprio estado, por destino: pending → delivering → confirmed | failed.
Posts
Um post é um conteúdo de rede social, em um de três formatos (format):
format | O que é |
|---|---|
linkedin | Texto com manchete na primeira linha e até 5 hashtags. |
carousel | De 3 a 10 slides, com legenda e hashtags. |
x | Um post, ou uma thread de várias partes. |
Um post pode nascer de uma pauta, de um link, de um roteiro pronto, ou vir de um artigo (articleId). Ele tem o seu próprio status (draft → generating → in_review → approved → scheduled → published, ou failed) e uma data por destino. Um post vindo de um artigo nunca vai ao ar antes dele.
Destinos
Os artigos vão para o site do projeto: um site Next.js com a integração, o blog hospedado do Postline, WordPress ou Ghost.
Os posts vão para as redes, cada destino com a sua data:
format | Destinos |
|---|---|
linkedin | linkedin |
carousel | instagram (imagens 4:5 ou 1:1), linkedin (documento PDF), tiktok (modo foto 9:16) |
x | x |
O X publica direto pela API oficial do X. LinkedIn, Instagram e TikTok ficam prontos para exportar enquanto cada plataforma aprova o app do Postline.
Revisão e aprovação
A aprovação é uma escolha do projeto, em Projeto › Geral, na seção Aprovação (donos e admins):
- Revisão antes de publicar: ligada, cada post e cada artigo espera aprovação antes de ir ao ar; desligada, agendar já publica. Um projeto de uma pessoa só começa com ela desligada.
- Quem aprova: uma pessoa, ou qualquer um que aprove.
- Criado por agentes de IA: o que o trabalho de um assistente conectado pelo MCP segue. Por padrão, sempre passa por revisão.
Pela API, POST /articles/{id}/submit manda um rascunho para revisão, POST /articles/{id}/approve aprova (com articles:approve, para quem pode aprovar) e POST /articles/{id}/schedule agenda. O que nasce pela API ou por um assistente segue a escolha do projeto para agentes.
Créditos
Os créditos pagam o trabalho que roda do lado do Postline. Cada plano traz créditos por mês, e dá para comprar mais.
| Trabalho | Custo |
|---|---|
| Artigo escrito pelo Postline | 4 créditos, mais 1 por imagem gerada (o padrão, capa e duas no corpo, dá 7) |
| Post de LinkedIn | 1 crédito, ou 2 com ilustração ou foto |
| Carrossel | 2 créditos, ou 6 com ilustrações ou fotos |
| Post ou thread do X | 1 crédito, ou 2 com ilustração |
| Imagem gerada | 1 crédito |
| Transcrição de áudio ou vídeo | 1 crédito a cada 10 minutos começados |
| Publicar no X pelo app do Postline | 1 crédito por post ou thread, mais 1 com link |
Escrever e editar, por você, pelo seu sistema via API ou pelo seu agente via MCP, é grátis. O que o modelo do Postline faz consome créditos igual pela API, pelo MCP e no app: POST /posts/generate e POST /posts/{id}/images. O webhook credits.low avisa quando o uso do ciclo passa de 80%.