Agentes de IA e os dados das suas reservas: o que uma chave deixa entrar e no que nunca toca

Deixar a IA aproximar-se da sua lista de clientes merece um olhar bem desperto. Os dados das suas reservas são o seu negócio: quem são os seus clientes e quando é que vêm. Por isso, antes de ligar seja o que for, vale a pena perceber exatamente como é que a Bookatu deixa entrar software, e onde estão as paredes. Há duas portas, e são deliberadamente diferentes.

Por dentro: o assistente por trás do seu acesso

A primeira porta é o assistente integrado no painel da Bookatu. Vive por trás do seu acesso, trabalha em linguagem simples, e segue uma regra em todo o lado: ele propõe, você confirma. Peça-lhe para marcar um cliente ou mudar uma marcação e ele mostra-lhe exatamente o que vai fazer antes de acontecer o que quer que seja. Confirma e avança, e quase todas as alterações podem ser desfeitas com um toque a seguir. É para si e para a sua equipa, não para o público, e é a ferramenta certa para gerir o seu dia, as pequenas mudanças que se vão acumulando ao longo de um turno.

Por fora: a chave é o contrato

A segunda porta é para software que vive fora do painel: uma ferramenta que já usa, uma integração feita à medida, um assistente MCP como o Claude Desktop. Entra tudo pela API, e a unidade de confiança aí é a chave de API. Há algumas propriedades que fazem quase todo o trabalho:

• É emitida por si. As chaves são criadas no seu painel, por si, e mostradas exatamente uma vez. A Bookatu guarda apenas uma impressão digital, nunca a chave em si.
• Tem uma força. Uma chave só de leitura pode olhar mas não tocar. Criar uma reserva exige uma chave de leitura e escrita. Dê a cada ligação o mínimo de que precisa.
• Deixa rasto. A Bookatu regista quando cada chave foi usada pela última vez, para que possa ver o que está de facto a ligar-se.
• Morre à ordem. Revogue uma chave e ela deixa imediatamente de autenticar. Também pode definir uma validade quando a cria.

Limitada ao seu negócio, sempre

Cada chave pertence exatamente a um negócio. Peça o agente o que pedir, o pedido é resolvido contra o seu negócio e mais nada. Uma chave emitida para um negócio nunca pode ler os dados de outro, e não há nenhum pedido que um agente de fora possa fazer que atravesse essa linha. Até as notificações webhook que a Bookatu pode enviar às suas outras ferramentas são deliberadamente magras: não levam contactos de clientes, e o software que quiser o registo completo tem de voltar pela API com a sua chave.

O que um agente com chave pode e não pode fazer

Com uma chave só de leitura, um agente consegue ler os seus serviços e preços, a sua disponibilidade em direto, a sua lista de clientes e as suas próximas marcações. Chega para um painel de relatórios ou para um assistente que responda a qual é o aspeto da minha semana.

Com uma chave de leitura e escrita, também pode agir: criar uma reserva, ou cancelar uma pela API. As reservas que cria seguem as mesmas regras da sua página de marcações: disponibilidade real, o seu aviso mínimo e a sua política de sinais. Um serviço com sinal reservado por um agente volta como pendente com um link de pagamento para o cliente, e não confirmado sem pagar.

E eis a lista que mais conta, as coisas que nenhuma chave desbloqueia porque não existem sequer como capacidades disponíveis para agentes: apagar os seus clientes ou o seu histórico, mudar o seu plano ou a faturação, gerir acessos ou permissões de pessoal, e chegar a qualquer outro negócio da plataforma. Não há nenhuma superchave que possa vazar. Essas capacidades simplesmente não estão na ementa.

Dê a uma ferramenta de relatórios uma chave só de leitura e ela pode olhar o dia todo sem poder mudar uma vírgula.

Que porta para que trabalho

Use o assistente de dentro quando é você a conduzir: mudar o das três enquanto tem as mãos ocupadas, ou bloquear a tarde de sexta. Ele propõe, você confirma, e pode desfazer. Use uma chave quando é o software a conduzir: o seu próprio painel a puxar marcações, ou um assistente MCP no seu portátil a marcar clientes. Comece cada ligação nova com uma chave só de leitura, e passe-a a leitura e escrita apenas quando a ferramenta precisar mesmo de reservar.

O objetivo disto tudo não é paranoia. É que dizer sim a IA útil é muito mais fácil quando o pior cenário é pequeno e as saídas estão bem sinalizadas. Ligue um agente, veja o que ele faz, e se algum dia deixar de confiar nele, revogue a chave e ele desaparece. O detalhe técnico completo, com endpoints, âmbitos das chaves e exemplos, está na página de programadores da Bookatu, e as chaves são emitidas a partir do seu painel de administração. Os seus dados continuam a ser seus. Um agente recebe apenas uma chave, e só para as divisões que você escolheu.