Programa publicaciones de texto e imagen en Threads con SosoAPI

1. Conecta y comprueba el destino

Conecta en SosoAPI la cuenta de Threads prevista. El consentimiento del proveedor necesita threads_content_publish para publicar. El solicitante de SosoAPI también necesita un espacio de trabajo permitido, acceso editor y la capacidad agent:publish para programar.

Comprueba que SosoAPI haya devuelto la cuenta de Threads prevista. Ejecuta la comprobación de elegibilidad del borrador completo con contenido y hora antes de programar. Funciones como respuestas, ubicaciones y publicación compartida tienen requisitos adicionales de permisos y elegibilidad.

• Consulta la matriz de capacidades por plataforma

2. Programa una publicación de texto revisada

Usa la función auxiliar del servidor de la referencia API, sustituye los marcadores y elige una hora futura ISO-8601 con desplazamiento. Esta solicitud crea una programación real; confirma la cuenta, la redacción y la hora antes de enviarla.

Para una publicación TEXT, deja media vacío. Mantén una clave de idempotencia para esta solicitud y guarda el post.id devuelto para comprobar su estado. Usa un provider_payload de Threads con esta cuenta.

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

• Referencia de API de publicación

3. Usa una imagen registrada y lista

Para una imagen local, usa sosoapi_upload_asset. Para una URL pública de imagen, llama a sosoapi_import_asset_url y consulta sosoapi_get_asset_import_status hasta que esté lista. Usa el ID del recurso registrado y su URL canónica en la publicación.

Para la solicitud normal de creación, establece post_type en IMAGE y añade la imagen lista a media. El fragmento siguiente sustituye esos dos campos del ejemplo de texto. Conserva el texto, la cuenta y la hora, y usa una clave estable nueva para esta publicación recién confirmada.

• Sustituye asset_id por el entero positivo real, no por una cadena numérica.
• No programes con la URL de origen, una URL temporal de vista previa ni una importación sin terminar.
• La misma imagen de biblioteca solo puede reutilizarse si son adecuados sus derechos, espacio de trabajo y contenido elegido.

{
  "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. Verifica la publicación y evita envíos duplicados

Consulta la publicación programada original y su resultado definitivo. Un ID, programación aceptada o contenedor multimedia de Threads significa que existe la solicitud; no confirma publicación. Muestra el ID de publicación del proveedor o enlace permanente cuando esté disponible.

Si Threads sigue procesando o pierdes la respuesta, sigue consultando la misma publicación. No envíes otra solicitud de creación con otra clave. Volver a conectar la cuenta no determina si una escritura anterior tuvo éxito.

Una vez que Threads empieza a publicar texto, el paso del proveedor puede dejar de ser reversible. Sigue las acciones disponibles devueltas por SosoAPI en vez de reenviar. El tiempo de procesamiento puede variar.

• Revisa con Claude Code o Codex
• Referencia de API de publicación