O Barberly agora tem uma Booking API pública. Com ela, seu site, seu app, seu bot de WhatsApp, seu agente de voz ou seu assistente de IA podem receber agendamentos para a sua barbearia, com os mesmos serviços, equipe, disponibilidade e regras de agendamento que seus clientes já veem no seu app Barberly.
O que você pode criar com uma API de agendamento para barbearias
- WhatsApp: agendar dentro da conversa que os clientes já usam
- Assistentes de IA: agendar com base na sua disponibilidade real
- Agentes de voz: agendamentos por telefone, automatizados
- Sites: seu próprio fluxo de agendamento, com a sua marca
- Chatbots: uma etapa de agendamento em qualquer widget de chat
- Integrações próprias: qualquer outra coisa que crie um agendamento
Ela agenda do jeito que seus clientes agendam
A Booking API é mais uma ferramenta para os clientes, junto com seu app, seu site, os widgets de agendamento, o quiosque e o agendamento pelo Google. Não é uma API de back office. Ela não dá acesso a relatórios, gestão da equipe nem configurações.
Tudo o que você configurou para a sua página de agendamento vale do mesmo jeito:
- Um horário fechado para os clientes também está fechado na API. A disponibilidade mostra a visão do cliente da sua agenda, nunca a da equipe.
- Se você aprova os horários manualmente, os agendamentos feitos pela API também chegam sem confirmação.
- Se você exige cliente cadastrado, a API também exige.
- Horários de trabalho, antecedência mínima, duração dos serviços e qual barbeiro faz o quê são lidos em tempo real das suas configurações.
A API não inventa regras próprias e não consegue burlar nenhuma.
O que a Booking API cobre
- Catálogo: unidades, membros da equipe, serviços com adicionais
- Disponibilidade: dias e horários livres, por unidade, barbeiro e serviço
- Agendamentos: criar, consultar, remarcar e cancelar
- Contas de clientes: cadastro, login e redefinição de senha
Chaves de API e permissões
Primeiro configure suas unidades, equipe, serviços e horários no Barberly. A API lê essa configuração, ela não cria. Depois crie uma chave no portal Barberly em Apps → Booking API → Create key e dê a ela só as permissões necessárias:
| Permissão | Permite |
|---|---|
catalog:read | Unidades, membros da equipe, serviços, disponibilidade |
bookings:read | Consultar um agendamento |
bookings:write | Criar, alterar e cancelar agendamentos |
accounts:write | Cadastrar, fazer login e recuperar contas de clientes |
Envie a chave no cabeçalho X-Api-Key. As chaves podem ser revogadas ou excluídas na mesma tela.
Teste as demos ao vivo
Dois fluxos de agendamento para convidados rodam em uma barbearia de demonstração pública e mostram dados reais na hora. Os dois passam por unidade, barbeiro, serviços com adicionais, data e horário, dados do cliente e confirmação, sem login.
- Appointment hub: um card com quatro campos que o cliente preenche em qualquer ordem
- Guided wizard: cinco etapas com barra de progresso
O código-fonte está no GitHub: exemplos em React para ler, copiar ou levar para o seu projeto.
Documentação
- Referência da API: cada endpoint e cada campo
- Documento OpenAPI: gere um cliente na sua linguagem
Perguntas frequentes
A Booking API custa a mais?
Não. A Booking API está incluída na sua assinatura Barberly. Não tem custo extra.
Não sou desenvolvedor. Como consigo uma integração?
Passe para o ChatGPT, o Claude ou outro agente de IA o link da referência da API e descreva o que você quer. Em poucos minutos você tem uma implementação funcionando para começar.
Posso conectar com n8n, Make ou Zapier?
Sim. Qualquer ferramenta que envie uma requisição HTTP com cabeçalho consegue chamar a API: o nó HTTP Request no n8n, o módulo HTTP no Make ou uma requisição personalizada no Zapier. Essas ferramentas podem criar, remarcar e cancelar agendamentos. Elas não conseguem reagir a mudanças feitas dentro do Barberly, porque a API ainda não tem webhooks.
Um agente de voz ou o ChatGPT consegue agendar por ela?
Sim. Plataformas de voz como Vapi ou Retell chamam APIs externas como ferramentas, e um GPT personalizado no ChatGPT pode importar o documento OpenAPI e enviar sua chave no cabeçalho. A API atual já basta para os dois.
Os clientes recebem as confirmações de sempre?
Sim. Os agendamentos feitos pela API enviam as mesmas notificações que você configurou para o seu app e o seu site.
E os depósitos e pré-pagamentos?
A Booking API não recebe pagamentos. Se você precisa de um depósito ou pré-pagamento, receba primeiro no seu próprio fluxo e depois crie o agendamento pela API.
Consigo ver quais agendamentos vieram da API?
Sim. No histórico do agendamento, um agendamento feito pela API aparece como criado pela Booking API, do mesmo jeito que os outros mostram o app ou o site.
Os clientes que agendam pela API entram na minha base de clientes?
Sim. Eles entram nos seus clientes como qualquer outro e ganham pontos de fidelidade quando o agendamento é marcado como concluído.
Existe modo de teste?
Não. Enquanto desenvolve, cancele os agendamentos de teste que você criar.
Meu sistema fica sabendo se um agendamento mudar no Barberly?
Não automaticamente: ainda não há webhooks. Para conferir um agendamento, consulte de novo pelo ID dele.
Tenho várias unidades. Preciso de uma chave para cada uma?
Não. Uma chave funciona para todas as suas unidades. Como no seu app e no seu site, o cliente escolhe a unidade ao agendar.
A Booking API cuida de clientes sem horário ou da lista de espera?
Não. Ela serve para agendamentos: criar, consultar, remarcar e cancelar. A fila de clientes sem horário e a lista de espera funcionam com o quiosque e o app Barberly Business.
