¿Cómo funciona la API REST de Quick Event?

La API REST pública de Quick Event permite la creación de eventos a través de una solicitud HTTP: Punto final: POST /api/public/create-event Autenticación: No se requiere; la API se puede utilizar abiertamente. Límite de velocidad: 5 eventos de demostración por dirección IP cada 24 horas. Envía una descripción (mensaje), que puede incluir la fecha, la ubicación y el idioma. Quick Event utiliza IA para generar una página completa del evento con una página de destino, un formulario de registro, plantillas de correo electrónico y categorías de entradas. La respuesta contiene enlaces directos a la página del evento y al formulario de registro. Los eventos de demostración caducan a los 30 días. Con una cuenta gratuita, puedes controlar el evento de forma permanente.

¿Qué es el servidor MCP y cómo lo uso?

El **servidor MCP** (Protocolo de Contexto del Modelo) hace que Quick Event esté disponible como una herramienta en asistentes de IA como Claude Desktop, Cursor y Claude Code: **Endpoint:** https://quick-event.com/api/public/mcp **Transporte:** HTTP Transmitible (JSON-RPC 2.0 sobre POST) **Versión del protocolo:** 2025-11-25 **Autenticación:** ninguna La herramienta `create_event` acepta los mismos parámetros que la API REST. Los clientes MCP no se descubren automáticamente desde una URL; tú añades el endpoint a la configuración MCP del cliente (por ejemplo, claude_desktop_config.json ), y la herramienta estará disponible en cada nueva conversación.

¿Puedo utilizar Quick Event con ChatGPT?

**Sí** — a través de un GPT personalizado con una Acción respaldada por nuestra especificación OpenAPI 3.1: • **OpenAPI:** https://quick-event.com/.well-known/openapi.yaml En el ChatGPT GPT Builder, crea un nuevo GPT y añade la URL de OpenAPI en "Acciones". La autenticación se establece en "Ninguna". El GPT personalizado puede entonces crear eventos a través de un prompt y distribuir los enlaces generados a los usuarios. Nota: la plataforma de plugins de ChatGPT heredada fue deprecada por OpenAI en 2024; hoy solo se admiten GPTs personalizados / Acciones.

¿Están disponibles los webhooks?

Los webhooks están en la hoja de ruta. Las características planificadas son: • Notificaciones en tiempo real para registros y cancelaciones • Cargas útiles firmadas (HMAC-SHA256) para una verificación segura • Solo HTTPS con lógica de reintentos (3× retroceso exponencial) • Filtros de eventos configurables por URL de webhook La integración de webhooks hará posible conectar Quick Event a cualquier sistema externo — CRM, Slack, tus propios backends. Envía una solicitud de característica en la página de la hoja de ruta para que te notifiquemos cuando esté disponible.

¿Necesito una clave API o autenticación?

No. La API pública no requiere autenticación. Cualquiera puede crear un evento mediante una solicitud POST. La única limitación es el límite de velocidad: un máximo de 5 eventos de demostración por dirección IP en 24 horas. Los eventos creados caducan a los 30 días, a menos que se conviertan en permanentes mediante el registro de una cuenta gratuita. Todas las conexiones se realizan mediante HTTPS con TLS 1.3.

¿Qué servicios de terceros utiliza Quick Event?

Quick Event utiliza los siguientes servicios en segundo plano: • SendGrid: Entrega de correo electrónico con soporte de dominio personalizado (DKIM, SPF) • Stripe: Procesamiento de pagos para tickets y suscripciones pagadas • Pexels: Fotos de stock gratuitas disponibles directamente en el creador de páginas • Cloudflare: Hosting (Workers), almacenamiento de archivos (R2), certificados SSL, dominios personalizados y CDN Estos servicios están completamente integrados: no es necesario crear sus propias cuentas para utilizar Quick Event.

Integraciones y API

Quick Event se puede integrar en flujos de trabajo externos de varias maneras: un endpoint público de creación de eventos, un servidor MCP para asistentes de IA como Claude Desktop, un manifiesto OpenAPI para GPTs personalizados de ChatGPT y una API REST completa planificada para leer datos de eventos, participantes y registros. Este artículo describe las interfaces disponibles y los servicios de terceros que operan en segundo plano.

Descripción general

Actualmente, hay dos capas de integración disponibles: el Servidor MCP , que proporciona Quick Event como herramienta en el Protocolo de Contexto de Modelo para asistentes de IA como Claude Desktop, y una especificación OpenAPI para la integración con ChatGPT y otras plataformas compatibles con OpenAPI. Ambas interfaces permiten a los usuarios crear un evento completo con una página de destino , un formulario de registro , plantillas de correo electrónico y categorías de tickets mediante descripciones de texto.

API REST Parcial — API de lectura en la hoja de ruta

Un endpoint público de creación de eventos está activo hoy en POST /api/public/create-event: envía una descripción en lenguaje natural (con fecha, ubicación e idioma opcionales) y Quick Event genera un evento completo — página de aterrizaje, formulario de registro, plantillas de correo electrónico, categorías de entradas — utilizando IA. No se requiere autenticación; el límite de tasa es de 5 eventos de demostración por IP cada 24 horas, y los eventos de demostración caducan después de 30 días a menos que sean reclamados por una cuenta gratuita. El mismo endpoint respalda el servidor MCP y la integración con ChatGPT.

