Pro API e webhooks
A Pro API permite que o seu próprio site, aplicação ou ferramentas leiam e criem marcações, clientes e muito mais. Os webhooks enviam eventos para os seus sistemas no momento em que acontecem. Ambos estão disponíveis se o seu plano incluir acesso à API.
Criar uma chave de API#
- Abra Incorporar e API na barra lateral e desloque-se até Acesso à API.
- Em Chaves de API, adicione um rótulo opcional (por exemplo "site") e escolha Criar chave.
- Copie a chave imediatamente: só é mostrada uma vez.
Envie a chave no cabeçalho Authorization de cada pedido. A mesma secção mostra o URL base, os endpoints e exemplos de respostas. Referência completa da API abre a documentação pública para programadores em lorenly.com/developers.
Cada chave mostra quando foi usada pela última vez. Revogue uma chave que já não precisa; tudo o que a usa deixa de funcionar imediatamente. Trate as chaves como palavras-passe.
As marcações criadas através da API seguem as mesmas regras da marcação online, como o horário de funcionamento e a disponibilidade da equipa.
Adicionar um webhook#
- Aceda a Definições → Webhooks, abra Como funciona se for novo nos webhooks, e depois Adicionar um endpoint.
- Introduza o URL do seu endpoint. Tem de começar por https://.
- Marque os eventos que quer, por exemplo Nova marcação criada, Marcação reagendada ou alterada, Marcação cancelada, Novo cliente, Nova avaliação, Pacote comprado, Fatura pagar ou Venda concluída.
- Escolha Adicionar webhook e guarde o seu Segredo de assinatura. Use-o para verificar que cada envio vem realmente do Lorenly.
Testar e monitorizar#
- Enviar teste entrega um evento de exemplo ao seu endpoint.
- Ver envios lista os envios recentes e o respetivo resultado, para ver falhas.
- Desative um webhook sem o eliminar, ou Elimine-o.
Incorporar sem código#
O topo de Incorporar e API também oferece widgets de marcação já feitos e um widget de avaliações para colar no seu site, consulte Partilhe ou incorpore o seu link de marcação.