Integração com OpenClaw
O OpenClaw é uma plataforma de assistente de IA que pode interagir com o WhenToMeet através da nossa API. Esta integração permite que você crie eventos de agendamento, verifique disponibilidade e gerencie seu calendário usando comandos em linguagem natural.
O que é o OpenClaw?
O OpenClaw é uma plataforma que permite conectar assistentes de IA às suas ferramentas favoritas. Com a skill do WhenToMeet para OpenClaw, você pode:
- Criar eventos de agendamento em grupo
- Listar e visualizar seus eventos existentes
- Verificar disponibilidade dos participantes
- Reservar horários nas páginas de agendamento de outras pessoas
Configuração
1. Criar uma Chave de API com Escopo
Por segurança, recomendamos criar uma chave de API com permissões limitadas especificamente para o OpenClaw:
- Acesse Configurações → Chaves de API
- Clique em "Criar Chave de API"
- Digite um nome (ex: "Integração OpenClaw")
- Selecione permissões "Padrão" — isso permite criar eventos e visualizar dados sem acesso de exclusão
- Copie a chave imediatamente
2. Configurar o OpenClaw
Adicione sua chave de API à configuração do OpenClaw:
{
"skills": {
"entries": {
"whentomeet": {
"apiKey": "sk_your_api_key_here"
}
}
}
}
A chave é injetada como WHENTOMEET_API_KEY em tempo de execução.
Considerações de Segurança
Compartilhar chaves de API com serviços de terceiros envolve riscos inerentes. Ao usar a integração com OpenClaw, você reconhece que:
- Sua chave de API será armazenada e usada pelos servidores do OpenClaw
- O OpenClaw terá acesso aos seus eventos, reservas e conexões de calendário
- Você é responsável por monitorar o uso e revogar o acesso se necessário
Use por sua conta e risco.
Boas Práticas
- Use o escopo "Padrão" — Isso limita o OpenClaw a criar eventos e visualizar dados, sem a capacidade de excluir nada
- Monitore o uso — Verifique o uso da sua chave de API regularmente em Configurações → Chaves de API
- Rotacione as chaves periodicamente — Exclua chaves antigas e crie novas se suspeitar de comprometimento
- Use uma chave dedicada — Crie uma chave de API separada apenas para o OpenClaw para poder revogá-la independentemente
Escopos de Permissão
Ao criar uma chave de API, você pode escolher entre três níveis de permissão:
| Escopo | Pode Visualizar | Pode Criar | Pode Excluir | Ideal Para |
|---|---|---|---|---|
| Somente Leitura | Eventos, reservas, calendários | Não | Não | Painéis de análise |
| Padrão | Eventos, reservas, calendários | Eventos | Não | OpenClaw, assistentes de IA |
| Completo | Eventos, reservas, calendários | Eventos | Eventos | Ferramentas internas confiáveis |
Para o OpenClaw, recomendamos o escopo Padrão. Isso permite que a IA crie eventos de agendamento e visualize seus dados, mas impede a exclusão acidental ou maliciosa de eventos.
Exemplos de Uso
Uma vez configurado, você pode pedir ao OpenClaw para:
- "Criar um evento de standup da equipe para amanhã às 9h ou 10h"
- "Mostrar meus próximos eventos"
- "Quais horários estão disponíveis na página de reserva da Jane?"
O OpenClaw usará sua chave de API para interagir com o WhenToMe programaticamente.
Solução de Problemas
"O escopo da chave de API não permite acesso"
Sua chave de API não tem as permissões necessárias. Crie uma nova chave com escopo Padrão ou Completo.
"Chave de API inválida ou expirada"
- Verifique se a chave começa com
sk_ - Confirme se a chave não foi revogada em Configurações → Chaves de API
- Certifique-se de que a chave não expirou (se você definiu uma data de expiração)
Limite de Requisições
As chaves de API estão sujeitas a limites de requisições com base na sua assinatura:
- Gratuito: 32 requisições (vitalício)
- Plus: 1.000 requisições por hora