API Tutorial

Cómo obtener analíticas de Discord por API

Para obtener analíticas de Discord por API, conecta Discord a través de Modiva y luego llama a `analytics_unified` — devuelve alcance, impresiones, engagement y métricas de seguidores en una forma normalizada que puedes visualizar o analizar.

Cada plataforma reporta las métricas de forma distinta, así que el reporting entre plataformas suele implicar una capa de mapeo por red. La herramienta `analytics_unified` de Modiva devuelve las métricas de Discord en el mismo esquema que cualquier otra plataforma, de modo que una sola consulta impulsa un panel entero.

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.

Llama a analytics_unified para las métricas de Discord

Llama a `analytics_unified` con el ID de conexión, las métricas que quieres y un rango de fechas. Modiva las obtiene de Discord, normaliza los nombres de los campos y devuelve una forma JSON consistente, lista para visualizar.

Agrupa todas las plataformas en un solo informe

Pasa varios ID de conexión para combinar Discord con el resto de tu stack en una sola respuesta. A través de MCP, un agente puede recuperar las cifras y redactar el informe semanal por ti, y luego llamar a `analytics_best_time_to_post` para programar el siguiente.

Solicitud de ejemplo

Llama a la herramienta analytics_unified 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.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "analytics_unified",
    "connectionId": "conn_…",
    "args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
  }'

Pruébalo con Discord

Empieza gratis

Preguntas frecuentes

¿Son las métricas de Discord comparables con las de otras plataformas?

Sí — Modiva normaliza las analíticas de Discord en un esquema común, de modo que el alcance y el engagement encajan a través de cualquier red conectada.

¿Puede un agente de IA elaborar el informe?

Sí. Expón `analytics_unified` a través de MCP y un agente podrá recuperar las cifras de Discord y redactar el resumen por su cuenta.

Sigue construyendo con Discord

Integración de la API de Discord Servidor MCP de Discord Cómo publicar en Discord por API Cómo programar publicaciones de Discord por API Cómo leer y responder comentarios de Discord por API Cómo enviar mensajes de Discord por API Cómo obtener analíticas de Instagram por API