API Tutorial
Cómo enviar mensajes de X por API
Para enviar mensajes de X por API, conecta X 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 X 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 X 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 X
En el panel, haz clic en Conectar y elige X. 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 X. 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 X y devuelve el ID del mensaje, respetando las ventanas y reglas de mensajería de X.
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 X, 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 X
Empieza gratisPreguntas frecuentes
¿Puedo construir una bandeja de entrada unificada que incluya X?
Sí. `messages_inbox` devuelve las conversaciones de X 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 X?
Sí — Modiva aplica las ventanas de mensajería y los requisitos de política de X, para que tus envíos sigan siendo conformes.