•Ednan Ferreira
Voltar ao Portfólio
Automação · Clínicas e Consultórios

Bot de WhatsApp para clínicas — atendimento 24h sem você estar online

Toda semana clínicas perdem pacientes porque a mensagem no WhatsApp demorou demais para ser respondida. Este sistema responde instantaneamente, confirma consultas e faz a triagem inicial — enquanto você atende quem já está na cadeira.

Desenvolvido para funcionar no seu número atual, sem aplicativo novo, sem celular extra e sem precisar que alguém fique monitorando a tela.

Python
FastAPI
Redis
PostgreSQL
Docker
< 500ms
Tempo de resposta
O paciente recebe resposta em menos de 1 segundo
40%
Menos trabalho manual
A equipe responde menos mensagens repetitivas
99.5%
Disponibilidade
Funcionando 24h, fins de semana e feriados
5k+
Escala
Funciona para clínicas de qualquer tamanho

Como funciona na prática

Do primeiro contato do paciente até o atendimento — tudo automático.

1

Paciente manda mensagem

Pode ser qualquer horário — madrugada, fim de semana, feriado. O sistema está sempre online no seu número de WhatsApp atual.

2

Bot responde na hora

Saudação personalizada com o nome da clínica, menu de opções e respostas automáticas para as dúvidas mais comuns — tudo configurado do jeito que você preferir.

3

Triagem automática

O bot coleta nome, motivo do contato e horário de preferência. Sem intervenção da equipe, sem mensagem se perdendo.

4

Chega só o que importa para você

Apenas os casos que realmente precisam de atenção humana chegam até a equipe — com todo o contexto da conversa já registrado.

Detalhes técnicos — para quem quiser saber mais

Soluções de engenharia para problemas complexos de concorrência e estado.

Concorrência & Race Conditions

Redis Locks
O DESAFIO

Usuário envia 'Oi' e 'Tudo bem?' em < 100ms. Processamento paralelo causaria respostas duplicadas e estado inconsistente.

A SOLUÇÃO

Implementação de Distributed Locks no Redis (bot:lock:phone). A segunda mensagem aguarda na fila até a primeira liberar o estado, garantindo consistência ACID na sessão.

Rate Limiting Atômico

Lua Scripts
O DESAFIO

Proteger a API contra bursts e DDoS sem adicionar latência significativa de rede.

A SOLUÇÃO

Middleware customizado executando Scripts Lua diretamente no Redis. Operações de verificação e incremento são atômicas (0.5ms overhead), eliminando race conditions na contagem.

State Machine Pattern

Design Patterns
O DESAFIO

Gerenciar fluxos conversacionais complexos com 15+ estados, validações e retornos.

A SOLUÇÃO

Arquitetura baseada em Máquina de Estados Finitos. Cada estado é isolado, testável e possui transições determinísticas baseadas em regras de validação (Regex/Lógica).

Resiliência & Circuit Breaker

Fault Tolerance
O DESAFIO

Falhas na API do WhatsApp ou Chatwoot não podem derrubar todo o sistema.

A SOLUÇÃO

Padrão Circuit Breaker implementado nas integrações externas. Filas de Dead Letter para mensagens falhas e retries exponenciais para instabilidade de rede.

Tecnologias utilizadas

Backend

  • FastAPI (Async)
  • SQLAlchemy 2.0
  • Pydantic v2
  • Structlog (JSON Logs)

Frontend

  • React 18
  • Ant Design
  • Vite
  • Axios + Interceptors

Infra & DevOps

  • Docker Compose
  • NGINX (Reverse Proxy)
  • Redis (Cache/Lock)
  • PostgreSQL

Quer um sistema assim para sua clínica?

Me conta como funciona seu atendimento hoje. Em 15 minutos consigo te mostrar o que dá para automatizar.

Falar com Ednan no WhatsApp
Voltar ao Portfólio