Como funciona a API REST do Quick Event?

A API REST pública do Quick Event permite a criação de eventos via requisição HTTP: Endpoint: POST /api/public/create-event Autenticação: Nenhuma necessária — a API é de uso aberto. Limite de taxa: 5 eventos de demonstração por endereço IP a cada 24 horas. Você envia uma descrição (sugestão), incluindo opcionalmente data, local e idioma. O Quick Event usa IA para gerar uma página completa do evento com página inicial, formulário de inscrição, modelos de e-mail e categorias de ingressos. A resposta contém links diretos para a página do evento e para o formulário de inscrição. Os eventos de demonstração expiram após 30 dias. Com uma conta gratuita, você pode assumir o controle permanente do evento.

O que é o servidor MCP e como posso usá-lo?

O servidor MCP (Model Context Protocol) disponibiliza o Quick Event como uma ferramenta em assistentes de IA como o Claude Desktop: Descoberta: https://quick-event.com/.well-known/mcp.json Endpoint: https://quick-event.com/api/public/mcp Protocolo: JSON-RPC 2.0 sobre HTTP POST A ferramenta `create_event` aceita os mesmos parâmetros que a API REST. O Claude Desktop detecta automaticamente o servidor através da URL de descoberta `.well-known/mcp.json` e oferece a ferramenta na conversa.

Posso usar o Quick Event com o ChatGPT?

Sim — o Quick Event fornece uma especificação OpenAPI 3.1 e um manifesto de plugin de IA: • OpenAPI: https://quick-event.com/.well-known/openapi.yaml • Plugin: https://quick-event.com/.well-known/ai-plugin.json No Construtor de GPT do ChatGPT, adicione a URL OpenAPI como uma ação. A autenticação está definida como "Nenhuma". O GPT personalizado pode então criar eventos por meio de prompts e distribuir os links gerados diretamente aos usuários.

Os webhooks estão disponíveis?

Webhooks estão **no roadmap.** Os recursos planejados são: • Notificações em tempo real para inscrições e cancelamentos • Payloads assinados (HMAC-SHA256) para verificação segura • Apenas HTTPS com lógica de repetição (3× backoff exponencial) • Filtros de evento configuráveis por URL de webhook A integração de webhook possibilitará conectar o Quick Event a qualquer sistema externo — CRM, Slack, seus próprios backends. Envie uma solicitação de recurso na página do roadmap para ser notificado quando for lançado.

Preciso de uma chave de API ou autenticação?

Não. A API pública não requer autenticação. Qualquer pessoa pode criar um evento por meio de uma solicitação POST. A única limitação é o limite de taxa: um máximo de 5 eventos de demonstração por endereço IP em 24 horas. Os eventos criados expiram após 30 dias, a menos que sejam tornados permanentes através do registro de uma conta gratuita. Todas as conexões são feitas via HTTPS com TLS 1.3.

Quais serviços de terceiros a Quick Event utiliza?

O Quick Event utiliza os seguintes serviços em segundo plano: • SendGrid: Entrega de e-mails com suporte a domínios personalizados (DKIM, SPF) • Stripe: Processamento de pagamentos para ingressos e assinaturas pagas • Pexels: Fotos de banco de imagens gratuitas disponíveis diretamente no construtor de páginas. • Cloudflare: Hospedagem (Workers), armazenamento de arquivos (R2), certificados SSL, domínios personalizados e CDN Esses serviços são totalmente integrados — você não precisa criar suas próprias contas para usar o Quick Event.

Integrações e API

O Quick Event pode ser integrado a fluxos de trabalho externos de várias maneiras — um endpoint público de criação de eventos, um servidor MCP para assistentes de IA como o Claude Desktop, um manifesto OpenAPI para GPTs personalizados do ChatGPT e uma API REST completa planejada para leitura de dados de eventos, participantes e inscrições. Este artigo descreve as interfaces disponíveis e os serviços de terceiros que operam em segundo plano.

Visão geral

Atualmente, estão disponíveis duas camadas de integração: o Servidor MCP , que fornece o Quick Event como uma ferramenta no Protocolo de Contexto de Modelo para assistentes de IA como o Claude Desktop, e uma especificação OpenAPI para integração com o ChatGPT e outras plataformas compatíveis com OpenAPI. Ambas as interfaces permitem que os usuários criem um evento completo com página de destino , formulário de inscrição , modelos de e-mail e categorias de ingressos usando descrições de texto.

API REST Parcial — API de leitura no roadmap

Um **endpoint público de criação de eventos** está ativo hoje em POST /api/public/create-event: envie uma descrição em linguagem natural (com data, local e idioma opcionais) e o Quick Event gera um evento completo — landing page, formulário de inscrição, modelos de e-mail, categorias de ingressos — usando IA. Nenhuma autenticação é necessária; o limite de taxa é de 5 eventos de demonstração por IP a cada 24 horas, e os eventos de demonstração expiram após 30 dias, a menos que sejam reivindicados por uma conta gratuita. O mesmo endpoint suporta o servidor MCP e a integração com o ChatGPT .

