API Tutorial
Cómo programar publicaciones de WhatsApp por API
Para programar publicaciones de WhatsApp por API, conecta WhatsApp 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 WhatsApp a esa hora.
Programar significa guardar una publicación y publicarla más tarde de forma fiable — algo que la API de WhatsApp deja enteramente en tus manos. Modiva opera la cola, reintenta ante errores transitorios de WhatsApp 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 WhatsApp
En el panel, haz clic en Conectar y elige WhatsApp. 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 WhatsApp. 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 WhatsApp 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 WhatsApp 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 WhatsApp
Empieza gratisPreguntas frecuentes
¿El programador lo opera Modiva o yo?
Modiva. En cuanto llamas a `posts_schedule`, Modiva guarda el trabajo y publica en WhatsApp 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 WhatsApp y para cualquier otra plataforma, adaptada al formato de cada una.