API Tutorial
Cómo programar publicaciones de Threads por API
Para programar publicaciones de Threads por API, conecta Threads a través de Modiva y luego llama a `posts_schedule` con tu contenido y una marca de tiempo `publish_at` — Modiva lo pone en cola y lo publica automáticamente en Threads a esa hora.
Programar significa guardar una publicación y publicarla más tarde de forma fiable — algo que la API de Threads deja enteramente en tus manos. Modiva opera la cola, reintenta ante errores transitorios de Threads y expone una única herramienta `posts_schedule` que funciona igual en cualquier plataforma.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de Threads
En el panel, haz clic en Conectar y elige Threads. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de Threads. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_schedule con una hora publish_at
Llama a `posts_schedule` con el ID de conexión, tu contenido y una marca de tiempo `publish_at` en formato ISO. Modiva guarda el trabajo y publica en Threads a esa hora, encargándose de la renovación de tokens y los reintentos sin que tengas tu propio cron.
Encuentra el mejor momento y agrupa un calendario
Llama a `analytics_best_time_to_post` para elegir una franja horaria y luego programa una semana entera en un bucle. A través de MCP, un agente de IA puede planificar y poner en cola un calendario de contenido completo de Threads a partir de un solo prompt.
Solicitud de ejemplo
Llama a la herramienta posts_schedule a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Pruébalo con Threads
Empieza gratisPreguntas frecuentes
¿El programador lo opera Modiva o yo?
Modiva. En cuanto llamas a `posts_schedule`, Modiva guarda el trabajo y publica en Threads a la hora deseada — no necesitas tu propia cola ni cron.
¿Puedo programar la misma publicación para varias plataformas?
Sí — pasa varios ID de conexión (o usa `posts_cross_post`) y Modiva programa la publicación para Threads y para cualquier otra plataforma, adaptada al formato de cada una.