O Barberly tem agora uma Booking API pública. Com ela, o seu site, a sua app, o seu bot de WhatsApp, o seu agente de voz ou o seu assistente de IA podem aceitar marcações para a sua barbearia, com os mesmos serviços, a mesma equipa, a mesma disponibilidade e as mesmas regras de marcação que os seus clientes já veem na sua app Barberly.
O que pode criar com uma API de marcações para barbearias
- WhatsApp: marcar dentro da conversa que os clientes já usam
- Assistentes de IA: marcar com base na sua disponibilidade real
- Agentes de voz: marcações por telefone, automatizadas
- Sites: o seu próprio processo de marcação, com a sua marca
- Chatbots: um passo de marcação em qualquer widget de chat
- Integrações próprias: qualquer outra coisa que crie uma marcação
Marca como os seus clientes marcam
A Booking API é mais uma ferramenta para os clientes, ao lado da sua app, do seu site, dos widgets de marcação, do quiosque e da marcação pelo Google. Não é uma API de back office. Não dá acesso a relatórios, gestão da equipa ou definições.
Tudo o que configurou para a sua página de marcações aplica-se tal como está:
- Um horário fechado aos clientes também está fechado na API. A disponibilidade mostra a vista de cliente da sua agenda, nunca a da equipa.
- Se aprova as marcações à mão, as marcações feitas pela API também chegam por confirmar.
- Se exige um cliente registado, a API também exige.
- Horários, antecedência mínima, duração dos serviços e que barbeiro faz o quê são lidos em tempo real das suas definições.
A API não inventa regras próprias e não contorna nenhuma.
O que a Booking API cobre
- Catálogo: espaços, membros da equipa, serviços com extras
- Disponibilidade: dias e horários livres, por espaço, barbeiro e serviço
- Marcações: criar, consultar, remarcar e cancelar
- Contas de clientes: registo, início de sessão e recuperação da palavra-passe
Chaves de API e permissões
Configure primeiro os seus espaços, equipa, serviços e horários no Barberly. A API lê essa configuração, não a cria. Depois crie uma chave no portal Barberly em Apps → Booking API → Create key e dê-lhe apenas as permissões de que precisa:
| Permissão | Permite |
|---|---|
catalog:read | Espaços, membros da equipa, serviços, disponibilidade |
bookings:read | Consultar uma marcação |
bookings:write | Criar, alterar e cancelar marcações |
accounts:write | Registar, iniciar sessão e recuperar contas de clientes |
Envie a chave no cabeçalho X-Api-Key. As chaves podem ser revogadas ou eliminadas no mesmo ecrã.
Experimente as demos ao vivo
Dois processos de marcação para convidados funcionam numa barbearia de demonstração pública e mostram logo dados reais. Ambos passam por espaço, barbeiro, serviços com extras, data e hora, dados do cliente e confirmação, sem iniciar sessão.
- Appointment hub: um cartão com quatro campos que o cliente preenche por qualquer ordem
- Guided wizard: cinco passos 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 tem custo adicional?
Não. A Booking API está incluída na sua subscrição Barberly. Não há custo extra.
Não sou programador. Como consigo uma integração?
Dê ao ChatGPT, ao Claude ou a outro agente de IA a ligação para a referência da API e descreva o que quer. Em poucos minutos terá uma implementação funcional como ponto de partida.
Posso ligá-la ao n8n, Make ou Zapier?
Sim. Qualquer ferramenta que envie um pedido HTTP com cabeçalho pode chamar a API: o nó HTTP Request no n8n, o módulo HTTP no Make ou um pedido personalizado no Zapier. Estas ferramentas podem criar, remarcar e cancelar marcações. Não conseguem reagir a alterações feitas no Barberly, porque a API ainda não tem webhooks.
Um agente de voz ou o ChatGPT podem marcar através dela?
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 a sua chave no cabeçalho. A API atual chega para ambos.
Os clientes recebem as confirmações habituais?
Sim. As marcações feitas pela API enviam as mesmas notificações que configurou para a sua app e o seu site.
E os depósitos e pré-pagamentos?
A Booking API não recebe pagamentos. Se precisar de um depósito ou pré-pagamento, receba-o primeiro no seu próprio processo e depois crie a marcação pela API.
Consigo ver que marcações vieram da API?
Sim. No histórico da marcação, uma marcação feita pela API aparece como criada através da Booking API, tal como outras mostram a app ou o site.
Os clientes que marcam pela API entram na minha base de clientes?
Sim. São adicionados aos seus clientes como os outros e ganham pontos de fidelização quando a marcação é dada como concluída.
Existe um modo de teste?
Não. Durante o desenvolvimento, cancele as marcações de teste que criar.
O meu sistema fica a saber se uma marcação mudar no Barberly?
Não automaticamente: ainda não há webhooks. Para verificar uma marcação, consulte-a de novo pelo seu ID.
Tenho vários espaços. Preciso de uma chave para cada um?
Não. Uma chave funciona para todos os seus espaços. Tal como na sua app e no seu site, o cliente escolhe o espaço ao marcar.
A Booking API trata clientes sem marcação ou a lista de espera?
Não. Serve para marcações: criar, consultar, remarcar e cancelar. A fila de clientes sem marcação e a lista de espera funcionam com o quiosque e a app Barberly Business.
