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