Início Rápido

Este guia leva você de uma conta nova até seu primeiro post publicado.

1. Cadastre-se e comece seu teste

Cadastre-se e crie sua organização. Cada conta começa com um teste gratuito de 7 dias pelo checkout do Stripe.

2. Conecte suas contas sociais

No painel, conecte as contas em que você quer publicar: contas profissionais de Instagram (Business ou Creator) e contas X. Cada conexão passa pelo fluxo OAuth da própria plataforma, e a InvisibleAPI mantém os tokens renovados para você.

3. Crie uma chave de API

Gere uma chave de API da organização no painel. As chaves têm escopos definidos (publishing:read, publishing:publish), são mostradas uma única vez e podem ser revogadas. Mantenha o token em segredo: ele autoriza a publicação nas suas contas conectadas.

4. Crie seu primeiro job de publicação

Envie uma requisição com sua chave de API no cabeçalho Authorization:

POST /api/v1/organizations/{organization}/publishing/jobs

{
  "targets": ["3f2a9c10-8b41-4e7d-9c22-5a1e6b0d7f33"],
  "mediaItems": [
    {
      "mediaType": "image",
      "sourceUrl": "https://cdn.example.com/launch.jpg",
      "altText": "The new release, photographed on a desk"
    }
  ],
  "caption": "New drop, live now.",
  "clientRequestId": "first-publish-test"
}

targets aceita pelo menos um ID de conta conectada. mediaItems aceita até 10 itens, cada um com um mediaType de image ou video e uma sourceUrl publicamente acessível: não existe endpoint de upload, por isso um link para um bucket privado é a causa mais comum de falha em uma primeira publicação. caption e firstComment aceitam até 5000 caracteres. requestedPublishAt é opcional e foi omitido acima para que a publicação saia imediatamente. Adicione esse campo, como timestamp ISO-8601 no futuro, para agendar. clientRequestId aceita até 128 caracteres e torna uma nova tentativa segura: o mesmo ID com o mesmo payload retorna o job original em vez de publicar duas vezes.

A chamada retorna 202, não uma publicação já criada. A publicação é assíncrona, por isso consulte o job até ele chegar a um estado final:

GET /api/v1/organizations/{organization}/publishing/jobs/{publishJobId}

Um job passa por pending, scheduled, processing, preparing, submitted e polling antes de ficar em um destes: published, partial_failure, failed, action_required ou canceled.

5. Automatize

Quando seu primeiro post for publicado, você pode:

• Publicar diretamente do seu próprio aplicativo ou script
• Apontar o Claude (ou qualquer agente compatível com MCP) para o servidor MCP da InvisibleAPI e deixar que ele redija e agende posts
• Aguardar as integrações com n8n e Zapier e a CLI, que chegam em breve

Explore a biblioteca de modelos para receitas prontas para usar.