API Tutorial
Cómo enviar mensajes de Instagram por API
Para enviar mensajes de Instagram por API, conecta Instagram a través de Modiva y luego llama a `messages_send` con el destinatario y el texto — lee la conversación con `messages_list` para impulsar bandejas de entrada y respuestas automáticas con IA.
La mensajería programática en Instagram suele implicar abrirse paso entre APIs de mensajería específicas de cada plataforma y sus aprobaciones. Modiva lo abstrae en `messages_send`, `messages_list` y `messages_inbox`, de modo que una bandeja de entrada unificada o un respondedor de IA funcionan en Instagram igual que en cualquier otro sitio.
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 Instagram
En el panel, haz clic en Conectar y elige Instagram. 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 Instagram. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Envía un mensaje con messages_send
Llama a `messages_send` con el ID de conexión, un `recipient_id` y tu texto. Modiva lo entrega a través de Instagram y devuelve el ID del mensaje, respetando las ventanas y reglas de mensajería de Instagram.
Construye una bandeja de entrada o un respondedor de IA
Usa `messages_inbox` y `messages_list` para traer las conversaciones a una sola vista. A través de MCP, un agente puede leer un mensaje entrante de Instagram, decidir una respuesta y contestar con `messages_send` — un ciclo completo de soporte con IA.
Solicitud de ejemplo
Llama a la herramienta messages_send 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": "messages_send",
"connectionId": "conn_…",
"args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
}'Pruébalo con Instagram
Empieza gratisPreguntas frecuentes
¿Puedo construir una bandeja de entrada unificada que incluya Instagram?
Sí. `messages_inbox` devuelve las conversaciones de Instagram en la misma forma que cualquier otro canal, de modo que una única interfaz de bandeja de entrada las cubre todas.
¿Respeta Modiva las reglas de mensajería de Instagram?
Sí — Modiva aplica las ventanas de mensajería y los requisitos de política de Instagram, para que tus envíos sigan siendo conformes.