Schemalägg text- och bildinlägg på Threads med SosoAPI

1. Anslut och kontrollera destinationen

Anslut avsett Threads-konto i SosoAPI. Leverantörssamtycket behöver threads_content_publish för publicering. SosoAPI-anroparen behöver också en tillåten arbetsyta, editor-åtkomst och funktionen agent:publish för schemaläggning.

Kontrollera att SosoAPI har returnerat det Threads-konto du tänker använda. Kör behörighetskontroll för hela utkastet med innehåll och tid före schemaläggning. Funktioner som svar, platser och korsdelning har ytterligare behörighetskrav.

• Kontrollera plattformsfunktionsmatrisen

2. Schemalägg ett granskat textinlägg

Använd serverhjälparen från API-referensen, ersätt platshållarna och välj en framtida ISO-8601-tid med tidszonsförskjutning. Anropet skapar en riktig schemaläggning, så bekräfta konto, formulering och tid innan du skickar det.

Låt media vara tomt för ett TEXT-inlägg. Behåll en idempotensnyckel för begäran och spara returnerat post.id så att du kan kontrollera status. Använd en Threads-provider_payload med detta konto.

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>"
});

• Publicerings-API-referens

3. Använd en färdig registrerad bild

Använd sosoapi_upload_asset för en lokal bild. För en offentlig bild-URL anropar du sosoapi_import_asset_url och kontrollerar sosoapi_get_asset_import_status tills den är klar. Använd den registrerade mediefilens ID och kanoniska URL i inlägget.

För ett vanligt create-anrop sätter du post_type till IMAGE och lägger den färdiga bilden i media. Fragmentet nedan ersätter dessa två fält i textexemplet. Behåll bildtext, konto och tid och använd en ny stabil nyckel för detta nybekräftade inlägg.

• Ersätt asset_id med det faktiska positiva heltalet, inte en numerisk sträng.
• Schemalägg inte med käll-URL, tillfällig förhandsvisnings-URL eller en ofärdig import.
• Samma biblioteksbild får endast återanvändas när rättigheter, arbetsyta och valt innehåll är lämpliga.

{
  "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. Verifiera publicering och undvik dubbla sändningar

Läs ursprunglig Scheduled Post och kontrollera dess slutliga publiceringsresultat. Ett ID, en accepterad schemaläggning eller en Threads-mediecontainer betyder att begäran finns; det bekräftar inte publicering. Visa leverantörens inläggs-ID eller permalänk när den finns.

Om Threads fortfarande bearbetar eller om du förlorar svaret fortsätter du kontrollera samma inlägg. Skicka inte en ny create-begäran med en annan nyckel. Att återansluta kontot fastställer inte om en tidigare skrivning lyckades.

När Threads börjar publicera ett textinlägg kan leverantörssteget inte längre vara möjligt att återkalla. Följ tillgängliga åtgärder som SosoAPI returnerar i stället för att skicka om inlägget. Bearbetningstiden kan variera.

• Granska med Claude Code eller Codex
• Publicerings-API-referens