Wrapper Python da API Klingo.
Biblioteca completa que cobre 104 endpoints da Klingo organizados em 19 módulos funcionais. Base para qualquer automação futura que precise conversar com o sistema clínico.
O que é
klingo_api.py é uma biblioteca Python que encapsula toda a API externa da Klingo (api-externa.klingo.app) em chamadas simples e tipadas. Foi construída para que qualquer integração futura — relatórios, sincronizações, automações — não precise lidar com detalhes de autenticação, headers ou formatos AQL.
Por que importa
A Klingo é o sistema-mãe da operação clínica da IRB. Toda agenda, todo paciente, todo atendimento passa por lá. Ter uma biblioteca pronta significa que:
- Qualquer dev novo já tem 100% dos endpoints documentados
- Não há mais "perguntar para o Klingo como fazer X"
- As integrações ficam consistentes (mesmo padrão de auth, retries, erro)
Módulos cobertos
| Módulo | O que cobre |
|---|---|
pacientes | Cadastro, busca, atualização |
agendas | Slots, médicos, horários |
marcacoes | Agendar, cancelar, remarcar |
atendimentos | Histórico, evolução |
medicos | Cadastro, especialidades |
especialidades | Lista, filtros |
operadoras | Convênios |
financeiro | Lançamentos |
pagamentos | Status, comprovantes |
faturamento | Geração, conferência |
suprimentos | Estoque |
laudos | Resultados |
autorizacoes | Convênios |
crm | Lead, contato |
relatorios | Exportações |
pep | Prontuário eletrônico |
configuracoes | Sistema |
usuarios | Acesso |
cadastros / tarefas | Operação |
104 endpoints validados ao longo do contrato.
Como usar
```python
from klingo_api import KlingoAPI
api = KlingoAPI(login="FELLIPE.SARAIVA", senha="...", domain="irb")
api.login()
Listar slots livres de um médico
slots = api.agendas.slots_livres(medico_id=123, data="2026-05-20")
Cadastrar paciente
api.pacientes.criar(nome="João Silva", cpf="...", celular="...")
```
Histórico de evolução
- 18/fev — primeira versão do wrapper Python (commit
feat: Klingo API Client) - 19/fev — validação e expansão dos 104 endpoints
- 26/fev — migração da API interna AQL para a API externa oficial em todo o monorepo TypeScript, usando o wrapper como referência de comportamento
Onde está
Arquivo: klingo_api.py na raiz do projeto IRB.
Esta biblioteca é independente do monorepo irb-whatsapp-ai — pode ser usada em qualquer script Python que precise integrar com a Klingo (analytics, BI, exportações, scripts ad-hoc).