Pular para o conteúdo

Chaves de API

Onde ficam as chaves do painel, quem pode criar e o que a API pública não precisa.

Atualizado em 10 de outubro de 2026

API pública: sem chave

Buscar negócios, ver serviços e horários e agendar não exige chave, conta nem cadastro. Funciona em todos os planos e para qualquer aplicativo ou assistente de IA. O servidor MCP segue a mesma regra.

API de gestão

A API de gestão é para o dono do negócio integrar os dados da própria operação. Ela faz parte do plano Growth e usa uma chave criada no painel, em Configurações, Conta e plano, Integrações. Só o dono vê essa área.

ItemSituação
PlanoGrowth
Quem cria a chaveO dono, no painel
OndeConfigurações, Conta e plano, Integrações
Criação de chaves e escoposAinda não liberada
Documentação dos endpointsSai junto com a liberação

Hoje a área de Integrações traz as notas fiscais. As chaves e os escopos de acesso entram quando a API de gestão for aberta, e esta página passa a trazer o passo a passo. Se você já tem um caso de uso no plano Growth, conte para nós em [email protected].

Token da reserva

O que existe hoje é o manage_token: um segredo devolvido uma vez ao criar uma reserva. Ele vai no cabeçalho X-Booking-Token e dá acesso a uma reserva de um negócio, nada além disso.

  • Não vence por tempo e não muda ao remarcar.
  • A Agendria guarda só um resumo irreversível dele e o compara em tempo constante.
  • No MCP, o mesmo acesso se chama booking_token e leva negócio e reserva junto.
  • Não há revogação individual hoje. Se um link vazou, escreva para o suporte.

Boas práticas

  • Guarde o token como uma senha: variável de ambiente ou cofre, nunca no código nem em URL de página pública.
  • Mascare tokens, e-mails e celulares nos seus logs. Fazemos o mesmo nos nossos.
  • Envie só os dados da pessoa que está agendando, conforme a Política de Privacidade.
Chaves de API · API e MCP · Agendria