Automação de agendamento para desenvolvedores
Automatize agendamento com uma API de verdade
O WhenToMeet tem uma API decente pra automatizar agendamento. Coloque dentro do seu app, deixe seus agentes de IA criarem enquetes, sincronize com seus sistemas. tRPC pra type safety, webhooks pra eventos, spec OpenAPI pra codegen.
O Desafio
- ✕Ferramentas de agendamento têm APIs que parecem feitas no susto — endpoints limitados, auth estranho, sem webhooks
- ✕Criar enquetes manualmente toda vez é chato. Você quer automação.
- ✕Seu assistente de IA poderia agendar reuniões, mas as APIs são complexas demais pra explicar
- ✕Precisa de agendamento no seu app mas não quer construir lógica de fuso horário do zero
- ✕Quer agendamento programático sem o preço enterprise
Como o WhenToMeet ajuda
Feito pra automação
Cada recurso é acessível via API. Crie enquetes, verifique disponibilidade, finalize horários — tudo programável. Perfeito pra scripts, apps e agentes de IA.
Pronto pra agentes de IA
API limpa + documentação llms.txt significa que agentes de IA conseguem usar. Claude, ChatGPT ou seus agentes custom podem agendar reuniões com um único prompt.
Eventos via webhook
Notificações em tempo real quando eventos são criados, finalizados ou bookings chegam. Construa sistemas reativos sem precisar de polling.
Tratamento de fuso horário
Armazene horários em UTC, exiba no fuso do usuário. A gente cuida das transições de horário de verão e dos casos extremos pra você não precisar.
Integração simples
Uma chamada de API pra criar um evento. Receba de volta uma URL compartilhável. Sem fluxos de OAuth complexos nem setup de SDK.
Recursos Principais
Spec OpenAPI
Especificação OpenAPI 3.0 completa em /api/openapi.json. Gere clientes em qualquer linguagem. Autocomplete na sua IDE.
Endpoints tRPC
API com type safety usando tRPC. Autocomplete completo em TypeScript. Validação de request/response embutida.
Chaves de API com escopo
Crie chaves com permissões específicas. Read-only pra analytics. Write-only pra criação de eventos. Revogue quando quiser.
Webhooks
Inscreva-se em eventos: event.created, event.finalized, booking.confirmed. A gente faz POST no seu endpoint com retries.
llms.txt pra agentes de IA
Docs legíveis por máquina em /llms.txt. Seu assistente de IA entende nossa API sem precisar ler docs em HTML. Só aponta pra URL.
Comece em 3 Passos
Gere chave de API
Crie uma chave de API pelo painel. Escolha escopos (leitura, escrita ou ambos). Copie a chave.
Chame a API
POST em /api/v1/polls com título e slots de horário. Receba o ID da enquete e URL compartilhável. Ou deixe seu agente de IA fazer.
Automatize
Consulte o status via API ou use webhooks pra updates. Finalize programaticamente quando todo mundo votar. Integre com seu fluxo de trabalho.
Boas práticas para automação de agendamento
- ✓Guarde IDs de evento no seu banco de dados, não os dados completos do evento. Use a API como fonte da verdade.
- ✓Use webhooks em vez de polling pra updates em tempo real. Mais eficiente, menos chamadas de API.
- ✓Pra agentes de IA: aponte pra /llms.txt pra que entendam a API sem explicações.
- ✓Gere chaves de API separadas pra integrações diferentes. Mais fácil de rotacionar se uma for comprometida.
- ✓Use a spec OpenAPI pra gerar clientes tipados na sua linguagem. Não escreva chamadas HTTP na mão.
Perguntas Frequentes
A API é cidadã de segunda classe?+−
Não. O WhenToMeet é construído como infraestrutura de agendamento. A UI e a API usam o mesmo backend. Cada recurso é acessível programaticamente.
Qual é o limite de taxa?+−
Plano gratuito: 32 requisições por toda a vida. Plano Pro: 1000 requisições/hora. Enterprise: limites custom. Todos os planos incluem cabeçalhos X-RateLimit nas respostas.
Posso usar isso sem a UI?+−
Sim. Crie eventos, colete disponibilidade, finalize horários — tudo via API. A UI está lá quando você precisar, mas a automação tem suporte completo.
Agentes de IA podem usar a API?+−
Sim. A gente publica llms.txt pra que assistentes de IA entendam nossa API. Claude, ChatGPT ou agentes custom podem criar e gerenciar eventos de agendamento. Só dá pra IA a chave de API e aponta pros docs.
Que frameworks funcionam bem com a API?+−
Qualquer framework que consiga fazer requisições HTTP. Projetos TypeScript ganham type safety completo com nosso cliente tRPC. Python, Go, Ruby, PHP funcionam todos via REST.
Como funcionam os webhooks?+−
Cadastre uma URL de webhook no seu painel. A gente faz POST com payloads JSON quando eventos acontecem. Verifique assinaturas com o cabeçalho X-Webhook-Signature. Retries embutidos com backoff exponencial.
Isso serve pra construir meu próprio produto de agendamento?+−
Sim. Use o WhenToMeet como infraestrutura de agendamento. Crie eventos via API, embute enquetes no seu app ou construa interfaces totalmente custom em cima do nosso backend.
Pronto para simplificar o agendamento?
Grátis para sempre. Nenhum cartão de crédito necessário.