Logo WhenToMeetWhenToMeet
Entrar

Sete pequenas automações que podes montar hoje com a API do WhenToMeet

O pitch mais curto para qualquer API é: eis o que podes construir numa tarde.

São sete automações reais em cima da REST API e do servidor MCP do WhenToMeet. Cada uma é o tipo de coisa que as pessoas costumam resolver à mão, esquecem-se de resolver, ou copy-pasteiam de outra ferramenta. Nenhuma é demo — todas mapeiam para endpoints que existem hoje.

Autenticação em todas: uma chave Bearer sk_… para REST, a mesma chave configurada no teu cliente MCP para as em linguagem natural. Reference completa em docs.whentomeet.io.

1. "Encontra 30 minutos com qualquer pessoa" — one-liner MCP

Com MCP ligado ao Claude ou ao ChatGPT:

"Encontra três espaços de 30 minutos no meu calendário na próxima semana, em horário comercial, pelo menos uma hora de distância das outras reuniões."

O assistente chama list_calendar_events para a próxima semana, filtra e responde. Sem script, sem cron, sem config.

2. Verificar conflitos para um bloco de foco

Um uso comum de check_conflicts: antes de te comprometeres com um bloco de 4 horas na sexta, perguntas:

"A sexta-feira seguinte das 9h às 13h colide com alguma coisa? Se sim, diz-me com o quê."

A tool MCP devolve os eventos que se sobrepõem. Escolhes outro horário ou mudas um deles. É a automação mais pequena possível — uma única chamada — e é a que vais correr mais.

3. Um cron que cria horários de atendimento automaticamente

Um script curto que corre domingo à noite:

POST /api/v1/direct-events  
Authorization: Bearer sk_…

{  
  "groupId": "…",  
  "title": "Horário de atendimento",  
  "startTime": "2026-05-05T14:00:00Z",  
  "endTime": "2026-05-05T15:00:00Z"  
}

Tens horários de atendimento previsíveis no calendário todas as semanas sem teres de te lembrar de os criar. Junta-lhe um link público de direct event e as pessoas marcam.

4. Um digest semanal das reuniões da próxima semana

Todas as sextas à tarde, um script chama GET /api/v1/calendar/events?from=…&to=…, formata o resultado em Markdown, e envia-te por email (ou empurra para a tua app de apontamentos):

  • Segunda 10h — Check-in com investidores
  • Terça 14h — 1:1 com a Anna
  • Quarta — bloqueado para escrita
  • Quinta 15h — Design review

É um script de cinco minutos que substitui um ritual semanal de vinte. E é assim que começas a notar padrões — "porque tenho quatro 1:1 às terças" — que nunca verias a clicar numa vista de semana.

5. Agenda de standup gerada por agente a partir de eventos

Todas as manhãs, a mesma sessão Claude que lê os teus issues do Linear também pode:

"Puxa os meus eventos de calendário de ontem via list_polls e list_calendar_events. Esboça um update de standup a partir de onde estive realmente."

O agente escreve um primeiro rascunho. Tu editas. É isto que "agent-addressable" significa na prática — o teu assistente já consegue ler os teus docs e código; juntar o calendário é a última peça.

6. Transmitir um calendário de lançamento a partir de um ficheiro JSON

Tens um ficheiro JSON com dez eventos de lançamento. Queres publicá-los num broadcast group em whentomeet.com/b/launch-2026.

Um script curto lê o ficheiro e faz loop:

for event in events:  
    POST /api/v1/direct-events  (groupId: …)

O feed iCal do broadcast group apanha-os automaticamente. Os subscritores veem o calendário completo de lançamento na próxima vez que a app sincronizar. Se mudas o JSON e re-executas, as edições propagam-se.

A equipa de marketing mantém o ficheiro. O calendário mantém-se sozinho.

7. Métricas de booking pages num dashboard

Se operas booking pages, queres números — quantos bookings por semana, qual page converte, qual é a taxa de no-show.

GET /api/v1/bookings dá-te os dados em bruto. Despeja-os numa folha de cálculo, numa tabela Notion ou no teu dashboard interno. Agora consegues dizer qual booking page está mesmo a merecer o lugar, sem clicares na nossa UI.

O que têm em comum

Cada uma substitui uma tarefa manual recorrente por uma automação agendada ou a pedido. Nenhuma exigiu que enviássemos algo novo — as superfícies estão lá, documentadas, com rate-limit por justiça, e estáveis.

Se construíres uma e a partilhares, nós linkamos. Se construíres uma e falhar porque falta uma tool à API, diz-nos; é o sinal que nos diz o que adicionar a seguir.

Setup, chaves e reference completa dos endpoints estão em docs.whentomeet.io.