Desarrolladores (API · MCP · Webhooks)

La sección API · MCP (menú lateral, solo ADMIN) es para integrar Voxly con otros sistemas de forma técnica. Si no vas a programar integraciones, puedes omitir esta página. Tiene tres pestañas: MCP, API REST y Webhooks.

MCP (para la IA)

MCP es el mecanismo por el que el Analista IA accede (solo lectura) a tus datos para responder tus preguntas.

• Keys — las llaves MCP existentes y su estado.
• Audit — registro de uso.
• Nueva llave — creas una llave con nombre; su alcance es de solo lectura (MCP_READ). Verás las herramientas de lectura disponibles: listar encuestas, ver una encuesta, ver resultados, estadísticas de votos y resumen de encuesta.
• El token se muestra una sola vez al crearlo: cópialo y guárdalo en un lugar seguro.

No borres la llave del Analista

El chat Analista IA depende de una llave MCP válida. Si la revocas o eliminas, el chat dejará de poder consultar tus datos. (La generación de encuestas con IA usa otro mecanismo y no se ve afectada.)

API REST

Para que otros sistemas lean o escriban en Voxly mediante su API:

• Crear llave de API — el token se revela una sola vez al crearlo.
• Revocar — invalida una llave (con confirmación).
• Alcances (scopes) disponibles: leer encuestas, escribir encuestas, leer votos, gestionar webhooks, o todo.
• Incluye un ejemplo de inicio rápido (snippet curl) para probar.

Principio de mínimo privilegio

Crea cada llave con solo los permisos que necesita esa integración. Evita usar el alcance "todo" salvo que de verdad haga falta.

Webhooks

Los webhooks avisan a otro sistema en tiempo real cuando ocurre algo en Voxly (por ejemplo, un voto).

• Crear webhook — indicas la URL de destino y los tipos de evento que quieres recibir.
• Eventos sugeridos: vote.cast (voto emitido), vote.rejected (voto rechazado) o * (todos). Puedes añadir eventos personalizados.
• Entregas — panel para revisar los envíos y su resultado (útil para depurar).
• Eliminar — quita un webhook.

Ejemplo de uso

Podrías configurar un webhook a tu propio servidor para, cada vez que llega un vote.cast, actualizar un tablero externo o notificar a tu equipo.

¿Quién usa esta sección?

Está pensada para perfiles técnicos. Si tú solo creas y difundes encuestas, no necesitas tocar nada aquí: el Analista IA ya viene funcionando con su llave MCP.