Aba 'API e Webhooks' no ByDoctor com a lista de chaves de API e os webhooks cadastrados

## 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. Log de entregas de um webhook, com evento, status 'Entregue', código HTTP, tentativas e horário

Log de entregas de um webhook, com evento, status 'Entregue', código HTTP, tentativas e horário

## 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. Página inicial da documentação da API do ByDoctor, com busca, assistente e atalhos para primeiros passos, autenticação, agendamentos e webhooks

Página inicial da documentação da API do ByDoctor, com busca, assistente e atalhos para primeiros passos, autenticação, agendamentos e webhooks

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. Referência do endpoint de listagem de agendamentos, com exemplo em cURL e resposta em JSON

Referência do endpoint de listagem de agendamentos, com exemplo em cURL e resposta em JSON

Quer os detalhes técnicos antes de começar? Veja a [página para desenvolvedores](/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](/blog/atualizacao-sincronizacao-google-agenda) e como abrir horários para os pacientes com o [perfil público e agendamento online](/blog/atualizacao-perfil-publico-agendamento-online).