API Tutorial
Cómo publicar en Telegram por API
Para publicar en Telegram por API, conecta la cuenta de Telegram 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 Telegram y devuelve el ID de la publicación.
La propia API de Telegram 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 Telegram (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 Telegram
En el panel, haz clic en Conectar y elige Telegram. 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 Telegram. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_create para publicar en Telegram
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 Telegram (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 Telegram 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 Telegram
Empieza gratisPreguntas frecuentes
¿Necesito una app de desarrollador de Telegram para publicar por API?
No. Modiva posee la app de Telegram 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 Telegram 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 Telegram en cuanto añadas tu clave MCP de Modiva.