Una API de lectura completa para el acceso programático a eventos, participantes y registros está en la hoja de ruta. Te permitirá integrar Quick Event con sistemas CRM existentes, herramientas de marketing o flujos de trabajo internos sin exportaciones manuales de datos. Las mutaciones autenticadas (cancelar un registro, reembolsar una entrada, editar datos del participante) están planificadas junto con ella. Los detalles sobre los endpoints, la autenticación y los formatos de datos se publicarán con el lanzamiento.

Servidor MCP

El servidor MCP (Protocolo de Contexto del Modelo) hace que Quick Event esté disponible como una herramienta en asistentes de IA como Claude Desktop, Cursor, Claude Code y cualquier otro cliente compatible con MCP.

El servidor implementa la versión 2025-11-25 del protocolo MCP sobre el transporte HTTP Transmitible en /api/public/mcp (JSON-RPC 2.0, sin autenticación, CORS habilitado). Soporta los métodos initialize, tools/list y tools/call. La única herramienta registrada es create_event y acepta los mismos parámetros que la API REST.

En la práctica: tú describes un evento a tu asistente de IA, y este llama a la herramienta MCP para crearlo. Los enlaces generados aparecen en línea en la conversación.

Configuración en Claude Desktop

Los clientes MCP no descubren automáticamente los servidores desde una URL; tú añades el endpoint al archivo de configuración del cliente. En Claude Desktop, edita claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración) y añade un servidor MCP remoto que apunte a https://quick-event.com/api/public/mcp. Reinicia Claude Desktop y la herramienta create_event estará disponible en nuevas conversaciones. Cursor, Claude Code y otros clientes utilizan un patrón de archivo de configuración similar. Un resumen del servidor legible por máquina (nombre, endpoint, esquemas de herramientas) también se publica en /.well-known/mcp.json para documentación y herramientas que deseen leerlo.

Integración con ChatGPT

Quick Event publica una especificación OpenAPI 3.1 en /.well-known/openapi.yaml para usarla como una Acción de GPT personalizado de ChatGPT.

En el ChatGPT GPT Builder, crea un nuevo GPT, abre Configurar → Acciones e importa la URL de OpenAPI. El campo de autenticación permanece en "Ninguna". El GPT personalizado puede entonces crear eventos a partir de un prompt y mostrar los enlaces resultantes al usuario. La especificación OpenAPI documenta el endpoint en su totalidad: esquema de solicitud, ejemplos de respuesta y códigos de error.

La plataforma de plugins de ChatGPT heredada (con su manifiesto ai-plugin.json) fue deprecada por OpenAI en 2024 y ya no es compatible; los GPTs personalizados con Acciones de OpenAPI son el camino actual.

Webhooks Planificado

Los webhooks están en la hoja de ruta. Harán posible enviar automáticamente solicitudes HTTP a una URL configurable en respuesta a ciertos eventos, como un nuevo registro, una cancelación o un cambio de estado.

La arquitectura planificada incluye cargas útiles firmadas (HMAC-SHA256), entrega solo por HTTPS y lógica de reintentos con tres intentos y retroceso exponencial. Los filtros de eventos permitirán suscribirse solo a tipos de eventos específicos por URL de webhook.

Una vez que los webhooks estén disponibles, habilitarán flujos de trabajo como notificaciones de Slack para nuevos registros, sincronización de CRM o correos electrónicos de seguimiento automáticos a través de sistemas externos. ¿Quieres que te notifiquemos cuando esto esté disponible? Envía una solicitud en la página de la hoja de ruta.

Servicios de terceros

Quick Event utiliza varios servicios especializados en segundo plano. Como usuario, no necesitas crear una cuenta separada con ninguno de estos proveedores; la integración está completamente integrada en la plataforma.

SendGrid (Correo electrónico)

Todos los correos electrónicos transaccionales —confirmaciones de registro, recordatorios, correos de campaña— se entregan a través de SendGrid. Quick Event configura automáticamente los registros DKIM y SPF para dominios personalizados, asegurando que los correos electrónicos se envíen desde tu propia dirección de remitente y logren una alta tasa de entrega.

Stripe (Pagos)

Las entradas de pago se procesan a través de Stripe Connect; los fondos se dirigen directamente a la cuenta bancaria del organizador, nunca son retenidos por Quick Event. El Studio te incorpora a Stripe Connect en tu primer evento de pago, muestra el estado de chargesEnabled y payoutsEnabled, y gestiona automáticamente los reembolsos y las facturas conformes con el IVA. Se admiten de forma predeterminada tarjetas, Apple Pay, Google Pay, SEPA y otros métodos de pago locales. La tarifa por entrada de Quick Event (€0.99 + 2.75 %) se deduce de cada pago de Stripe; consulta Entradas de pago para ver el flujo completo.

Pexels (fotos de stock)

El creador de páginas incluye una búsqueda de imágenes integrada a través de la API de Pexels. Puedes elegir entre millones de fotos gratuitas y libres de derechos directamente al crear una página de evento e integrarlas en tu página, sin necesidad de descargas o subidas separadas.

Cloudflare (Infraestructura)

Toda la plataforma funciona con Cloudflare Workers. Los archivos (logotipos, PDF, imágenes) se almacenan en Cloudflare R2. Los dominios personalizados reciben automáticamente certificados SSL a través de Cloudflare para SaaS. La CDN global garantiza tiempos de carga rápidos, independientemente de la ubicación de los participantes.