Agende posts de texto e imagem no Threads com o SosoAPI

1. Conecte e confira o destino

Conecte a conta desejada do Threads no SosoAPI. O consentimento do provedor precisa de threads_content_publish para publicar. O chamador do SosoAPI também precisa de um Workspace permitido, acesso editor e capacidade agent:publish para agendar.

Confira se o SosoAPI retornou a conta do Threads que você pretende usar. Execute a verificação de elegibilidade do rascunho completo com conteúdo e horário antes de agendar. Recursos como respostas, localizações e compartilhamento entre plataformas têm requisitos adicionais de permissão e elegibilidade.

• Confira a matriz de capacidades das plataformas

2. Agende um post de texto revisado

Use o helper de servidor da referência da API, substitua os placeholders e escolha um horário ISO-8601 futuro com deslocamento de fuso. Executar esta requisição cria um agendamento real; confirme conta, texto e horário antes de enviar.

Para um post TEXT, mantenha media vazio. Use uma chave de idempotência para esta requisição e salve post.id retornado para conferir seu status. Use um provider_payload do Threads com esta conta.

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<threads-account-uuid>",
  "caption": "A reviewed update from our team.",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-intent>"
});

• Referência da API de publicação

3. Use uma imagem registrada pronta

Para uma imagem local, use sosoapi_upload_asset. Para uma URL pública de imagem, chame sosoapi_import_asset_url e consulte sosoapi_get_asset_import_status até ficar pronta. Use o ID do ativo registrado e a URL canônica no post.

Na requisição normal de criação, defina post_type como IMAGE e adicione a imagem pronta a media. O fragmento abaixo substitui esses dois campos no exemplo de texto. Mantenha legenda, conta e horário e use uma nova chave estável para este post recém-confirmado.

• Substitua asset_id pelo inteiro positivo real, não por uma string numérica.
• Não agende com a URL de origem, uma URL temporária de prévia ou uma importação inacabada.
• A mesma imagem da biblioteca só pode ser reutilizada quando seus direitos, Workspace e conteúdo escolhido forem adequados.

{
  "media": [{
    "kind": "image",
    "asset_id": "<ready-image-asset-id-as-number>",
    "url": "<canonical-image-asset-url>"
  }],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {"post_type": "IMAGE"}
  }
}

4. Verifique a publicação e evite envios duplicados

Consulte o Scheduled Post original e confira seu resultado terminal de publicação. Um ID, agendamento aceito ou contêiner de mídia do Threads significa que a requisição existe; não confirma publicação. Mostre o ID do post no provedor ou o permalink quando disponível.

Se o Threads ainda estiver processando ou você perder a resposta, continue consultando o mesmo post. Não envie outra requisição de criação com uma chave diferente. Reconectar a conta não comprova se uma gravação anterior teve sucesso.

Quando o Threads começa a publicar um post de texto, a etapa do provedor pode deixar de ser reversível. Siga as ações disponíveis retornadas pelo SosoAPI em vez de reenviar o post. O tempo de processamento pode variar.

• Revise com Claude Code ou Codex
• Referência da API de publicação