API Tutorial
Cómo publicar en WhatsApp por API
Para publicar en WhatsApp por API, conecta la cuenta de WhatsApp a través de Modiva (que se encarga de OAuth y los scopes) y luego llama a la herramienta `posts_create` con tu texto y tus medios — Modiva lo publica en WhatsApp y devuelve el ID de la publicación.
La propia API de WhatsApp exige revisión de la app, gestión de OAuth y los permisos de publicación correctos antes de que puedas publicar siquiera una actualización. Modiva se ocupa de todo eso por ti y expone una única herramienta `posts_create` que publica en WhatsApp (y en cualquier otra plataforma conectada) de la misma manera.
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_create para publicar en WhatsApp
Llama a la herramienta `posts_create` con el ID de conexión y tu contenido. Modiva valida el payload frente a las reglas de formato de WhatsApp (longitud, tipos de medios, relaciones de aspecto) y publica al instante, devolviendo el ID y la URL de la publicación en vivo.
Haz más — programa, publica de forma cruzada, automatiza
La misma llamada impulsa a un agente de IA a través de MCP: apunta a Claude o Cursor a `https://mcp.modiva.ai/v1` y podrá publicar en WhatsApp en tu nombre. Cambia `posts_create` por `posts_schedule` para ponerlo en cola, o `posts_cross_post` para difundir una publicación a todas las plataformas de una vez.
Solicitud de ejemplo
Llama a la herramienta posts_create 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_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Pruébalo con WhatsApp
Empieza gratisPreguntas frecuentes
¿Necesito una app de desarrollador de WhatsApp para publicar por API?
No. Modiva posee la app de WhatsApp ya revisada y se encarga de OAuth, así que te conectas con un clic y empiezas — sin revisión de la app, sin lidiar con scopes.
¿Puede un agente de IA publicar en WhatsApp por mí?
Sí. La misma herramienta `posts_create` se expone a través del Model Context Protocol, de modo que cualquier cliente MCP (Claude, Cursor, etc.) puede publicar en WhatsApp en cuanto añadas tu clave MCP de Modiva.