Publicar um post

cria Publication → Post[]EscritaUnifiedEm breve

Uma requisição para TikTok, Instagram, YouTube e mais seis plataformas. Cada plataforma retorna o próprio resultado, e só os posts que vão ao ar são cobrados. Postar no X já funciona hoje pela API Direct de ações X da AIsa.

Uma requisição, todas as plataformas

Escreva uma vez e cada plataforma responde por si

Texto, mídia, contas de destino e horário são comuns a todas. O que só uma plataforma tem fica sob o prefixo dela, como tiktok.privacy ou instagram.format. Cada conta pode ter a própria legenda, mais curta.

plataformas
9
se falhar ou parar na pré-verificação
US$0
por post publicado
[$Z]
{
  "tool": "social.publications.create",
  "arguments": {
    "text": "Our 3-in-1 travel charger is here.",
    "media": ["med_7Hq2Lw"],
    "targets": [
      { "account": "tiktok:acme.home" },
      { "account": "instagram:acme.home",
        "instagram": { "format": "reels" } },
      { "account": "youtube:acmehome" },
      { "account": "x:acme_home",
        "text": "3-in-1 charger, out now." }
    ],
    "when": { "at": "2026-10-03T09:00:00-07:00" },
    "approval": "required",
    "idempotency_key": "launch-charger-01"
  }
}
Testar com um rascunho

Cada destino reporta o próprio resultado

Exemplo · marca fictícia Acme Home

pub_01JB8W3KPublicada em parte
3 de 6 no ar · cobrança: 3
ContaFormatoStatusResultadoCobrado
TikToktiktok:acme.homeVídeoPublicadotiktok:[post id]No ar às 09:00 PTCobrado
Instagraminstagram:acme.homeReelsPublicadoinstagram:[post id]No ar às 09:00 PTCobrado
Xx:acme_homeTexto + vídeoPublicadox:[post id]Legenda mais curta usadaCobrado
YouTubeyoutube:acmehomeShortsPublicando—Upload em processamento—
LinkedInlinkedin:acme-homeVídeoAgendado—Próximo horário livre, 11:00 PT—
Pinterestpinterest:acmehomePin de vídeoCom falhaconnection_expiredVocê pode corrigir: reconecte e tente este destino de novoNão cobrado

Uma Publication pode estar em rascunho, agendada, publicando, publicada, publicada em parte, com falha ou retirada. Tente de novo só os destinos que falharam, com a mesma chave de idempotência; nada é postado duas vezes.

Da conexão ao post publicado

  1. 01 · Connection

    Conecte uma vez

    Os donos das contas dão acesso à AIsa. Escopos, status e validade podem ser lidos, com um aviso antes do vencimento.

  2. 02 · Preflight

    Confira antes de postar

    Tamanho do texto, tamanho da mídia, formato e tipo de conta são conferidos com cada plataforma. Uma reprovação não custa nada.

  3. 03 · Approval

    Peça a uma pessoa antes

    Publicações, exclusões e DMs podem esperar por um humano. Vem ativado por padrão para funcionários de IA.

  4. 04 · Publication

    Poste ou coloque na fila

    Agora, em um horário definido, no próximo horário livre ou guardado como rascunho. O fuso horário é sempre explícito.

  5. 05 · Event

    Receba avisos

    Webhooks para cada post que vai ao ar ou falha, novos comentários e DMs, e conexões prestes a expirar.

9 chamadas planejadasEm breve

Nosso primeiro rascunho dos caminhos, ainda sem revisão. Cada chamada age nas plataformas listadas pela Connection que você concede, e nenhuma está implantada ainda.

  • POST/v1/social/publicationsEnviar um post a várias contas: agora, em um horário definido ou para a filaTodas as 9 redes sociaisRascunho
  • POST/v1/social/publications/precheckFazer a pré-verificação de tamanho, mídia e tipo de conta conforme as regras de cada plataformaTodas as 9 redes sociaisRascunho
  • GET/v1/social/publications/{publicationId}Uma Publication com o status em cada plataformaTodas as 9 redes sociaisRascunho
  • GET/v1/social/publicationsPublications em rascunho, agendadas e enviadasTodas as 9 redes sociaisRascunho
  • PUT/v1/social/publications/{publicationId}Editar uma Publication em rascunho ou agendadaTodas as 9 redes sociaisRascunho
  • POST/v1/social/publications/{publicationId}/retryTentar de novo nas plataformas que falharamTodas as 9 redes sociaisRascunho
  • DELETE/v1/social/publications/{publicationId}Excluir um rascunho ou cancelar um envio agendadoTodas as 9 redes sociaisRascunho
  • POST/v1/social/publications/bulk-uploadCriar várias Publications a partir de um arquivo CSVTodas as 9 redes sociaisRascunho
  • GET/v1/social/platformsAs plataformas em que você pode publicar, com os limites de cada umaTodas as 9 redes sociaisRascunho

O que cada plataforma permite

A mesma tabela é um endpoint, versionado conforme as plataformas mudam: GET /v1/social/platforms

PlataformaPublicarComentários e DMsSuas estatísticasStatus
XTexto, imagens, vídeo, threads, enquetesComentários; DMs em breveSimDisponível
TikTokVídeoComentários; DMs só para responderSimEm breve
InstagramPosts, Reels, Stories, carrosséisComentários, DMsSimEm breve
Página do FacebookTexto, imagens, vídeo, ReelsComentários, DMs, avaliações da páginaSimEm breve
YouTubeVídeo, ShortsComentáriosSimEm breve
LinkedInTexto, imagens, vídeo, documentosComentários em páginas de empresaSimEm breve
PinterestPins de imagem, Pins de vídeoO Pinterest não ofereceSimEm breve
ThreadsTexto, imagens, vídeoComentáriosSimEm breve
RedditTexto, imagens, vídeo, linksComentários, DMsLimitadoEm breve

Cada erro diz quem pode corrigi-lo

Os códigos são da própria AIsa. Códigos e mensagens de origem nunca chegam até você, então o canal por trás de uma plataforma pode mudar sem mexer no seu código.

Você pode corrigirsem nova tentativa · sem cobrança
  • connection_expired
  • content_spec_mismatch
  • account_type_unsupported
A plataformanova tentativa automática
  • platform_rate_limited
  • platform_unavailable
AIsanova tentativa · por nossa conta
  • aisa_internal

Proteções que mantêm as contas seguras

  • O ritmo de postagem fica abaixo do limite de cada plataforma, por conta.
  • O mesmo post enviado a muitas contas passa por revisão antes.
  • Uma conta recém-conectada começa devagar e aumenta o ritmo aos poucos.
  • Comentários e DMs são tratados como dados pessoais e nunca são misturados com os de outros clientes.

Quanto custa

Conta conectada, com as próprias estatísticas
[$] / mês
Cada post que vai ao ar
[$Z]
Cada resposta a comentário ou DM
[$]
X
Por chamada à API do X, com preço listado à parte

Agentes podem pagar por post com x402, sem conta nem plano.

Buscar no catálogo

Plataformas, entidades Unified, APIs de fornecedores, endpoints e conectores.