Uma **API de leitura completa** para acesso programático a eventos, participantes e inscrições está no roadmap. Ela permitirá que você integre o Quick Event com sistemas CRM existentes, ferramentas de marketing ou fluxos de trabalho internos sem exportações manuais de dados. Mutações autenticadas (cancelar uma inscrição, reembolsar um ingresso, editar dados do participante) estão planejadas junto com ela. Detalhes sobre endpoints, autenticação e formatos de dados serão divulgados com o lançamento.

Servidor MCP

O servidor MCP (Model Context Protocol) torna o Quick Event disponível como uma ferramenta em assistentes de IA. O Claude Desktop e outros clientes compatíveis com MCP descobrem automaticamente o servidor através do URL de descoberta https://quick-event.com/.well-known/mcp.json .

O servidor implementa o protocolo JSON-RPC-2.0 via HTTP POST em /api/public/mcp . Ele suporta os métodos initialize , tools/list e tools/call . A única ferramenta registrada é chamada create_event e aceita os mesmos parâmetros da API REST.

Na prática, isso significa: você descreve um evento no Claude Desktop e o assistente o cria usando a ferramenta MCP. Os links gerados são exibidos diretamente na conversa.

Configuração no Claude Desktop

Nas configurações da área de trabalho do Claude, adicione uma nova conexão em Servidor MCP. O URL de descoberta é https://quick-event.com/.well-known/mcp.json . Depois de adicioná-la, a ferramenta create_event estará disponível em todas as novas conversas.

Integração do ChatGPT

O Quick Event fornece dois arquivos de manifesto para o ChatGPT: uma especificação OpenAPI 3.1 em /.well-known/openapi.yaml e um manifesto de plugin de IA em /.well-known/ai-plugin.json .

No Construtor de GPT do ChatGPT, você adiciona a URL OpenAPI como uma ação. O campo de autenticação permanece definido como "Nenhum". O GPT personalizado pode então criar eventos de solicitação e distribuir os links gerados aos usuários. A especificação OpenAPI documenta completamente o endpoint, incluindo o esquema de solicitação, exemplos de resposta e códigos de erro.

Webhooks Planejado

Webhooks estão **no roadmap.** Eles possibilitarão o envio automático de requisições HTTP para uma URL configurável em resposta a certos eventos — como uma nova inscrição, um cancelamento ou uma mudança de status.

A arquitetura planejada inclui payloads assinados (HMAC-SHA256), entrega apenas via HTTPS e lógica de repetição com três tentativas e backoff exponencial. Filtros de evento permitirão a inscrição apenas em tipos de evento específicos por URL de webhook.

Assim que os webhooks estiverem disponíveis, eles permitirão fluxos de trabalho como notificações do Slack para novas inscrições, sincronização de CRM ou e-mails de acompanhamento automáticos via sistemas externos. Quer ser notificado quando isso for lançado? Envie uma solicitação na página do roadmap .

Serviços de terceiros

O Quick Event usa vários serviços especializados em segundo plano. Como usuário, você não precisa criar uma conta separada com nenhum desses provedores — a integração é totalmente incorporada à plataforma.

SendGrid (E-mail)

Todos os e-mails transacionais — confirmações de inscrição, lembretes, e-mails de campanha — são entregues via SendGrid. O Quick Event configura automaticamente os registros DKIM e SPF para domínios personalizados , garantindo que os e-mails sejam enviados do seu próprio endereço de remetente e alcancem uma alta taxa de entrega .

Stripe (Pagamentos)

Ingressos pagos são processados via **Stripe Connect** — os fundos são direcionados diretamente para a conta bancária do organizador, nunca retidos pelo Quick Event. O Studio te integra ao Stripe Connect no primeiro evento pago, exibe o status chargesEnabled e payoutsEnabled, e lida com reembolsos e faturas compatíveis com IVA automaticamente. Cartão, Apple Pay, Google Pay, SEPA e outros métodos de pagamento locais são suportados de imediato. A taxa por ingresso do Quick Event (€0,99 + 2,75 %) é deduzida de cada pagamento do Stripe — veja Ingressos pagos para o fluxo completo.

Pexels (fotos de banco de imagens)

O construtor de páginas inclui uma busca de imagens integrada via API do Pexels. Você pode escolher entre milhões de fotos gratuitas e livres de royalties diretamente ao criar uma página de evento e integrá-las à sua página — sem qualquer download ou upload separado.

Cloudflare (Infraestrutura)

Toda a plataforma roda em Cloudflare Workers. Arquivos (logotipos, PDFs, imagens) são armazenados no Cloudflare R2. Domínios personalizados recebem automaticamente certificados SSL via Cloudflare for SaaS. A CDN global garante tempos de carregamento rápidos, independentemente da localização dos participantes.