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.
| Item | Situação |
|---|---|
| Plano | Growth |
| Quem cria a chave | O dono, no painel |
| Onde | Configurações, Conta e plano, Integrações |
| Criação de chaves e escopos | Ainda não liberada |
| Documentação dos endpoints | Sai 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_tokene 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.