Webhook e consulta periódica
No webhook, a origem envia o evento ao endereço configurado. Na consulta periódica, o consumidor procura novidades em intervalos definidos.
Tecnologia
Webhook
O que é Webhook?
Webhook é mecanismo em que um sistema envia uma notificação HTTP a um endereço configurado quando ocorre um evento acompanhado.
Por que esse conceito importa na clínica
Webhooks permitem reagir a eventos sem consultar repetidamente a origem em busca de novidades. Para uma clínica, o ponto decisivo é saber quais eventos existem e como o processo lida com falhas: receber uma notificação não significa que a tarefa de destino já terminou.
Exemplo aplicado
Em um exemplo hipotético, um provedor envia uma notificação de pagamento a um sistema de gestão. O receptor valida a origem, identifica a cobrança e registra o evento para processamento. Se a mesma entrega chegar novamente, o fluxo precisa reconhecê-la para evitar uma segunda baixa indevida. Depois, a equipe confere se o pagamento foi conciliado.
Pontos-chave
- Assine apenas os eventos necessários para a tarefa pretendida.
- Use HTTPS e valide a autenticidade conforme o mecanismo documentado pelo provedor.
- Identifique o tipo de evento antes de decidir qual ação executar.
- Preveja entregas repetidas, falhas e recuperação conforme as regras do provedor.
Não confunda
Recebimento e conclusão
Uma resposta de recebimento pode anteceder o processamento em uma fila. A operação de negócio precisa ter resultado verificável, inclusive quando falhar.
Perguntas relacionadas
Todo webhook é reenviado automaticamente após falha?
Não presuma uma política universal. Consulte as regras do provedor para tentativas, prazos e reenvio manual, e defina como localizar e recuperar eventos não processados.
Basta conhecer a URL para aceitar um evento?
Não. Um endereço acessível pode receber requisições indevidas. Valide a autenticidade e o conteúdo antes de alterar registros; não exponha credenciais na URL.
Fontes e revisão
Conteúdo escrito por Equipe Lumave, Produto e Tecnologia. Última revisão em .
Termos relacionados
API RESTful
Interface entre sistemas orientada pelo estilo arquitetural REST, que organiza a interação com recursos por uma interface uniforme
WhatsApp Business API
Interface da WhatsApp Business Platform que permite integrar mensagens empresariais a sistemas, conforme as regras e a disponibilidade da plataforma
Gerencie sua clínica de estética com o Lumave
Prontuário, agenda e financeiro em uma plataforma
Teste grátis 14 dias