# Programmer des publications texte et image Threads avec SosoAPI

URL canonique : https://sosoapi.ai/fr/docs/threads-api-publishing

Programmez une publication texte ou image sur un compte Threads connecté, puis vérifiez sa mise en ligne. Les exemples utilisent des valeurs de remplacement et ne s’exécutent pas depuis cette page. Contrat de publication vérifié le 20 octobre 2026.

## 1. Connecter et vérifier la destination

Connectez le compte Threads souhaité dans SosoAPI. Le consentement fournisseur nécessite threads_content_publish pour publier. L’appelant SosoAPI doit aussi disposer d’un espace autorisé, d’un accès editor et de la capacité agent:publish pour programmer.

Vérifiez que SosoAPI a renvoyé le compte Threads prévu. Exécutez l’éligibilité du brouillon complet avec le contenu et l’heure avant de programmer. Les réponses, lieux et partages croisés ont des exigences supplémentaires d’autorisation et d’éligibilité.

- [Vérifier la matrice des capacités des plateformes](https://sosoapi.ai/fr/docs/publishing-capabilities)

## 2. Programmer une publication texte validée

Utilisez le helper serveur de la référence API, remplacez les valeurs et choisissez une heure ISO-8601 future avec décalage. Cette requête crée une véritable programmation ; confirmez le compte, le texte et l’heure avant l’envoi.

Pour un post TEXT, laissez media vide. Gardez une clé d’idempotence pour cette requête et enregistrez post.id pour suivre son statut. Utilisez un provider_payload Threads avec ce compte.

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

- [Référence de l’API de publication](https://sosoapi.ai/fr/docs/publishing-api-reference)

## 3. Utiliser une image enregistrée prête

Pour une image locale, utilisez sosoapi_upload_asset. Pour une URL publique d’image, appelez sosoapi_import_asset_url et vérifiez sosoapi_get_asset_import_status jusqu’à disponibilité. Utilisez l’identifiant de ressource enregistré et son URL canonique dans la publication.

Pour une création normale, définissez post_type sur IMAGE et ajoutez l’image prête à media. Le fragment ci-dessous remplace ces deux champs de l’exemple texte. Gardez la légende, le compte et l’heure, et utilisez une nouvelle clé stable pour cette nouvelle publication confirmée.

- Remplacez asset_id par le véritable entier positif, pas une chaîne numérique.

- Ne programmez pas avec l’URL source, une URL temporaire d’aperçu ou une importation inachevée.

- La même image de bibliothèque n’est réutilisable que si ses droits, son espace et le contenu choisi conviennent.

```
{
  "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. Vérifier la publication et éviter les envois en double

Lisez le Scheduled Post d’origine et vérifiez son résultat final. Un identifiant, une programmation acceptée ou un conteneur média Threads signifie que la requête existe, pas qu’elle est publiée. Affichez l’identifiant fournisseur ou le permalien s’il est disponible.

Si Threads traite encore la demande ou si la réponse est perdue, continuez à consulter la même publication. N’envoyez pas une autre création avec une autre clé. Reconnecter le compte ne démontre pas la réussite d’une écriture antérieure.

Une fois la publication d’un texte démarrée sur Threads, l’étape fournisseur peut ne plus être réversible. Suivez les actions renvoyées par SosoAPI au lieu de renvoyer la publication. Le délai de traitement peut varier.

- [Valider avec Claude Code ou Codex](https://sosoapi.ai/fr/docs/claude-code-codex-social-publishing)

- [Référence de l’API de publication](https://sosoapi.ai/fr/docs/publishing-api-reference)