Integracions mitjançant API, MCP i Webhooks

L'**API REST pública** de Quick Event permet la creació d'esdeveniments mitjançant sol·licitud HTTP:

**Punt final:** POST /api/public/create-event
**Autenticació:** No es requereix — l'API és d'ús obert.
**Límit de tarifes:** 5 esdeveniments de demostració per adreça IP cada 24 hores.

Vostè envia una descripció (prompt), opcionalment incloent data, ubicació i idioma. Quick Event utilitza la IA per generar una pàgina d'esdeveniment completa amb una pàgina d'aterratge, un formulari d'inscripció, plantilles de correu electrònic i categories de tiquets. La resposta conté enllaços directes a la pàgina de l'esdeveniment i al formulari d'inscripció.

Els esdeveniments de demostració caduquen després de 30 dies. Amb un compte gratuït, pot prendre el control permanent de l'esdeveniment.

El **Servidor MCP** (Model Context Protocol) fa que Quick Event estigui disponible com a eina en assistents d'IA com Claude Desktop, Cursor i Claude Code:

**Punt final:** https://quick-event.com/api/public/mcp
**Transport:** HTTP transmissible (JSON-RPC 2.0 per POST)
**Versió del protocol:** 2025-11-25
**Autenticació:** cap

L'eina `create_event` accepta els mateixos paràmetres que l'API REST. Els clients MCP no es descobreixen automàticament des d'una URL — vostè afegeix el punt final a la configuració MCP del client (p. ex. claude_desktop_config.json), i l'eina estarà disponible en cada nova conversa.

**Sí** — mitjançant un GPT personalitzat amb una Acció recolzada per la nostra especificació OpenAPI 3.1:

• **OpenAPI:** https://quick-event.com/.well-known/openapi.yaml

Al ChatGPT GPT Builder, creï un nou GPT i afegeixi l'URL d'OpenAPI a "Accions". L'autenticació es defineix com a "Cap". El GPT personalitzat pot llavors crear esdeveniments mitjançant un prompt i distribuir els enllaços generats als usuaris. Nota: la plataforma de Plugins de ChatGPT heretada va ser deprecada per OpenAI el 2024 — avui només s'admeten GPTs personalitzats / Accions.

Els Webhooks estan **en el full de ruta.** Les funcionalitats planificades són:

• Notificacions en temps real per a inscripcions i cancel·lacions
• Càrregues útils signades (HMAC-SHA256) per a una verificació segura
• Només HTTPS amb lògica de reintent (3× retrocés exponencial)
• Filtres d'esdeveniments configurables per URL de webhook

La integració de webhook permetrà connectar Quick Event a qualsevol sistema extern — CRM, Slack, els seus propis backends. Enviï una sol·licitud de funcionalitat a la pàgina del full de ruta per ser notificat quan estigui disponible.

No. L'API pública no requereix autenticació. Qualsevol pot crear un esdeveniment mitjançant una sol·licitud POST.

L'única limitació és el límit de freqüència: un màxim de 5 esdeveniments de demostració per adreça IP en 24 hores. Els esdeveniments creats caduquen al cap de 30 dies, tret que es facin permanents registrant un compte gratuït.

Totes les connexions són via HTTPS amb TLS 1.3.

Quick Event utilitza els següents serveis en segon pla:

• **SendGrid:** Lliurament de correu electrònic amb suport de domini personalitzat (DKIM, SPF)
• **Stripe:** Processament de pagaments per a entrades de pagament i subscripcions
• **Pexels:** Fotos de stock gratuïtes disponibles directament al creador de pàgines
• **Hetzner:** Allotjament, base de dades i emmagatzematge de fitxers en centres de dades alemanys

Aquests serveis estan totalment integrats — vostè no necessita crear els seus propis comptes per utilitzar Quick Event.

Quick Event no ofereix un widget o iframe per a la incrustació. L'enfocament més net és cridar l'API REST pública (POST /api/public/create-event) des del seu propi backend i redirigir els usuaris a l'URL de l'esdeveniment generat. No es necessita autenticació, i l'API retorna un enllaç directe a la pàgina de l'esdeveniment i al formulari d'inscripció en segons.

Una API de lectura completa per a esdeveniments, participants i reserves està en el full de ruta de Quick Event. Fins que no s'implementi, pot exportar les dades dels participants manualment des de l'Studio. També es preveuen webhooks —que enviaran esdeveniments d'inscripció i cancel·lació a una URL de la seva elecció—, fent possible la sincronització automàtica del CRM sense necessitat de sondeig.

La propera API de lectura proporcionarà accés programàtic a esdeveniments, assistents i registres de reserves. Les mutacions autenticades, com cancel·lar una reserva o editar dades d'assistents, estan planificades juntament amb ella. L'estructura exacta dels endpoints, el mètode d'autenticació i els formats de dades es publicaran amb el llançament.

Els pagaments van directament al seu compte bancari a través de Stripe Connect. Quick Event mai reté fons: l'Studio el guia a través de l'onboarding de Stripe Connect quan crea el seu primer esdeveniment de pagament, i cada pagament es dirigeix directament al seu compte. La tarifa de pagament de Quick Event per a entrades de pagament —3,25 % + 0,25 € per reserva (més IVA sobre la tarifa), processament de targetes inclòs— es dedueix de cada pagament, de manera que no hi ha una factura separada. Els mòduls es compren una vegada per esdeveniment i no es veuen afectats per la quantitat que ven.

Sí. El constructor de pàgines de Quick Event integra l'API de Pexels, donant-li accés a milions de fotos lliures de drets directament dins de l'editor. No necessita un compte de Pexels ni una llicència separada; la integració està totalment incrustada a la plataforma.

Tots els correus electrònics transaccionals s'envien a través de SendGrid. Quan utilitza un domini de remitent personalitzat, Quick Event configura automàticament els registres DKIM i SPF per a aquest domini, que són els principals factors tècnics que determinen la capacitat d'entrega. No necessita un compte de SendGrid; la integració s'executa íntegrament dins de Quick Event.