Comece por uma situação conhecida
Imagine que você comprou algo pela internet e está esperando a encomenda chegar. Existem duas formas de saber se ela já foi entregue.
Na primeira, você desce até a portaria de hora em hora e pergunta: “chegou alguma coisa para mim?”. Na maioria das vezes, a resposta é não. Você perde tempo, o porteiro perde tempo e, se a encomenda chegar logo depois da sua visita, você só vai descobrir na próxima rodada.
Na segunda, o porteiro liga para você assim que a encomenda chega. Ninguém precisa ficar perguntando. O aviso vem na hora certa.
O webhook funciona exatamente como a segunda opção. É um aviso automático que um sistema envia para outro no momento em que alguma coisa acontece.
O que é um webhook
Webhook é um mecanismo que permite a um sistema avisar outro, automaticamente, quando um evento importante acontece. O nome vem da junção de web (internet) com hook (gancho): um sistema “se pendura” em um acontecimento e é notificado sempre que ele ocorre.
Todo webhook tem três ingredientes:
O evento: o que aconteceu. Por exemplo, uma consulta foi agendada, um pagamento foi confirmado ou um paciente foi cadastrado;
O destino: para onde o aviso deve ser enviado. É um endereço na internet (uma URL) que pertence ao sistema que vai receber a informação;
Os dados: o conteúdo do aviso. Ele traz as informações essenciais sobre o que aconteceu, como o nome do paciente, o horário e o profissional.
Webhook ou consulta por API: qual é a diferença?
Quando um sistema precisa saber se algo mudou em outro, existem dois caminhos. No primeiro, ele pergunta repetidamente (isso é chamado de polling, ou consulta periódica). No segundo, ele espera ser avisado, que é o webhook.
| Consulta periódica (polling) | Webhook |
Quem toma a iniciativa | Quem precisa da informação | Quem gera a informação |
Quando a informação chega | Só na próxima consulta | No momento em que o evento acontece |
Uso de recursos | Alto, porque muitas perguntas ficam sem novidade | Baixo, porque só há envio quando algo acontece |
Analogia | Ir à portaria de hora em hora | O porteiro avisando que chegou |
💡Vale uma observação: webhook e API não competem. A API serve para pedir ou enviar informações sob demanda. O webhook serve para ser avisado de novidades. Muitas integrações usam os dois juntos: o webhook avisa que algo aconteceu e a API é usada para buscar os detalhes.
Como um webhook funciona, passo a passo
Cadastro do destino. O sistema que vai receber os avisos informa ao sistema de origem qual é o endereço (URL) onde quer ser notificado;
Algo acontece. Um paciente confirma a consulta, um pagamento é aprovado, um exame fica pronto;
O aviso é enviado. O sistema de origem monta uma mensagem com os dados do evento e a envia automaticamente para a URL cadastrada;
O destino recebe e age. O sistema que recebeu lê a mensagem e executa uma ação, como enviar um WhatsApp, atualizar uma planilha ou registrar uma baixa financeira;
A confirmação de recebimento. O destino responde dizendo que recebeu o aviso. Se não houver resposta, muitos sistemas tentam enviar de novo mais tarde.
Como é uma mensagem de webhook
Por trás da cena, o aviso é um pacote de informações organizado. De forma simplificada, e apenas para ilustrar, ele pode ter esta aparência:
evento: consulta.confirmada data_do_evento: 12/11/2026 às 14h32 paciente: Maria Souza profissional: Dr. Carlos Lima horário_da_consulta: 18/11/2026 às 09h00 unidade: Unidade Centro
Na prática, esse conteúdo costuma ser enviado em um formato padronizado (muitas vezes JSON) para que qualquer sistema consiga ler. Para quem não é da área técnica, basta saber que é uma ficha com as informações do que aconteceu.
Exemplos de aplicação em uma clínica
A rotina de uma clínica está cheia de momentos em que um sistema precisa saber, na hora, que algo aconteceu em outro. Veja alguns cenários ilustrativos de como webhooks poderiam ajudar.
1. Confirmação de consulta e lembretes
O paciente confirma a presença pelo link recebido. No mesmo instante, um aviso é enviado a uma ferramenta de mensagens, que responde ao paciente agradecendo e reforçando endereço e horário. A recepção não precisa digitar nada;
2. Cancelamento e preenchimento da agenda
Um paciente cancela a consulta em cima da hora. O aviso de cancelamento dispara uma automação que oferece o horário liberado para quem está na lista de espera. O horário deixa de ficar vazio e a clínica reduz perdas;
3. Pagamento confirmado e baixa financeira
Um paciente paga pelo Pix ou pelo cartão. A plataforma de pagamento avisa o sistema da clínica, que registra a baixa automaticamente. O financeiro deixa de conferir comprovante por comprovante;
4. Resultado de exame disponível
Quando o laboratório libera um resultado, um aviso chega ao sistema da clínica, que pode notificar o paciente de que o documento já está disponível. O paciente é informado mais rápido e a recepção recebe menos ligações perguntando “já saiu?”;
5. Novo paciente cadastrado
Um novo cadastro gera um aviso que alimenta a ferramenta de relacionamento da clínica. O paciente passa a receber mensagens de boas-vindas e orientações de primeira consulta sem trabalho manual;
6. Atendimento finalizado e pesquisa de satisfação
Ao fim do atendimento, um aviso aciona o envio de uma pesquisa curta de satisfação. A clínica coleta opiniões no momento em que a experiência ainda está fresca.
✅Importante: os exemplos acima servem para mostrar o que é possível com essa tecnologia. Os eventos que cada sistema realmente oferece variam, então vale ver a documentação ou o suporte para saber quais estão disponíveis.
Quais são as vantagens
Rapidez: a informação chega no instante em que o evento acontece;
Menos trabalho manual: tarefas repetitivas, como digitar, conferir e reenviar, passam a ser automáticas;
Menos erros: quando o dado viaja de um sistema para o outro sem digitação, diminuem os erros de transcrição;
Eficiência: o sistema só trabalha quando há novidade, em vez de ficar perguntando o tempo todo;
Melhor experiência para o paciente: respostas, lembretes e avisos mais ágeis.
Cuidados importantes
Como webhooks transportam informações, e em clínicas essas informações costumam envolver dados de saúde, alguns cuidados são essenciais.
Use conexão segura (HTTPS). Isso protege os dados durante o caminho;
Valide quem está enviando. Muitos sistemas assinam o aviso com uma chave secreta. O destino confere essa assinatura para garantir que a mensagem é legítima e não foi alterada;
Envie só o necessário. Dados de saúde são considerados dados pessoais sensíveis pela LGPD. Quanto menos informação trafegar no aviso, menor o risco;
Responda rápido e processe depois. O destino deve confirmar o recebimento logo e deixar o trabalho pesado para um momento posterior;
Prepare-se para avisos repetidos. Se o envio falhar, o mesmo aviso pode chegar mais de uma vez. O sistema receptor deve evitar, por exemplo, registrar o mesmo pagamento duas vezes;
Monitore falhas. Vale acompanhar se os avisos estão sendo entregues e ter um plano para quando algo sair do ar.
💡Perguntas frequentes
Preciso saber programar para usar webhooks? A configuração costuma ser feita por uma equipe técnica ou pelo responsável pela integração. Existem também ferramentas de automação que permitem receber webhooks com poucos cliques, sem escrever código;
Webhook substitui a API? Não. Os dois se complementam. A API é usada para pedir ou enviar dados quando necessário, e o webhook para ser avisado de que algo aconteceu;
O que acontece se o meu sistema estiver fora do ar quando o aviso for enviado? Depende de cada plataforma. Muitas tentam reenviar algumas vezes, mas não é uma regra. Por isso é importante conhecer a política de reenvio de quem envia o aviso;
Webhook é seguro? Pode ser, desde que sejam adotadas boas práticas como HTTPS, assinatura dos avisos e envio apenas dos dados necessários.
Resumindo
Webhook é um aviso automático que um sistema manda para outro quando algo acontece. Em vez de ficar perguntando o tempo todo, o sistema espera ser avisado. Na rotina de uma clínica, isso significa agenda mais cheia, financeiro mais organizado e pacientes mais bem informados, com menos tarefas manuais para a equipe.
O que achou do nosso artigo? Deixe seu feedback! 💚