Plan Threads-tekst- en afbeeldingsberichten in met SosoAPI

1. Verbind en controleer de bestemming

Verbind het bedoelde Threads-account in SosoAPI. De providertoestemming vereist threads_content_publish voor publicatie. De SosoAPI-aanroeper heeft daarnaast een toegestane werkruimte, editor-toegang en de bevoegdheid agent:publish nodig om in te plannen.

Controleer of SosoAPI het bedoelde Threads-account heeft teruggegeven. Controleer vóór het inplannen de geschiktheid van het volledige concept met inhoud en tijdstip. Functies zoals antwoorden, locaties en kruislings delen hebben extra machtigings- en geschiktheidsvereisten.

• Controleer de matrix van platformmogelijkheden

2. Plan een beoordeeld tekstbericht in

Gebruik de serverhelper uit de API-naslag, vervang de placeholders en kies een toekomstig ISO-8601-tijdstip met offset. Dit verzoek plant een echt bericht in, dus bevestig account, tekst en tijdstip vóór verzending.

Laat voor een TEXT-bericht media leeg. Behoud één idempotentiesleutel voor dit verzoek en bewaar de teruggegeven post.id om de status te controleren. Gebruik bij dit account een Threads-provider_payload.

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

• Naslag voor de publicatie-API

3. Gebruik een gereed geregistreerde afbeelding

Gebruik voor een lokale afbeelding sosoapi_upload_asset. Roep voor een openbare afbeeldings-URL sosoapi_import_asset_url aan en controleer sosoapi_get_asset_import_status tot gereedheid. Gebruik de geregistreerde media-ID en canonieke URL in het bericht.

Stel bij het normale aanmaakverzoek post_type in op IMAGE en voeg de gereedstaande afbeelding toe aan media. Onderstaand fragment vervangt die twee velden in het tekstvoorbeeld. Behoud bijschrift, account en tijdstip en gebruik een nieuwe stabiele sleutel voor dit nieuw bevestigde bericht.

• Vervang asset_id door het echte positieve gehele getal, niet door een numerieke tekenreeks.
• Plan niet in met de bron-URL, een tijdelijke voorbeeld-URL of een onvoltooide import.
• Dezelfde bibliotheekafbeelding mag alleen worden hergebruikt als rechten, werkruimte en gekozen inhoud passend zijn.

{
  "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. Verifieer publicatie en voorkom dubbele verzending

Lees de oorspronkelijke Scheduled Post en controleer het definitieve publicatieresultaat. Een ID, geaccepteerde planning of Threads-mediacontainer bewijst dat het verzoek bestaat, niet dat publicatie is bevestigd. Toon de providerbericht-ID of permalink indien beschikbaar.

Als Threads nog verwerkt of je het antwoord kwijtraakt, blijf dan hetzelfde bericht controleren. Verstuur geen nieuw aanmaakverzoek met een andere sleutel. Het account opnieuw verbinden bewijst niet of een eerdere schrijfhandeling is geslaagd.

Zodra Threads een tekstbericht begint te publiceren, is de providerstap mogelijk niet meer terug te draaien. Volg de door SosoAPI teruggegeven acties in plaats van het bericht opnieuw te versturen. De verwerkingstijd kan verschillen.

• Beoordeel met Claude Code of Codex
• Naslag voor de publicatie-API