Postagens

Por que eu uso Idempotency-Key em qualquer API pública

Sempre que uma integração acontece pela internet, existe uma possibilidade de timeout. Quando isso acontece, o cliente normalmente faz retry. Sem idempotência, isso pode criar dois pedidos, dois pagamentos ou duas mensagens. Por isso toda API pública que desenvolvo aceita uma Idempotency-Key . Se a mesma operação chegar novamente, a resposta é a mesma da primeira execução. Isso torna a integração previsível e evita efeitos colaterais. Pode parecer um detalhe, mas é justamente esse tipo de detalhe que separa uma API de demonstração de uma API pronta para produção.

Enviar mensagens pelo WhatsApp é fácil. Difícil é construir uma integração confiável.

Todo mundo consegue enviar uma mensagem usando uma API de WhatsApp. O problema começa quando isso vai para produção. Imagine um sistema de agenda que agenda milhares de consultas por dia. Agora responda: Como evitar mensagens duplicadas? Como saber se o paciente respondeu? Como atualizar o ERP automaticamente? Como lidar com falhas no callback? É aí que uma simples integração vira uma infraestrutura. No Confirma, o envio da mensagem é apenas uma etapa. Todo o fluxo gira em torno de confiabilidade. O sistema envia um agendamento. O Confirma agenda o envio, interpreta a resposta do paciente e devolve o resultado para o sistema de origem. Tudo isso para que quem está integrando precise se preocupar apenas com duas coisas: enviar um agendamento; receber um callback. Quanto menos responsabilidade do integrador, melhor é a experiência da API. Gostou desse tipo de conteúdo? Estamos documentando toda a arquitetura do Confirma enquanto construímos o produto.