Planlegg tekst- og bildeinnlegg på Threads med SosoAPI

1. Koble til og kontroller målet

Koble til ønsket Threads-konto i SosoAPI. Leverandørsamtykket trenger threads_content_publish for publisering. SosoAPI-innkalleren trenger også et tillatt arbeidsområde, editor-tilgang og agent:publish-funksjonen for planlegging.

Kontroller at SosoAPI returnerte Threads-kontoen du vil bruke. Kjør kvalifikasjonskontroll for hele utkastet med innhold og tidspunkt før planlegging. Funksjoner som svar, lokasjoner og kryssdeling har ekstra tillatelses- og kvalifikasjonskrav.

• Kontroller plattformens funksjonsmatrise

2. Planlegg et gjennomgått tekstinnlegg

Bruk serverhjelperen fra API-referansen, erstatt plassholderne og velg et fremtidig ISO-8601-tidspunkt med tidssoneforskyvning. Forespørselen oppretter en faktisk publiseringsplan når den kjøres, så bekreft konto, ordlyd og tidspunkt før du sender den.

For et TEXT-innlegg, la media være tom. Behold én idempotensnøkkel for forespørselen og lagre returnert post.id for å kontrollere status. Bruk en Threads-provider_payload med denne kontoen.

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

• Referanse for publiserings-API

3. Bruk et klart registrert bilde

Bruk sosoapi_upload_asset for et lokalt bilde. For en offentlig bilde-URL, kall sosoapi_import_asset_url og kontroller sosoapi_get_asset_import_status til den er klar. Bruk den registrerte ressursens ID og kanoniske URL i innlegget.

For vanlig opprettingsforespørsel, sett post_type til IMAGE og legg det klare bildet i media. Utdraget nedenfor erstatter disse to feltene i teksteksemplet. Behold bildetekst, konto og tidspunkt, og bruk en ny stabil nøkkel for dette nylig bekreftede innlegget.

• Erstatt asset_id med det faktiske positive heltallet, ikke en numerisk streng.
• Ikke planlegg med kilde-URL, en midlertidig forhåndsvisnings-URL eller en uferdig import.
• Samme biblioteksbilde kan bare gjenbrukes når rettigheter, arbeidsområde og valgt innhold passer.

{
  "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. Verifiser publisering og unngå dupliserte sendinger

Les det opprinnelige planlagte innlegget og kontroller endelig publiseringsresultat. En ID, akseptert publiseringsplan eller Threads-mediecontainer betyr at forespørselen finnes; det bekrefter ikke publisering. Vis leverandørens innleggs-ID eller permalenke når tilgjengelig.

Hvis Threads fortsatt behandler, eller du mister svaret, fortsett å kontrollere det samme innlegget. Ikke send en ny opprettingsforespørsel med en annen nøkkel. Ny kontotilkobling fastslår ikke om en tidligere skriveoperasjon lyktes.

Når Threads begynner å publisere et tekstinnlegg, kan leverandørtrinnet være umulig å angre. Følg tilgjengelige handlinger returnert av SosoAPI fremfor å sende innlegget på nytt. Behandlingstiden kan variere.

• Gjennomgå med Claude Code eller Codex
• Referanse for publiserings-API