Novo: API pública e webhooks para conectar a sua clínica
A sua agenda deixa de ser uma ilha
Toda clínica que cresce acaba usando mais de um sistema: um BI, um CRM, uma planilha que a diretoria acompanha, um software que o contador pediu. E aí começa o trabalho invisível de alguém copiando agendamento por agendamento de um lugar para o outro.
Com a nova API pública e os webhooks, isso acaba. Os seus agendamentos podem ser lidos por qualquer outro sistema, e o ByDoctor avisa na hora — em tempo real — sempre que um agendamento é criado, alterado ou cancelado.
E tem uma garantia importante: a API é somente leitura. Quem você conectar consegue ler os agendamentos, nunca alterar nem apagar nada dentro do ByDoctor.
Crie uma chave de API em um minuto
No menu lateral, abra "Minha Clínica" e vá até a aba "API e Webhooks" — ela fica disponível para administradores.
Clique em "Nova chave", dê um nome que lembre onde ela será usada ("Integração CRM", por exemplo) e confirme o aviso de LGPD: os dados lidos por aquela chave passam a viajar para um sistema sob responsabilidade da sua clínica.
A chave aparece uma única vez. Copie na hora e guarde em lugar seguro. Se ela vazar, ou se a integração acabar, é só revogar: a chave passa a aparecer como "Revogada" e para de funcionar na mesma hora. Cada chave também mostra quando foi criada e quando foi usada pela última vez, então você sempre sabe o que ainda está em uso.
Avisos em tempo real, com log de entregas
Chave criada, o próximo passo é o webhook. Em "Novo webhook" você informa o endereço HTTPS que vai receber os eventos e escolhe quais interessam: agendamento criado, agendamento atualizado e agendamento cancelado.
Uma chave de assinatura é exibida — também uma única vez. É ela que permite ao outro sistema confirmar que a mensagem veio mesmo do ByDoctor, e não de alguém se passando por ele.
Depois disso, dois botões resolvem o dia a dia: enviar um evento de teste, para conferir a conexão sem precisar esperar um agendamento real, e o log de entregas, que mostra cada evento com status, código HTTP, número de tentativas e horário. Entregas que falham são reenviadas automaticamente — e, se quiser, você reenvia uma na mão.
Documentação pronta para entregar a uma IA
Aqui está a melhor parte para quem não tem um desenvolvedor na equipe: a documentação em docs.bydoctor.com.br foi escrita para ser lida por inteligência artificial.
Cada página tem um botão "Copy page" — copie e cole no ChatGPT ou no Claude e peça a integração que você quer. Tem também um assistente dentro da própria documentação para tirar dúvidas, uma busca completa e exemplos prontos para rodar.
Lá você encontra os primeiros passos, a autenticação, os endpoints de agendamentos, como sincronizar apenas o que mudou desde a última consulta e todos os eventos de webhook. Cada endpoint traz o exemplo de requisição, a resposta completa e um botão "Try it" para chamar a API direto da página.
Quer os detalhes técnicos antes de começar? Veja a página para desenvolvedores.
Em resumo
Crie a chave, cadastre o webhook e os seus agendamentos passam a conversar com o resto da sua operação — em tempo real, somente leitura e com um log de entregas para você conferir tudo. Se ninguém na clínica programa, entregue o link da documentação para uma IA e comece do mesmo jeito.
Falando em conectar sistemas: veja também como manter a agenda dos profissionais em dia com a sincronização com o Google Agenda e como abrir horários para os pacientes com o perfil público e agendamento online.